---
title: "A nyilvános REST API | Posty dokumentáció"
description: "Alapcím, első hívás, a kérés és a válasz alakja, és hol van a gépi leírás."
canonical: https://posty.hu/de/dokumentation/api
source: https://posty.hu/de/dokumentation/api.md
---

Nyilvános API

# A nyilvános REST API

Alapcím, első hívás, a kérés és a válasz alakja, és hol van a gépi leírás.

## Grundlagen

Basis-URL

`https://api.posty.hu/public/v1`

Version

Im Pfad: /public/v1

Authentifizierung

API-Schlüssel als kompletter `Authorization`\-Header, oder ein OAuth-2.1-Zugriffstoken

Format

Jede Anfrage und jede Antwort ist JSON

Datum

ISO 8601, immer UTC

OpenAPI 3

[https://posty.hu/openapi.json](https://posty.hu/openapi.json)

Verfügbarkeit

Ab dem Pro-Tarif. Siehe die [Tarife](https://posty.hu/de/dokumentation/tarife)\-Seite.

## Der erste Aufruf

`/status` ist der einzige Pfad, der auch ohne Schlüssel antwortet. Damit prüfst du am schnellsten, ob du uns erreichst, und bekommst die Adressen aller anderen Dokumente:

```
curl https://api.posty.hu/public/v1/status
```

Kód másolása

Der erste authentifizierte Aufruf listet deine Kanäle:

```
curl https://api.posty.hu/public/v1/integrations \
  -H "Authorization: psty_a_kulcsod"
```

Kód másolása

Kein Bearer-Präfix vor dem API-Schlüssel

Der API-Schlüssel ist der **komplette** Wert des `Authorization`\-Headers, ohne `Bearer`. Das `Bearer`\-Präfix gehört zum OAuth-Token. Das ist der häufigste Grund, warum ein erster Aufruf eine 401 bekommt.

Den Schlüssel erstellst du selbst in Posty. Siehe die Seite [Authentifizierung](https://posty.hu/de/dokumentation/api/authentifizierung).

## Was v1 kann

Die API verwaltet denselben Arbeitsbereich wie die Weboberfläche. Nur eines kann sie nicht: einen Kanal verbinden, weil die Plattform das von einem Menschen verlangt.

[Kanäle — Auflisten, Einstellungsschemas, plattformspezifische Abfragen.](https://posty.hu/de/dokumentation/api/endpunkte/csatornak)[Beiträge — Erstellen, planen, sofort veröffentlichen, Kalender, löschen.](https://posty.hu/de/dokumentation/api/endpunkte/bejegyzes-letrehozas)[Medien — Hochladen aus einer Datei oder von einer öffentlichen URL.](https://posty.hu/de/dokumentation/api/endpunkte/media-feltoltes)[Analytik — Kanal- und Beitragsstatistiken.](https://posty.hu/de/dokumentation/api/endpunkte/csatorna-statisztika)

Die vollständige Liste findest du auf der Seite [Endpunkte](https://posty.hu/de/dokumentation/api/endpunkte), mit einer eigenen Seite für jeden Endpunkt.

## Form von Anfrage und Antwort

Jeder Body ist JSON, und jedes Datum ist ISO 8601 UTC. Fehler sind ebenfalls JSON. Ihre Form und die Aufruflimits beschreibt die Seite [Fehler und Limits](https://posty.hu/de/dokumentation/api/fehler).

Wenn ein Schlüssel zu mehreren Arbeitsbereichen gehört, wählt der `showorg`\-Header, auf welchen sich der Aufruf bezieht.

## Maschinenlesbare Beschreibung

OpenAPI 3

[https://posty.hu/openapi.json](https://posty.hu/openapi.json)

MCP-Manifest

[https://posty.hu/.well-known/mcp.json](https://posty.hu/.well-known/mcp.json)

Zusammenfassung für Agenten

[https://posty.hu/llms.txt](https://posty.hu/llms.txt)

OAuth-Metadaten

`https://api.posty.hu/.well-known/oauth-protected-resource`

Diese Seite als Markdown

[https://posty.hu/dokumentacio/api.md](https://posty.hu/dokumentacio/api.md)

Aus dem OpenAPI-Dokument kannst du auch Clientcode generieren. Die Namen aller Scopes stehen darin unter `components.securitySchemes`.

## Weiter

[Authentifizierung — Schlüssel, Scopes, Arbeitsbereich wählen.](https://posty.hu/de/dokumentation/api/authentifizierung)[Fehler und Limits — Fehlerformen, Wiederholversuche, RateLimit-Header, Versionierung.](https://posty.hu/de/dokumentation/api/fehler)[OAuth 2.1 — Wenn du die Konten anderer aus deiner eigenen App verwalten willst.](https://posty.hu/de/dokumentation/api/oauth)[Webhooks — Die umgekehrte Richtung: Wir benachrichtigen dein System.](https://posty.hu/de/dokumentation/automatisierung/webhooks)

Dokumentationsseiten

Fehlt etwas auf dieser Seite? Schreib eine E-Mail an [norbert@posty.hu](mailto:norbert@posty.hu) oder nutze auf der [Hilfeseite](https://posty.hu/de/hilfe) das Formular.