Σύμβαση απόκρισης
Διαβάστε το αντικείμενο σφάλματος
Όταν ένα αίτημα αποτυγχάνει, το JSON επιστρέφει status ως false. Χρησιμοποιήστε το αριθμητικό errno στη λογική εφαρμογής και κρατήστε το errmsg για logs ή αναγνώσιμα διαγνωστικά.
{
"status": false,
"errno": 94,
"errmsg": "invalid or missing key"
}errno, όχι στην ακριβή διατύπωση του errmsg, ώστε να παραμένει σταθερή αν αλλάξει το επεξηγηματικό κείμενο.Πλήρης αναφορά
Κωδικοί σφαλμάτων GenderAPI
Οι τιμές αντιστοιχούν στην τρέχουσα δημόσια τεκμηρίωση. Διορθώστε την αιτία πριν επαναλάβετε το αίτημα.
access deniedΤο αίτημα προήλθε από μη εξουσιοδοτημένη IP ή referrer.
invalid country codeΗ χώρα δεν είναι υποστηριζόμενος κωδικός ISO 3166-1 alpha-2.
name not set || email not set || username not setΛείπει η απαιτούμενη παράμετρος name, email ή username.
too many names || too many emails || too many usernamesΥπέρβαση ορίου batch: 100 ονόματα, 50 email ή 50 usernames.
query limit reachedΤο API key δεν έχει διαθέσιμες μονάδες.
invalid or missing keyΤο API key λείπει ή δεν βρέθηκε.
API key has expiredΤο πακέτο του API key έχει λήξει.
Οδηγίες διαχείρισης
Αποτύχετε με ασφάλεια και αποφύγετε τυφλά retries
Επικυρώστε πρώτα
Απορρίψτε ελλιπή inputs, άκυρους κωδικούς χώρας και υπερμεγέθη batches πριν φτάσουν στο API.
Προστατεύστε τα διαπιστευτήρια
Κρατήστε τα API keys στον server και αφαιρέστε τα από logs, browser output και screenshots υποστήριξης.
Επαναλάβετε επιλεκτικά
Αυτά τα σφάλματα απαιτούν διόρθωση ή ενέργεια λογαριασμού. Η αμετάβλητη επανάληψη δεν τα επιλύει.
type GenderApiError = {
status: false;
errno: number;
errmsg: string;
};
if (response.status === false) {
handleGenderApiError(response.errno, response.errmsg);
}Διατηρήστε ιδιωτικά τα διαγνωστικά στοιχεία
Καταγράψτε τον αριθμό σφάλματος με εσωτερικό request ID, ποτέ όμως το API key. Εμφανίστε σύντομο, χρήσιμο μήνυμα αντί για διαπιστευτήρια ή εσωτερικά δεδομένα.
Η τεκμηρίωση ολοκληρώθηκε