Επιλέξτε τη σύνδεση Integrately που ταιριάζει στη σύμβαση API σας
Η συνταγή HTTP αυτού του οδηγού καλεί το GenderAPI.io V2 στο https://api.genderapi.io/api/v2/gender. Στείλτε type και value στο σώμα JSON. Η πρόβλεψη βρίσκεται στο data, ενώ οι πληροφορίες του αιτήματος και της χρέωσης βρίσκονται στο meta. Οι εγγενείς σύνδεσμοι (connectors) έχουν δικές τους συμβάσεις, που περιγράφονται παρακάτω.
Η σελίδα GenderAPI.io στο Integrately παραπέμπει στο genderapi.io και προσφέρει ενέργειες για ονόματα, διευθύνσεις email και για την εξαγωγή του μικρού ονόματος από μια διεύθυνση email. Δεν αναφέρει ούτε την έκδοση του υποκείμενου API ούτε το πλήρες σχήμα της εξόδου. Τα ονόματα των ενεργειών από μόνα τους δεν αρκούν για να επιβεβαιώσουν τη συμβατότητα με το V2.
Το Integrately τεκμηριώνει το Webhook/API ως εξερχόμενη ενέργεια POST. Οι τρέχουσες επιλογές του για τις κεφαλίδες και ο επεξεργαστής JSON δεν επαληθεύτηκαν ανεξάρτητα για αυτόν τον οδηγό. Εφαρμόστε την παρακάτω σύμβαση HTTP του V2 μόνο αφού επιβεβαιώσετε ότι η ενέργειά σας μπορεί να στείλει κεφαλίδα Authorization και ένθετο σώμα JSON. Οι υπάρχουσες εγγενείς ενέργειες διατηρούν τη δική τους σύμβαση πεδίων.
Προετοιμάστε τον λογαριασμό και την εγγραφή προέλευσης
Αυτό το παράδειγμα εμπλουτίζει εγγραφές του Mailchimp με βάση το όνομα. Χρειάζεστε πρόσβαση στην εφαρμογή προέλευσης και στην εφαρμογή προορισμού, ένα κλειδί API του λογαριασμού GenderAPI.io και τις λειτουργίες της πλατφόρμας που χρησιμοποιεί η ενέργεια HTTP. Ο οδηγός δεν περιέχει λειτουργικά διαπιστευτήρια ούτε συνδεδεμένους λογαριασμούς.
Τα V1 και V2 χρησιμοποιούν το ίδιο κλειδί λογαριασμού και το ίδιο υπόλοιπο. Πριν ρυθμίσετε ένα αίτημα που χρεώνεται, επαληθεύστε το κλειδί με GET /api/v2/usage και ελέγξτε ότι στην απόκριση αυτού του endpoint το meta.access.mode έχει την τιμή api_key. Ένα κλειδί που λείπει ή δεν αναγνωρίζεται μπορεί να οδηγήσει στην κοινόχρηστη δοκιμαστική πρόσβαση IP. Μια αυτοματοποίηση σε παραγωγή δεν πρέπει να εξαρτάται από αυτήν χωρίς να το γνωρίζετε.
Κρατήστε τη ροή εργασίας απενεργοποιημένη όσο τη ρυθμίζετε. Μια δοκιμαστική πρόβλεψη καταναλώνει κανονικές πιστώσεις. Αυτοί οι οδηγοί ελέγχθηκαν με βάση τη δημόσια τεκμηρίωση και τη σύμβαση του V2. Για αυτή τη δημοσίευση δεν εκτελέστηκε από άκρη σε άκρη καμία πιστοποιημένη ροή εργασίας σε καμία πλατφόρμα.
Ρυθμίστε το αίτημα GenderAPI.io V2 στο Integrately
- Επιλέξτε ένα trigger του Mailchimp για συνδρομητές και ελέγξτε μια δοκιμαστική εγγραφή. Αποθηκεύστε το αναγνωριστικό του κοινού (Audience) και του συνδρομητή για την ενημέρωση, επιλέξτε το πραγματικό πεδίο του μικρού ονόματος και παραλείψτε τις εγγραφές χωρίς όνομα.
- Εντοπίστε το Webhook/API και την αντίστοιχη ενέργεια για αποστολή δεδομένων σε ένα URL. Ελέγξτε τη διαθέσιμη ρύθμιση πριν συνεχίσετε: η παρακάτω σύμβαση απαιτεί πιστοποιημένες κεφαλίδες και ένθετο σώμα JSON, και οι τρέχουσες επιλογές του επεξεργαστή δεν επαληθεύτηκαν εδώ ανεξάρτητα.
- Αν η ενέργεια πληροί αυτές τις απαιτήσεις, επιλέξτε POST και το παρακάτω endpoint του V2. Με τις επιλογές που είναι διαθέσιμες στον λογαριασμό σας, βεβαιωθείτε ότι το εξερχόμενο αίτημα περιέχει Authorization: Bearer YOUR_API_KEY και Content-Type: application/json.
- Δημιουργήστε ένα σώμα JSON με type = name, value = αντιστοιχισμένο μικρό όνομα και options με ai_mode = off. Ελέγξτε την προεπισκόπηση του αιτήματος για την ενέργεια που επιλέξατε: ένα επίπεδο φορτίο φόρμας δεν είναι σώμα JSON του V2, ακόμη κι αν έχει οριστεί η κεφαλίδα Content-Type.
- Για δυναμικά ονόματα χρησιμοποιήστε τις δυνατότητες αντιστοίχισης ή σειριοποίησης JSON της πλατφόρμας. Αν η ενέργεια που επιλέξατε δεν μπορεί να διατηρήσει ένθετο JSON ή πιστοποιημένες κεφαλίδες, χρησιμοποιήστε ένα βήμα με υποστήριξη HTTP αντί να γράψετε το κλειδί ή το JSON στις παραμέτρους ερωτήματος.
| Ρύθμιση HTTP | Τιμή | Σκοπός |
|---|---|---|
Method | POST | Στέλνει ένα μεμονωμένο αίτημα πρόβλεψης. |
URL | https://api.genderapi.io/api/v2/gender | Endpoint του GenderAPI.io V2 για μεμονωμένες προβλέψεις. |
Authorization | Bearer YOUR_API_KEY | Αντικαταστήστε το σύμβολο κράτησης θέσης μέσω των ρυθμίσεων ελέγχου ταυτότητας ή κεφαλίδων της πλατφόρμας. |
Content-Type | application/json | Στέλνει ένα αντικείμενο με ένθετο αντικείμενο options, όχι πεδία φόρμας. |
options.ai_mode | off | Σκόπιμη πρώτη δοκιμή μόνο με το σύνολο δεδομένων: κανονική χρέωση 1 πίστωσης, ακόμη κι αν το αποτέλεσμα είναι unknown. |
Ελέγξτε το σώμα JSON πριν από την αποστολή
Αυτό το παράδειγμα δείχνει μια σταθερή είσοδο και όχι ένα προβλεπόμενο αποτέλεσμα. Επαληθεύστε πρώτα τη δομή του αιτήματος και έπειτα αντικαταστήστε το value με το αντιστοιχισμένο πεδίο προέλευσης, με σωστή σειριοποίηση JSON. Μην στέλνετε στο API τις εκφράσεις αντιστοίχισης της πλατφόρμας ως κυριολεκτικό κείμενο.
Για άλλες εισόδους ορίστε το type σε name, email ή username και δώστε την αντίστοιχη τιμή στο value. Προσθέστε το country μόνο αν διαθέτετε αξιόπιστο πλαίσιο: το πεδίο είναι προαιρετικό και δεν χρησιμεύει για τον προσδιορισμό της χώρας διαμονής.
{
"type": "name",
"value": "Alice",
"options": {
"ai_mode": "off"
}
}Επαληθεύστε το βήμα HTTP πριν ενεργοποιήσετε τις ενημερώσεις
Δοκιμάστε μια ενέργεια με περιορισμένο τρόπο και εξετάστε το σώμα που επιστρέφεται πριν επιλέξετε πεδία στα επόμενα βήματα. Τα εγγενή βήματα GenderAPI.io και τα βήματα Webhook/API μπορεί να εμφανίζουν διαφορετικές ετικέτες πεδίων, ακόμη και για τον ίδιο πελάτη προέλευσης.
Φυλάξτε το κλειδί στις ρυθμίσεις που προβλέπονται για τη σύνδεση ή για την πιστοποίηση του αιτήματος και περιορίστε ποιοι μπορούν να βλέπουν ή να κοινοποιούν την αυτοματοποίηση. Αυτός ο δημόσιος οδηγός δεν περιέχει ούτε λειτουργικό κλειδί ούτε εξαγόμενη σύνδεση ούτε προρυθμισμένη ενημέρωση πελατών.
Χειριστείτε χωριστά τα αποτελέσματα identified, unknown και τα σφάλματα
Αναλύστε το σώμα της απόκρισης πριν επιλέξετε μια ενημέρωση στο σύστημα προορισμού. Οι διαδρομές JSON παρακάτω αφορούν το σώμα της απόκρισης του V2. Η πλατφόρμα σας μπορεί να το περικλείει ή να το ισοπεδώνει. Επαληθεύστε τη δομή που πραγματικά επιστρέφεται με μια περιορισμένη δοκιμή και αποθηκεύστε το αποτέλεσμα μαζί με το αναγνωριστικό της εγγραφής προέλευσης.
Μια πρόβλεψη δεν καθορίζει ούτε την ταυτότητα ενός ατόμου ούτε το φύλο που δηλώνει το ίδιο το άτομο. Αποθηκεύστε τη χωριστά από τα δεδομένα που έδωσε το ίδιο το άτομο. Ορίστε κριτήρια αποδοχής με βάση δεδομένα αντιπροσωπευτικά της δικής σας χρήσης και αξιολογήστε χωριστά τον βαθμό βεβαιότητας του συνόλου δεδομένων και τον βαθμό βεβαιότητας του AI.
| Έλεγχος | Αναμενόμενη τιμή ή τύπος | Απόφαση στη ροή εργασίας |
|---|---|---|
meta.access.mode | api_key για αυτή τη ροή εργασίας με λογαριασμό | Διακόψτε τη ροή εργασίας αν η τιμή είναι ip_trial και διορθώστε το κλειδί. Μια επιτυχής απόκριση της δοκιμαστικής πρόσβασης IP δεν αποδεικνύει ότι ο λογαριασμός πιστοποιήθηκε και μπορεί να έχει ήδη καταναλώσει δοκιμαστικές πιστώσεις. |
meta.usage.billing_status | confirmed ή unconfirmed | Αν η τιμή είναι unconfirmed, αποθηκεύστε το αναγνωριστικό του αιτήματος και διευκρινίστε τη χρέωση πριν από νέα προσπάθεια ή πριν συνεχίσετε. |
data.result_status / data.gender | identified με male ή female, unknown με null | Αποθηκεύστε τα αποδεκτά αποτελέσματα identified σε ξεχωριστό πεδίο για συναγόμενα δεδομένα. Διατηρήστε τα αποτελέσματα unknown χωρίς να αποδίδετε προεπιλεγμένη κατηγορία. |
data.confidence / data.confidence_kind | Αριθμός από 0 έως 1 ή null. Είδος τεκμηρίων ή null | Ερμηνεύστε χωριστά τα observed_frequency και model_reported. Καμία από τις δύο τιμές δεν εγγυάται γενική ακρίβεια. |
data.source / data.sample_count | dataset, ai ή none / ακέραιος αριθμός ή null | Αποθηκεύστε την προέλευση της πρόβλεψης. Το AI δεν έχει αποθηκευμένο μέγεθος δείγματος. Ένα μέγεθος δείγματος του συνόλου δεδομένων δεν είναι μέτρο της ακρίβειας του προϊόντος. |
meta.request_id / meta.usage | Αναφορά του αιτήματος / αντικείμενο χρήσης | Αποθηκεύστε και τα δύο μαζί με την εγγραφή της ροής εργασίας και το αποτέλεσμα. Μην γράφετε κλειδιά API ή περιττά προσωπικά δεδομένα στα συνήθη αρχεία καταγραφής. |
Σφάλμα HTTP / καμία απόκριση | Problem Details ή καμία πλήρης απόκριση | Διακόψτε την ενημέρωση και ελέγξτε το σφάλμα και την κατάσταση της χρέωσης. Μια λήξη χρονικού ορίου δεν αποδεικνύει ότι ο διακομιστής δεν επεξεργάστηκε τίποτα. |
Ενημερώστε μόνο την αντίστοιχη εγγραφή στο Mailchimp
Χρησιμοποιήστε τα αποθηκευμένα αναγνωριστικά του κοινού (Audience) και του συνδρομητή του Mailchimp για να επιλέξετε την εγγραφή προορισμού. Προσθέστε συνθήκες για την κατάσταση του αποτελέσματος και για τους ελέγχους πρόσβασης και χρέωσης που περιγράφονται παραπάνω πριν γράψετε τα δεδομένα σε ξεχωριστό πεδίο για συναγόμενα δεδομένα ή σε εγκεκριμένη ετικέτα. Μην μετατρέπετε ποτέ ένα φύλο που λείπει ή την τιμή null σε προεπιλεγμένη κατηγορία της επαφής.
Δοκιμάστε τους κλάδους για αποτέλεσμα identified, για αποτέλεσμα unknown και για σφάλμα πριν ενεργοποιήσετε τις ενημερώσεις. Με εικονικές αποκρίσεις δείγματος μπορείτε να ελέγξετε τις συνθήκες διακλάδωσης χωρίς να στείλετε νέα πρόβλεψη. Η ενημέρωση στην εφαρμογή προορισμού πρέπει να εξαρτάται από τους παραπάνω ελέγχους και να μην αντικαθιστά άσχετα πεδία ή ετικέτες.
Ελέγξτε τις νέες προσπάθειες και τις επαναλαμβανόμενες χρεώσεις
Το Integrately τεκμηριώνει αυτόματες νέες προσπάθειες, συμπεριλαμβανομένων ρυθμίσεων που ισχύουν για ολόκληρη την εταιρεία. Ελέγξτε την πολιτική και το ιστορικό εργασιών πριν ενεργοποιήσετε αυτή την αυτοματοποίηση και αξιολογήστε τις επιπτώσεις στις άλλες ροές εργασίας πριν αλλάξετε μια κοινόχρηστη ρύθμιση. Κάθε επαναλαμβανόμενο αίτημα HTTP είναι ανεξάρτητο αίτημα που χρεώνεται. Αποθηκεύστε τις επιτυχείς εξόδους, ώστε να μπορείτε να διορθώσετε ένα μεταγενέστερο σφάλμα στο Mailchimp χωρίς νέο αίτημα.
Κάθε νέο αίτημα προς το GenderAPI είναι ξεχωριστή λειτουργία. Αφαιρέστε τα διπλότυπα των επαναλαμβανόμενων συμβάντων προέλευσης στη ροή εργασίας σας πριν από την αποστολή, με το αποθηκευμένο αναγνωριστικό προέλευσης και την κατάσταση επεξεργασίας. Το αναγνωριστικό της εγγραφής προέλευσης δεν είναι κλειδί που προστατεύει από επαναλήψεις στην πλευρά του διακομιστή.
Ένα επιτυχές αποτέλεσμα unknown είναι πλήρες αποτέλεσμα και χρεώνεται. Σε λήξη χρονικού ορίου ή ελλιπή απόκριση, το αποτέλεσμα και η χρέωση μπορεί να είναι άγνωστα. Αποθηκεύστε την αναφορά του αιτήματος, αν υπάρχει, και διευκρινίστε τη χρέωση πριν στείλετε ξανά το αίτημα. Τηρήστε την κεφαλίδα Retry-After όταν συνοδεύει απόκριση υπέρβασης του ορίου αιτημάτων.
Πότε να χρησιμοποιείται AI
Το forceToGenderize είναι προαιρετικό για ονόματα, διευθύνσεις email και ονόματα χρήστη. Όταν είναι ενεργό, παραλείψτε το ai_mode ή χρησιμοποιήστε fallback. Τα off και always δεν συνδυάζονται με αυτή την επιλογή και επιστρέφουν 422. Ένα θετικό αρχικό υπόλοιπο αρκεί για να ξεκινήσει ένα αίτημα, ακόμη κι αν η τελική χρέωση κάνει το υπόλοιπο αρνητικό.
Η λειτουργία ψευδωνύμων μπορεί να επιστρέψει φύλο μαζί με name: null. Μπορεί επίσης να δώσει άγνωστο αποτέλεσμα. Ούτε η κανονική εφεδρική χρήση AI ούτε η ανάλυση ψευδωνύμων εγγυώνται σωστή απάντηση ή τιμή διαφορετική από null.
| Επιλογή αιτήματος | Συμπεριφορά | Πιστώσεις για επιτυχή αναζήτηση |
|---|---|---|
| options.ai_mode: off | Χρησιμοποιεί μόνο το σύνολο δεδομένων. | 1, και για άγνωστο αποτέλεσμα |
| options.ai_mode: fallback | Ελέγχει πρώτα το σύνολο δεδομένων και έπειτα χρησιμοποιεί κανονικό AI, αν δεν επιστραφεί φύλο. Είναι η προεπιλογή για τα μεμονωμένα αιτήματα. | 1 συνολικά, μαζί με την εφεδρική χρήση AI |
| options.ai_mode: always | Χρησιμοποιεί απευθείας AI. | 2 |
| forceToGenderize: true | Ελέγχει πρώτα το σύνολο δεδομένων και έπειτα αφήνει το AI να ερμηνεύσει ένα προσωπικό ψευδώνυμο ή ένα alias, ακόμη και χωρίς πραγματικό μικρό όνομα. | 1 για αποτέλεσμα από το σύνολο δεδομένων, 2 συνολικά αν χρησιμοποιηθεί AI |
Επαληθεύστε τη ροή εργασίας πριν αυξήσετε τον όγκο
- Με μια περιορισμένη δοκιμή επαληθεύστε το JSON που πραγματικά σειριοποιείται, τις διαδρομές των αναλυμένων αποτελεσμάτων, την πρόσβαση με κλειδί API και την επιβεβαίωση της χρέωσης. Αν είναι δυνατόν, δοκιμάστε με παραδείγματα αποκρίσεων τον χειρισμό των άγνωστων αποτελεσμάτων και των σφαλμάτων.
- Διευκρινίστε ποια βήματα της ροής εργασίας επαναλαμβάνονται και ποια πεδία του πελάτη αλλάζουν. Αποθηκεύστε το αναγνωριστικό της εγγραφής προέλευσης, την απόκριση που λάβατε και την αναφορά του αιτήματος, ώστε ένα μεταγενέστερο σφάλμα στο σύστημα προορισμού να μην απαιτεί νέο αίτημα.
- Ενεργοποιήστε πρώτα μια μικρή, ελεγχόμενη εκτέλεση και ελέγξτε τις εγγραφές και τις πιστώσεις της πριν αυξήσετε την παραλληλία. Οι πιστώσεις του GenderAPI και οι εργασίες ή λειτουργίες που χρεώνει η πλατφόρμα αυτοματοποίησης είναι ξεχωριστά κόστη.
- Για παρτίδες χρησιμοποιήστε το POST /api/v2/gender/batch με έως 50 στοιχεία με πρόσβαση μέσω κλειδιού API ή 10 με τη δοκιμαστική πρόσβαση IP. Ο πίνακας items μπορεί να συνδυάζει ονόματα, διευθύνσεις email και ονόματα χρήστη, με ρητές επιλογές και μοναδικό id για κάθε στοιχείο. Ελέγξτε κάθε αποτέλεσμα: μια απόκριση HTTP 200 μπορεί να περιέχει σφάλματα μεμονωμένων στοιχείων. Η υποστήριξη παρτίδων σε έναν εγγενή σύνδεσμο (connector) πρέπει να ελεγχθεί χωριστά.
Συχνές ερωτήσεις
Μπορώ να αντιστοιχίσω το πεδίο probability της παλιάς εγγενούς ενέργειας στο πεδίο confidence του V2;
Ελέγξτε πρώτα τη σύμβαση της απόκρισης. Ένα άμεσο αίτημα V2 επιστρέφει το data.confidence μαζί με το data.confidence_kind, σε κλίμακα από 0 έως 1 ή null. Τίποτα δεν στηρίζει την υπόθεση ότι οι ετικέτες και η κλίμακα των πεδίων του εγγενούς συνδέσμου αντιστοιχούν σε αυτές τις διαδρομές.
Επιτρέπει το άμεσο παράδειγμα HTTP τη χρήση AI;
Το σώμα του πρώτου αιτήματος ορίζει το options.ai_mode σε off. Αλλάξτε συνειδητά την τιμή σε fallback για την κανονική εφεδρική χρήση AI με συνολικό κόστος 1 πίστωση ή σε always για άμεση χρήση του AI με 2 πιστώσεις. Το forceToGenderize συμβουλεύεται πρώτα το σύνολο δεδομένων: κοστίζει 1 πίστωση αν το αίτημα επιλυθεί εκεί ή 2 συνολικά αν χρησιμοποιηθεί AI.
Είναι ένα άγνωστο αποτέλεσμα δωρεάν και μπορεί να επαναληφθεί αυτόματα χωρίς κίνδυνο;
Όχι. Ένα επιτυχές άγνωστο αποτέλεσμα είναι πλήρες και χρεώνεται. Μια νέα προσπάθεια είναι νέα αναζήτηση. Σε περίπτωση σφάλματος μεταφοράς ή μη επιβεβαιωμένης χρέωσης, ελέγξτε τα δεδομένα χρήσης που επιστράφηκαν και την αναφορά του αιτήματος πριν αποφασίσετε αν θα το στείλετε ξανά.
Εκτελέστηκε αυτή η ροή εργασίας με συνδεδεμένο λογαριασμό;
Όχι. Οι οδηγίες ρύθμισης των πλατφορμών ελέγχθηκαν στις 26 Σεπτεμβρίου 2026 με βάση τη δημόσια τεκμηρίωσή τους. Οι επεξηγήσεις για το αίτημα και την απόκριση του GenderAPI.io V2 ελέγχθηκαν στις 27 Σεπτεμβρίου 2026. Ο έλεγχος αυτής της ελληνικής έκδοσης στις 29 Σεπτεμβρίου 2026 είναι έλεγχος της μετάφρασης και όχι νέα δοκιμή με λογαριασμό. Πριν ενεργοποιήσετε ενημερώσεις σε παραγωγή, επαληθεύστε με τον δικό σας λογαριασμό τα τρέχοντα πεδία της ενέργειας που επιλέξατε, την πιστοποίηση, το σώμα του αιτήματος, την απόκριση και τις νέες προσπάθειες.
Τεκμηρίωση αναφοράς
Η ελληνική έκδοση ελέγχθηκε τελευταία φορά στις . Οι πληροφορίες για τις πλατφόρμες βασίζονται στη δημόσια τεκμηρίωσή τους, όπως ελέγχθηκε στις 26 Σεπτεμβρίου 2026. Αυτός ο έλεγχος δεν είναι νέα δοκιμή με συνδεδεμένο λογαριασμό. Ελέγξτε την τρέχουσα ρύθμιση και τη διαθεσιμότητα στην επίσημη τεκμηρίωση των πλατφορμών.