Σύνδεση του Pabbly Connect με το GenderAPI.io V2

Επιλέξτε τη σύνδεση Pabbly Connect που ταιριάζει στη σύμβαση API σας

Η συνταγή HTTP αυτού του οδηγού καλεί το GenderAPI.io V2 στο https://api.genderapi.io/api/v2/gender. Στείλτε type και value στο σώμα JSON. Η πρόβλεψη βρίσκεται στο data, ενώ οι πληροφορίες του αιτήματος και της χρέωσης βρίσκονται στο meta. Οι εγγενείς σύνδεσμοι (connectors) έχουν δικές τους συμβάσεις, που περιγράφονται παρακάτω.

Ο δημόσιος κατάλογος του Pabbly περιέχει μια εφαρμογή με όνομα Gender API, αλλά η καταχώριση που ελέγχθηκε δεν αναφέρει ούτε τον τομέα του παρόχου ούτε την έκδοση του endpoint ούτε το πλήρες σχήμα της απόκρισης. Το όνομα από μόνο του δεν αποδεικνύει ότι πρόκειται για το GenderAPI.io. Επαληθεύστε τον πάροχο και τα πραγματικά πεδία πριν επιλέξετε μια εγγενή ενέργεια.

Για ρητό endpoint V2, χρησιμοποιήστε τη λειτουργία προσαρμοσμένων αιτημάτων API του API by Pabbly. Αυτή η συνταγή περιγράφει αυτό το αίτημα HTTP και δεν ισχυρίζεται ότι ο εγγενής σύνδεσμος έχει μεταφερθεί στο V2.

Προετοιμάστε τον λογαριασμό και την εγγραφή προέλευσης

Αυτό το παράδειγμα εμπλουτίζει εγγραφές του Shopify με βάση το όνομα. Χρειάζεστε πρόσβαση στην εφαρμογή προέλευσης και στην εφαρμογή προορισμού, ένα κλειδί API του λογαριασμού GenderAPI.io και τις λειτουργίες της πλατφόρμας που χρησιμοποιεί η ενέργεια HTTP. Ο οδηγός δεν περιέχει λειτουργικά διαπιστευτήρια ούτε συνδεδεμένους λογαριασμούς.

Τα V1 και V2 χρησιμοποιούν το ίδιο κλειδί λογαριασμού και το ίδιο υπόλοιπο. Πριν ρυθμίσετε ένα αίτημα που χρεώνεται, επαληθεύστε το κλειδί με GET /api/v2/usage και ελέγξτε ότι στην απόκριση αυτού του endpoint το meta.access.mode έχει την τιμή api_key. Ένα κλειδί που λείπει ή δεν αναγνωρίζεται μπορεί να οδηγήσει στην κοινόχρηστη δοκιμαστική πρόσβαση IP. Μια αυτοματοποίηση σε παραγωγή δεν πρέπει να εξαρτάται από αυτήν χωρίς να το γνωρίζετε.

Κρατήστε τη ροή εργασίας απενεργοποιημένη όσο τη ρυθμίζετε. Μια δοκιμαστική πρόβλεψη καταναλώνει κανονικές πιστώσεις. Αυτοί οι οδηγοί ελέγχθηκαν με βάση τη δημόσια τεκμηρίωση και τη σύμβαση του V2. Για αυτή τη δημοσίευση δεν εκτελέστηκε από άκρη σε άκρη καμία πιστοποιημένη ροή εργασίας σε καμία πλατφόρμα.

Πιστοποίηση και δωρεάν έλεγχος χρήσης

Ρυθμίστε το αίτημα GenderAPI.io V2 στο Pabbly Connect

Επιλέξτε ένα trigger του Shopify κατάλληλο για το συμβάν πελάτη που χρειάζεστε και καταγράψτε μια αντιπροσωπευτική δοκιμαστική εγγραφή. Αποθηκεύστε το αναγνωριστικό του πελάτη και αντιστοιχίστε το διαθέσιμο πεδίο του μικρού ονόματος. Παραλείψτε ένα κενό όνομα αντί να το αντικαταστήσετε με ολόκληρη την εγγραφή του πελάτη.
Προσθέστε το API by Pabbly και επιλέξτε Custom Request. Επιλέξτε POST και το παρακάτω URL του V2. Ρυθμίστε την πιστοποίηση με Bearer token και το κλειδί του GenderAPI ή μια κεφαλίδα Authorization της οποίας η πλήρης τιμή είναι Bearer YOUR_API_KEY. Μην ρυθμίσετε και τους δύο μηχανισμούς ταυτόχρονα.
Ορίστε το Content-Type σε application/json. Το Custom Request έχει ένα πεδίο Data για το σώμα JSON. Δημιουργήστε ένα αντικείμενο με type = name, value = αντιστοιχισμένο μικρό όνομα και ένα αντικείμενο options με ai_mode = off. Η κεφαλίδα Content-Type περιγράφει το σώμα που δίνετε και δεν μετατρέπει από μόνη της τα πεδία μιας φόρμας σε αντικείμενο JSON.
Διατηρήστε το options ένθετο. Αν η ενέργεια που επιλέξατε δέχεται μόνο ακατέργαστο JSON, βεβαιωθείτε ότι τα εισαγωγικά, οι ανάστροφες κάθετοι και οι αλλαγές γραμμής στις αντιστοιχισμένες τιμές κωδικοποιούνται σωστά σε JSON. Χρησιμοποιήστε ένα υποστηριζόμενο βήμα για τη δημιουργία του 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 πριν ενεργοποιήσετε τις ενημερώσεις

Εξετάστε το σώμα της απόκρισης που καταγράφηκε και βεβαιωθείτε ότι το επόμενο βήμα διαβάζει το σώμα V2 και όχι τα πεδία κατάστασης της μεταφοράς. Το Pabbly μπορεί να διαθέτει τα κλειδιά της απόκρισης για την επόμενη αντιστοίχιση. Επαληθεύστε την πραγματική διαδρομή τους στη ροή εργασίας σας.

Κατά τη ρύθμιση εκτελέστε μόνο τη δοκιμαστική ενέργεια που επιλέξατε. Μια δοκιμή που στέλνει αίτημα μπορεί να καταναλώσει πιστώσεις του GenderAPI και εργασίες της πλατφόρμας ακόμη και πριν ενεργοποιηθεί η ροή εργασίας.

Χειριστείτε χωριστά τα αποτελέσματα 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 ή καμία πλήρης απόκριση	Διακόψτε την ενημέρωση και ελέγξτε το σφάλμα και την κατάσταση της χρέωσης. Μια λήξη χρονικού ορίου δεν αποδεικνύει ότι ο διακομιστής δεν επεξεργάστηκε τίποτα.

Ενημερώστε μόνο την αντίστοιχη εγγραφή στο Shopify

Αποθηκεύστε το αναγνωριστικό του πελάτη του Shopify που παρέχει το trigger. Κατευθύνετε τα επιβεβαιωμένα αποτελέσματα identified στο προβλεπόμενο πεδίο πελάτη ή σύμφωνα με την πολιτική ετικετών, διατηρήστε τα αποτελέσματα unknown ως unknown και μην αλλάζετε το όνομα που έδωσε ο πελάτης. Αποθηκεύστε τα source και confidence_kind για κάθε αποδεκτή πρόβλεψη.

Δοκιμάστε τους κλάδους για αποτέλεσμα identified, για αποτέλεσμα unknown και για σφάλμα πριν ενεργοποιήσετε τις ενημερώσεις. Με εικονικές αποκρίσεις δείγματος μπορείτε να ελέγξετε τις συνθήκες διακλάδωσης χωρίς να στείλετε νέα πρόβλεψη. Η ενημέρωση στην εφαρμογή προορισμού πρέπει να εξαρτάται από τους παραπάνω ελέγχους και να μην αντικαθιστά άσχετα πεδία ή ετικέτες.

Ελέγξτε τις νέες προσπάθειες και τις επαναλαμβανόμενες χρεώσεις

Το Pabbly τεκμηριώνει το Auto Re-execution και χειροκίνητες επιλογές για την επανεκτέλεση βημάτων που απέτυχαν ή παραλείφθηκαν ή ολόκληρης της ροής εργασίας. Ελέγξτε τι θα εκτελεστεί πριν χρησιμοποιήσετε κάποια από αυτές τις επιλογές. Η επανεκτέλεση ολόκληρης της ροής εργασίας μπορεί να επαναλάβει ένα αίτημα GenderAPI που έχει ήδη ολοκληρωθεί. Αν είναι δυνατόν, διορθώστε ένα μεταγενέστερο σφάλμα στο Shopify με την αποθηκευμένη απόκριση.

Κάθε νέο αίτημα προς το 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) πρέπει να ελεγχθεί χωριστά.

Συχνές ερωτήσεις

Μπορώ να χρησιμοποιήσω στο Pabbly ένα επίπεδο πεδίο φόρμας options.ai_mode;

Το σώμα V2 για το POST απαιτεί ένα αντικείμενο JSON options. Μια τελεία στην ετικέτα του πεδίου δεν αποδεικνύει από μόνη της ότι η πλατφόρμα δημιουργεί ένθετο αντικείμενο. Ελέγξτε το σειριοποιημένο σώμα πριν στείλετε το αίτημα και βεβαιωθείτε ότι αντιστοιχεί στο παράδειγμα.

Επιτρέπει το άμεσο παράδειγμα 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 είναι έλεγχος της μετάφρασης και όχι νέα δοκιμή με λογαριασμό. Πριν ενεργοποιήσετε ενημερώσεις σε παραγωγή, επαληθεύστε με τον δικό σας λογαριασμό τα τρέχοντα πεδία της ενέργειας που επιλέξατε, την πιστοποίηση, το σώμα του αιτήματος, την απόκριση και τις νέες προσπάθειες.

Τεκμηρίωση αναφοράς

Η ελληνική έκδοση ελέγχθηκε τελευταία φορά στις 29 Σεπτεμβρίου 2026. Οι πληροφορίες για τις πλατφόρμες βασίζονται στη δημόσια τεκμηρίωσή τους, όπως ελέγχθηκε στις 26 Σεπτεμβρίου 2026. Αυτός ο έλεγχος δεν είναι νέα δοκιμή με συνδεδεμένο λογαριασμό. Ελέγξτε την τρέχουσα ρύθμιση και τη διαθεσιμότητα στην επίσημη τεκμηρίωση των πλατφορμών.