API für Kommentare & Antworten

Kommentarfunktionen hängen vom Funktionsumfang der verbundenen SNS-Plattform und den aktuellen Kontoberechtigungen ab.

Kommentar-Endpunkte

Methode	Pfad	Zweck
`GET`	`/v1/brand/comments`	Kommentare auflisten
`GET`	`/v1/brand/comments/{comment_id}`	Kommentar-Details abrufen
`POST`	`/v1/brand/comments`	Einen Top-Level-Kommentar zu einem Post posten
`POST`	`/v1/brand/comment-refresh-jobs`	Eine Kommentar-Aktualisierung anfordern
`GET`	`/v1/brand/comment-refresh-jobs/{id}`	Status des Aktualisierungs-Jobs prüfen
`POST`	`/v1/brand/comments/{comment_id}/moderation-actions`	Ausblende- oder Löschaktion anfordern

Einen Top-Level-Kommentar posten:

{
  "idempotency_key": "comment-001",
  "target": { "content_id": "<content_id>" },
  "text": "Thank you for checking out our post."
}

Aktuelle action-Werte für die Moderation sind hide oder delete. Die tatsächliche Ausführung hängt von der Plattform und dem Kommentarstatus ab.

Antwort-Jobs

Methode	Pfad	Zweck
`POST`	`/v1/brand/reply-jobs`	Antwort-Job erstellen
`GET`	`/v1/brand/reply-jobs`	Antwort-Jobs auflisten
`GET`	`/v1/brand/reply-jobs/{reply_job_id}`	Status des Antwort-Jobs abrufen

{
  "comment_id": "<comment_id>",
  "idempotency_key": "reply-001",
  "text": "Thank you for reaching out."
}

Ein HTTP 202 bei der Antworterstellung bedeutet, dass der Job validiert, gespeichert und in die Warteschlange gestellt wurde. Überprüfen Sie den endgültigen Status über die reply_job_id.

Verfügbarkeits- & Wiederherstellungsstatus

Antworten können die folgenden Verfügbarkeits- und Wiederherstellungsindikatoren enthalten:

permission_required: Erforderliche Berechtigung fehlt; kann durch erneute Authentifizierung wiederhergestellt werden
permission_unverified: Berechtigungsstatus kann nicht abschließend bestimmt werden
review_disabled: Funktion ist gemäß den aktuellen App-Review-Richtlinien deaktiviert
unsupported: Plattform unterstützt diesen Vorgang nicht
reauthorize: Die SNS-Verbindung erneut authentifizieren
contact_support: Support-Kontakt erforderlich

🔗 Verwandte Dokumentation