Glossar

Wichtige Fachbegriffe und Definitionen, die in der gesamten ANKK APP und ihren APIs verwendet werden, verlinkt mit relevanten Leitfäden.

🏢 Marke (Brand)

Der primäre operative Container, der SNS-Verbindungen, Veröffentlichungsaufträge, Teammitglieder und API-Schlüssel umfasst. Jeder API-Schlüssel ist strikt an eine einzelne Marke gebunden.

Relevante Leitfäden: Eine Marke erstellen, Brand API, Team & Einstellungen

Eine authentifizierte OAuth- oder Anmeldedatenverbindung zwischen einer Marke und einem externen Social-Media-Konto. Sie wird durch eine connection_id identifiziert.

Relevante Leitfäden: SNS-Konten verbinden, Connections API, SNS-Funktionen

📝 Inhalt (Content)

Eine logische Veröffentlichungseinheit, die auf eine bestimmte SNS-Verbindung abzielt und Textkörper, Medien, Hashtags, Planungszeit und Plattformparameter enthält.

Relevante Leitfäden: Inhalte erstellen, Contents API

⚙️ Veröffentlichungsauftrag (Publish Job)

Ein asynchroner Hintergrund-Ausführungsdatensatz, der die Zustellung eines Inhaltselements an das Ziel-SNS verfolgt.

Relevante Leitfäden: Warteschlange & Veröffentlichungsstatus, Fehler & Wiederholungsversuche

📥 Erstellte Inhalte vs. Gesammelte Inhalte

Erstellte Inhalte: In der ANKK APP erstellte und geplante Posts (bei Fehlschlag wiederholbar, während der Warteschlange bearbeitbar).
Gesammelte Inhalte: Historische Beiträge, die von externen SNS-Konten synchronisiert wurden (schreibgeschützt; in ANKK nicht bearbeitbar oder wiederholbar).
Relevante Leitfäden: Veröffentlichte Inhalte

⏳ Akzeptiert (Accepted - HTTP 202)

Gibt an, dass eine Anfrage die Authentifizierung, Kontingente und Nutzlastvalidierung bestanden hat und sicher in der Warteschlange eingereiht wurde. Zu unterscheiden von der Live-Zustellbestätigung (published).

Relevante Leitfäden: Warteschlange & Veröffentlichungsstatus, Webhooks

🔑 Idempotenz-Schlüssel (Idempotency Key)

Ein eindeutiger, vom Client bereitgestellter Token, der sichere Wiederholungsversuche gewährleistet, ohne das Risiko doppelter Beiträge in externen sozialen Netzwerken einzugehen.

Relevante Leitfäden: Fehlerbehandlung, Contents API

⚠️ Neuverbindung erforderlich vs. Handlungsbedarf

Neuverbindung erforderlich: Token abgelaufen oder Berechtigungen entzogen; erfordert erneute OAuth-Authentifizierung.
Handlungsbedarf: Aktion direkt in der App der externen Plattform erforderlich (z. B. Zustimmung zu neuen Bedingungen).
Relevante Leitfäden: Fehler & Wiederholungsversuche, SNS verbinden

🔔 Webhook

Ein HMAC SHA256-signiertes Echtzeit-HTTP-POST-Ereignis, das bei Abschluss eines Auftrags an Ihren Endpunkt gesendet wird.

Relevante Leitfäden: Webhooks Referenz