Μετάβαση στο περιεχόμενο
Για προγραμματιστές

Απαντήσεις και σφάλματα

Διαβάζεται σε 2 λεπτά

Το 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.