Σφάλματα

Όταν ένα αίτημα API αποτυγχάνει, το badges.ninja επιστρέφει μια απάντηση σφάλματος JSON με κατάλληλο κωδικό κατάστασης HTTP.

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

Όλα τα σφάλματα ακολουθούν αυτή τη δομή:

{
  "error": "description of what went wrong"
}

Κωδικοί κατάστασης

Κωδικός	Σημασία	Πότε συμβαίνει
400	Bad Request	Λείπουν ή μη έγκυρες παράμετροι
402	Payment Required	Το μηνιαίο όριο απονομών επιτεύχθηκε ή η λειτουργία απαιτεί υψηλότερο πλάνο
403	Forbidden	Επιτεύχθηκε όριο πλάνου (π.χ. εκδότης ή έμβλημα)
404	Not Found	Ο αιτούμενος πόρος δεν υπάρχει
429	Too Many Requests	Ξεπεράστηκε το όριο ποσοστού
500	Internal Server Error	Συνέβη ένα μη αναμενόμενο σφάλμα στον διακομιστή

Συχνά σφάλματα και λύσεις

Λείπουν απαιτούμενες παράμετροι

{ "error": "missing required parameters: name, url, email" }

Λύση: Συμπεριλάβετε όλες τις απαιτούμενες παραμέτρους στο σώμα του αιτήματος σας. Ελέγξτε την τεκμηρίωση του endpoint για την πλήρη λίστα.

Μη έγκυρο email

{ "error": "invalid email" }

Λύση: Παρέχετε μια έγκυρη διεύθυνση email στη μορφή user@domain.com.

Μη έγκυρη URL

{ "error": "invalid URL" }

Λύση: Παρέχετε μια πλήρη URL συμπεριλαμβανομένου του πρωτοκόλλου, π.χ. https://example.com.

Όνομα πολύ σύντομο

{ "error": "name must be at least 3 characters" }

Λύση: Χρησιμοποιήστε μεγαλύτερο όνομα. Τα ονόματα εκδοτών απαιτούν τουλάχιστον 3 χαρακτήρες. Τα ονόματα παραληπτών απαιτούν τουλάχιστον 5 χαρακτήρες.

Εκδότης μη επαληθευμένος

{ "error": "issuer must be verified before creating badges" }

Λύση: Επαληθεύστε πρώτα τον εκδότη. Ελέγξτε το email του εκδότη για τον σύνδεσμο επαλήθευσης ή χρησιμοποιήστε το endpoint Verify Issuer.

Μηνιαίο όριο απονομών επιτεύχθηκε

{ "error": "monthly award quota reached" }

Λύση: Έχετε χρησιμοποιήσει όλες τις απονομές που περιλαμβάνονται στο πλάνο σας για αυτήν την περίοδο χρέωσης (Free: 100/mo, Starter: 1,000/mo, Pro: 10,000/mo). Περιμένετε τον επόμενο μηδενισμό ή αναβαθμίστε το πλάνο σας. Δείτε Πλάνα & Χρέωση.

Όριο πλάνου επιτεύχθηκε

{ "error": "issuer limit reached for your plan" }

Λύση: Έχετε φτάσει το όριο του πλάνου σας σε εκδότες, εμβλήματα ή κλειδιά API. Διαγράψτε έναν αχρησιμοποίητο πόρο ή αναβαθμίστε το πλάνο σας.

Το blockchain απαιτεί Pro

{ "error": "blockchain verification requires the Pro plan" }

Λύση: Η παράμετρος blockchain είναι διαθέσιμη μόνο στο πλάνο Pro. Αναβαθμίστε για να ενεργοποιήσετε την επαλήθευση on-chain.

Μη υποστηριζόμενο blockchain

{ "error": "unsupported blockchain, only 'matchain' is supported" }

Λύση: Επί του παρόντος μόνο το matchain υποστηρίζεται ως παράμετρος blockchain.

Ο πόρος έχει εξαρτήσεις

{ "error": "issuer has badges and cannot be deleted" }

Λύση: Διαγράψτε όλα τα εμβλήματα υπό τον εκδότη πριν διαγράψετε τον εκδότη. Ομοίως, διαγράψτε όλες τις απονομές υπό ένα έμβλημα πριν διαγράψετε το έμβλημα.

Δεν επιτρέπεται

{ "error": "not authorized" }

Λύση: Μπορείτε να τροποποιήσετε μόνο πόρους που σας ανήκουν. Βεβαιωθείτε ότι χρησιμοποιείτε το σωστό κλειδί API.

HTML στο κείμενο κοινοποίησης

{ "error": "HTML tags are not allowed" }

Λύση: Το κείμενο κοινοποίησης πρέπει να είναι απλό κείμενο. Αφαιρέστε όλες τις ετικέτες HTML από την παράμετρο text.