Authentifizierung

Die oeffentliche Postzee API verwendet API-Key-Authentifizierung. Alle Endpunkte erfordern einen gueltigen API-Key im Authorization-Header.

Basis-URL

https://api.postzee.app/public/v1

Fuegen Sie Ihren API-Key in den Authorization-Header jeder Anfrage ein:

curl -H "Authorization: YOUR_API_KEY" \
  https://api.postzee.app/public/v1/credits

Verwenden Sie nicht das Bearer-Praefix. Senden Sie den API-Key direkt als Header-Wert.

Ein kostenpflichtiger Plan (Standard oder hoeher) — der Free-Plan beinhaltet keinen API-Zugang
Ein aktives Abonnement — abgelaufene Abonnements koennen die API nicht nutzen
Das Konto darf nicht gesperrt sein

Status	Bedeutung
`401`	Fehlender oder ungueltiger API-Key
`401`	Kein aktives Abonnement
`403`	Konto gesperrt
`429`	Rate-Limit ueberschritten

Alle Fehlerantworten folgen diesem Format:

{
  "statusCode": 401,
  "message": "Unauthorized"
}

Verwenden Sie den Health-Check-Endpunkt, um zu pruefen, ob Ihr API-Key funktioniert:

curl -H "Authorization: YOUR_API_KEY" \
  https://api.postzee.app/public/v1/is-connected

Erfolgreiche Antwort:

{
  "connected": true
}

Gruppe	Endpunkte
Posts	Posts erstellen, auflisten, loeschen
Channels	Verbundene Kanaele auflisten
Media	Bilder, Videos generieren, Dateien hochladen
Credits	Guthaben pruefen, Prompts verbessern
Jobs	Asynchrone Generierungsaufgaben abfragen

Siehe Rate-Limits fuer Anfragelimits pro Endpunkt.