Direkt zum Inhalt

Konfigurieren von Webhooks

Alle über erstellten Beiträge Predis.ai API haben einen Lebenszyklus und nehmen unterschiedliche Zustände an. Die möglichen Zustände, die ein Beitrag annehmen kann, sind inProgress, completed und error. Sobald eine Anfrage zum Generieren eines Beitrags gestellt wird, wird der inProgress Der Status wird in der Antwort selbst mitgeteilt. Die verbleibenden zwei Staaten - completed und error werden über die von Ihnen konfigurierten Webhooks benachrichtigt.

Richten Sie eine Webhook-URL ein​

Führen Sie die folgenden Schritte aus, um Ihre Webhook-URL im einzurichten API Instrumententafel:

  • Einloggen um Predis.ai App
  • Navigieren Sie zu Preise & Konto -> Rest API öffnen API Dashboard
  • Fügen Sie Ihre Webhook-URL hinzu. Stellen Sie sicher, dass die Webhook-URL eine öffentliche URL ist.

Webhook-Nutzlast​

Wenn der Beitrag a erreicht hat completed or error Status wird ein Webhook mit der Nutzlast gesendet, die die folgenden Parameter enthält:

completed staatliche Nutzlast

{
    "status": "completed",
    "caption": "...",
    "post_id": "...",
    "generated_media": [{"url": "..."}],
    "brand_id": "..."
}

error staatliche Nutzlast

{
    "status": "error",
    "post_id": "..."
}
Vorsicht

Wir senden den Webhook für jeden Beitrag genau einmal, selbst wenn wir eine negative Antwort von Ihren Servern erhalten. Sollten Ihre Server das Webhook-Ereignis nicht verarbeiten können, erhalten Sie die Daten aller Ihrer generierten Beiträge. Weitere Informationen finden Sie hier.

Tests in der lokalen Umgebung​

Es ist nicht möglich, Webhook-Status direkt über localhost zu empfangen, da die Webhook-URL eine öffentliche URL sein muss. Sie können dies umgehen, indem Sie mithilfe von Tools wie ngrok einen Tunnel zu Ihrem lokalen Server erstellen . Verwenden Sie den von diesen Tools generierten URL-Endpunkt beim Einrichten Ihrer Webhook-URL im Dashboard.

Weitere Informationen​