Διαμόρφωση Webhooks
Όλες οι αναρτήσεις που δημιουργήθηκαν μέσω Predis.ai API έχουν κύκλο ζωής και παίρνουν διαφορετικές καταστάσεις. Οι πιθανές καταστάσεις που μπορεί να λάβει μια θέση είναι inProgress
, completed
και error
. Μόλις υποβληθεί ένα αίτημα για τη δημιουργία μιας ανάρτησης, το inProgress
κράτος ειδοποιείται στην ίδια την απάντηση. Οι υπόλοιπες δύο πολιτείες - completed
και error
θα ειδοποιηθεί μέσω των webhook που έχετε διαμορφώσει.
Ρυθμίστε μια διεύθυνση URL Webhook
Ακολουθήστε τα παρακάτω βήματα για να ρυθμίσετε το url του webhook σας στο API ταμπλό:
- Είσοδος στο Predis.ai app
- Μεταβείτε στην επιλογή Τιμολόγηση και λογαριασμός -> Υπόλοιπο API για να ανοίξετε το API ταμπλό
- Προσθέστε το url του webhook σας. Βεβαιωθείτε ότι η διεύθυνση URL του webhook είναι μια δημόσια διεύθυνση URL.
Webhook Payload
Εάν η ανάρτηση έχει φτάσει σε α completed
or error
κατάσταση, ένα webhook θα σταλεί με το ωφέλιμο φορτίο που περιέχει τις ακόλουθες παραμέτρους:
completed
κρατικό ωφέλιμο φορτίο
{
"status": "completed",
"caption": "...",
"post_id": "...",
"generated_media": [{"url": "..."}],
"brand_id": "..."
}
error
κρατικό ωφέλιμο φορτίο
{
"status": "error",
"post_id": "..."
}
Θα στείλουμε το webhook ακριβώς μία φορά για κάθε ανάρτηση, ακόμη και αν λάβουμε μη επιτυχή απάντηση από τους διακομιστές σας. Σε περίπτωση που οι διακομιστές σας αποτύχουν να χειριστούν το συμβάν webhook, μπορείτε να λάβετε τα δεδομένα όλων των αναρτήσεων που δημιουργήσατε. Διαβάστε περισσότερα για αυτό εδώ
Δοκιμές σε Τοπικό Περιβάλλον
Δεν είναι δυνατή η απευθείας χρήση του localhost για τη λήψη καταστάσεων webhook καθώς η διεύθυνση URL του webhook πρέπει να είναι δημόσια διεύθυνση URL. Μπορείτε να το χειριστείτε δημιουργώντας ένα τούνελ στον τοπικό σας διακομιστή χρησιμοποιώντας εργαλεία όπως π.χ ngrok. Χρησιμοποιήστε το τελικό σημείο διεύθυνσης URL που δημιουργείται από αυτά τα εργαλεία στη διεύθυνση URL του webhook ενώ ρυθμίζετε τη διεύθυνση URL του webhook στον πίνακα ελέγχου.