Πρώτα βήματα

Σφάλματα

Όταν κάτι πάει στραβά, το API απαντά με τον αντίστοιχο κωδικό κατάστασης HTTP και ένα σώμα με code και message μέσα στο error.

Χρησιμοποιήστε το code στο πρόγραμμά σας. Το message είναι κείμενο στα αγγλικά που βοηθά όποιον κάνει εντοπισμό σφαλμάτων και μπορεί να αλλάξει.

Μορφή σφάλματος404

{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}

Χωρίς κλειδί401

{
  "error": {
    "code": "missing_api_key",
    "message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
  }
}

Κωδικοί σφάλματος

Κατάσταση	Κωδικός	Πότε συμβαίνει
400	`key_in_query`	Το κλειδί στάλθηκε στη διεύθυνση URL (παράμετροι `api_key`, `apikey`, `key` ή `token`). Στείλτε το στην κεφαλίδα και δημιουργήστε νέο κλειδί, γιατί το προηγούμενο μπορεί να έχει καταγραφεί σε αρχεία καταγραφής.
400	`invalid_parameter`	Μια παράμετρος έχει μη έγκυρη τιμή, π.χ. `per_page` πάνω από το μέγιστο.
401	`missing_api_key`	Το αίτημα δεν περιείχε κλειδί.
401	`invalid_api_key`	Το κλειδί δεν υπάρχει, έχει ανακληθεί ή ο χρήστης του έχει απενεργοποιηθεί.
404	`not_found`	Το τελικό σημείο δεν υπάρχει ή το στοιχείο δεν υπάρχει ή ανήκει σε οργανισμό που ο χρήστης δεν μπορεί να δει.
404	`organization_not_found`	Το `organization` που δόθηκε δεν αντιστοιχεί σε οργανισμό όπου ο χρήστης μπορεί να δει αυτόν τον τύπο στοιχείων.
405	`method_not_allowed`	Το API δέχεται μόνο `GET` (και `HEAD`).
429	`rate_limited`	Συμπληρώθηκε το όριο αιτημάτων. Περιμένετε τα δευτερόλεπτα που ορίζει το `Retry-After`.
500	`server_error`	Εσωτερικό σφάλμα. Δοκιμάστε ξανά σε λίγο· αν συνεχίσει, επικοινωνήστε με την υποστήριξη.

Πότε να δοκιμάσετε ξανά

Επαναλάβετε το ίδιο αίτημα μόνο μετά από 429 (αφού περιμένετε το Retry-After) ή 500. Τα υπόλοιπα σφάλματα απαιτούν διόρθωση στο αίτημα ή στο κλειδί.