Για προγραμματιστές
Απαντήσεις και σφάλματα
Το POST /v1/invitations απαντά πάντα με JSON. Ο κωδικός HTTP λέει τι έγινε. Με το κλειδί δοκιμής οι απαντήσεις είναι ίδιες, με επιπλέον "test": true.
Επιτυχία
Ενότητα με τίτλο «Επιτυχία»| Κωδικός | Απάντηση | Τι σημαίνει |
|---|---|---|
202 |
{"state": "queued"} |
Η πρόσκληση μπήκε στη σειρά και θα σταλεί μετά την καθυστέρηση που έχετε ορίσει. |
200 |
{"state": "skipped", "reason": "duplicate"} |
Υπάρχει ήδη πρόσκληση για αυτόν τον αριθμό παραγγελίας. Δεν χρειάζεται να κάνετε κάτι. |
200 |
{"state": "skipped", "reason": "repeat"} |
Ο πελάτης προσκλήθηκε από εσάς τις τελευταίες 90 ημέρες. |
Το skipped δεν είναι σφάλμα. Μην ξαναδοκιμάζετε.
Αν ο πελάτης έχει ήδη γράψει κριτική για την επιχείρησή σας ή έχει ζητήσει να μη λαμβάνει προσκλήσεις, η απάντηση είναι πάλι 202, αλλά δεν στέλνεται τίποτα: το Reviewit δεν λέει σε καμία επιχείρηση ποιος έχει γράψει κριτική ή έχει διαγραφεί από τη λίστα.
Σφάλματα
Ενότητα με τίτλο «Σφάλματα»| Κωδικός | error |
Τι να κάνετε |
|---|---|---|
401 |
unauthorized |
Το κλειδί λείπει, είναι λάθος ή έχει ανακληθεί. Ελέγξτε την κεφαλίδα Authorization: Bearer … και ότι χρησιμοποιείτε το σωστό κλειδί. |
403 |
invitations_disabled |
Ο ιδιοκτήτης δεν έχει ενεργοποιήσει τις προσκλήσεις ή δεν έχει επιβεβαιώσει ότι ενημερώνει τους πελάτες. Γίνεται στη «Συλλογή κριτικών». |
403 |
plan_required |
Η επιχείρηση δεν έχει ενεργό πλάνο. |
422 |
validation_failed |
Ένα πεδίο δεν είναι έγκυρο. Το field λέει ποιο: email, firstName (έως 80 χαρακτήρες) ή orderRef (υποχρεωτικό, έως 100 χαρακτήρες). |
429 |
monthly_limit |
Συμπληρώθηκε το μηνιαίο όριο του πλάνου σας. Ξαναδοκιμάστε τον επόμενο μήνα ή ανεβάστε πλάνο. |
500 |
internal_error |
Σφάλμα από τη δική μας πλευρά. Ξαναδοκιμάστε σε λίγο. Η επανάληψη είναι ασφαλής. |
Το σώμα ενός σφάλματος είναι {"error": "<κωδικός>"}. Για το 422 έχει επιπλέον field και message.
Το πεδίο orderRef είναι υποχρεωτικό στις κλήσεις από το κατάστημα. Μόνο η φόρμα στη σελίδα «Η επιχείρησή μου» μπορεί να το παραλείψει.
Δείτε και την πλήρη αναφορά του API.