Σύνοψη πολλαπλής αίτησης
Επεξεργασία έως 50 εδραίων
Αποστολή ενόςdataπίνακα. Η GenderAPI αναπτύσσει ένα πιθανό όνομα από κάθε διεύθυνση και επιστρέφει την αντίστοιχη πρόβλεψη; η επιλογή σαςidκάνει την συγχρονισμό της βάσης δεδομένων αποφασιστική.
Απαιτούμενα HTTP headers
Επιτρέπετε τη διαδικασία συλλογής
Content-Typeapplication/jsonAuthorizationBearer YOUR_API_KEYΤο σώμα απαίτησης JSON
Παραμέτρους
| Field | Type | Requirement | Description |
|---|---|---|---|
data | object[] | Απαιτείται | Πίνακας που περιέχει από 1 έως 50 εγγραφές ελάχιστης επιστολής. |
data[].email | string | Απαιτείται | Διεύθυνση ελάχιστης επιστολής από την οποία η GenderAPI αναπτύσσει ένα πιθανό πρώτο όνομα. |
data[].country | string | Προαιρετική | Κωδικός χώρας ISO 3166-1 alpha-2 ως περιφερειακό πλαίσιο. |
data[].id | string | integer | Προαιρετική | Το περιγραφικό σας αναγνωριστικό, επιστρέφεται αναλόγως με το αποτέλεσμα. |
Χρησιμοποιήστε ένα αποκλειστικόidΓια κάθε στοιχείο. Η GenderAPI το επιστρέφει με το αποτέλεσμα του στοιχείου, επιτρέποντας σας να ενημερώσετε το σωστό αρχείο βάσης δεδομένων χωρίς να εξαρτάσεστε από τη θέση στο πίνακα.
Πληροφορίες από την αίτηση
Δημιουργήστε το πίνακα των ελεύθερων επιστολών
{
"data": [
{ "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
{ "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
{ "email": "james.brown@example.com", "country": "US", "id": "789" }
]
}Παραδείγματα κώδικα
Αποστολή αίτησης με πολλά επιστολικά δεδομένα
curl -X POST "https://api.genderapi.io/api/email/multi/country" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"data":[{"email":"andrea.schmidt@example.com","country":"DE","id":"123"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'const data = [
{ email: "andrea.schmidt@example.com", country: "DE", id: "123" },
{ email: "james.brown@example.com", country: "US", id: "789" }
];
const response = await fetch("https://api.genderapi.io/api/email/multi/country", {
method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
body: JSON.stringify({ data })
});Απάντηση 200
Εξαγωγή όνομα και προβλέψεις
{
"status": true, "used_credits": 3, "remaining_credits": 7265,
"expires": 1717069765,
"names": [
{ "name": "Andrea", "q": "andrea.schmidt@example.com", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
{ "name": "James", "q": "james.brown@example.com", "gender": "male", "country": "US", "total_names": 45274, "probability": 100, "id": "789" }
], "duration": "5ms"
}Πεδία απάντησης
| Field | Type | Description |
|---|---|---|
status | boolean | Αν το ζήτημα της πολυπλευρικής απάντησης ολοκληρώθηκε επιτυχώς. |
used_credits | integer | Οι κρεδίτα που χρησιμοποιήθηκαν σε όλα τα υποστοιχίσματα ελεύθερων ελεγχόμενων επιστολών. |
remaining_credits | integer | Τα κρεδίτα που υπάρχουν μετά την αίτηση. |
expires | integer | Η ημερομηνία λήξης του πακέτου ως UNIX timestamp. |
names | object[] | Το διατεταγμένο σύνολο αποτελεσμάτων για τα υποστοιχίσματα ελεύθερων ελεγχόμενων επιστολών. |
names[].name | string | Το ονοματεπώνυμο που αναγνωρίστηκε από τη διεύθυνση ελεύθερου ελεγχόμενου επιστολής. |
names[].q | string | Η αρχική διεύθυνση ελεύθερου ελεγχόμενου επιστολής που υποστοιχίστηκε στην αίτηση. |
names[].gender | string | null | Προβλεπόμενη τιμή: αρχικό, γυναίκα ή null. |
names[].country | string | Το κωδικό χώρας που υπολογίστηκε για αυτό το αποτέλεσμα. |
names[].total_names | integer | Η αριθμός των δειγμάτων που υποστηρίζουν αυτή την απάντηση. |
names[].probability | integer | Η επίπεδο επίσημης εμπιστοσύνης ως ποσοστό. |
names[].id | string | integer | Το αναφερόμενο στοιχείο εισόδου που επιστρέφεται για συσχέτιση του αποτελέσματος. |
duration | string | Ο συνολικός χρόνος επεξεργασίας του διακομιστή. |
Παρακαλώ διατηρήστε κάθε αίτημα μέσα σε 50 αποτελέσματα
Ελέγχετε κάθε διεύθυνση και διασπάτε μεγαλύτερα συνόλα σε πακέτα με το πολύ 50. Ελέγχετε το ανακτούμενοname and probabilityπριν εφαρμόσετε το αποτέλεσμα.
Επόμενη οδηγία