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

> Απαντήσεις για αιτήματα V2, βαθμό βεβαιότητας, άγνωστα αποτελέσματα, πιστώσεις, απόρρητο και λογαριασμό. Αν συντηρείτε μια ενσωμάτωση με την προηγούμενη έκδοση, χρησιμοποιήστε την τεκμηρίωση του V1.

Canonical HTML: https://www.genderapi.io/el/frequently-asked-questions

Last reviewed: 2026-09-29

## Γενικές πληροφορίες

Απαντήσεις για αιτήματα V2, βαθμό βεβαιότητας, άγνωστα αποτελέσματα, πιστώσεις, απόρρητο και λογαριασμό. Αν συντηρείτε μια ενσωμάτωση με την προηγούμενη έκδοση, χρησιμοποιήστε την τεκμηρίωση του V1.

## Κατανοήστε τις προβλέψεις και τα όριά τους

Γεωγραφικό πλαίσιο, βαθμός βεβαιότητας και άγνωστα αποτελέσματα στο API V2.

### Προσδιορίζει ένα αποτέλεσμα του GenderAPI το φύλο ενός ατόμου;

Όχι. Το GenderAPI συνάγει το φύλο από σήματα που σχετίζονται με το όνομα ή, όταν η αντίστοιχη επιλογή είναι ενεργή, από σήματα σε ψευδώνυμα. Μια πρόβλεψη δεν είναι επαληθευμένο στοιχείο για ένα άτομο. Διατηρήστε την αβεβαιότητα, σεβαστείτε την ταυτότητα φύλου που δηλώνει το ίδιο το άτομο και μη βασίζετε αποφάσεις με σοβαρές συνέπειες μόνο σε αυτή την εκτίμηση.

### Πώς επηρεάζει το γεωγραφικό πλαίσιο ένα αποτέλεσμα;

Ένας προαιρετικός κωδικός χώρας ISO με κεφαλαία γράμματα δίνει στο αίτημα περιφερειακό πλαίσιο. Δηλώστε τον μόνο όταν είναι σχετικός και γνωστός. Το ίδιο όνομα μπορεί να χρησιμοποιείται διαφορετικά σε κάθε περιοχή. Η χώρα που επιστρέφεται περιγράφει μια συσχέτιση με το όνομα και δεν αποδεικνύει ιθαγένεια ή τόπο κατοικίας.

[Χώρα και παράμετροι αιτήματος →](https://www.genderapi.io/el/docs/v2/request-parameters)

### Τι σημαίνει ο βαθμός βεβαιότητας στο V2;

Το confidence είναι μια τιμή από 0 έως 1 ή null όταν δεν υπάρχει διαθέσιμη τιμή. Διαβάστε το μαζί με το confidence_kind: το observed_frequency δηλώνει το πλήθος της επικρατέστερης κατηγορίας στο σύνολο δεδομένων διαιρεμένο με το συνολικό πλήθος, ενώ το model_reported είναι τιμή που αναφέρει το AI. Αυτές οι τιμές δεν είναι βαθμονομημένες πιθανότητες για ένα άτομο ούτε μετρημένη ακρίβεια του προϊόντος. Ορίστε τα όρια ελέγχου με βάση αντιπροσωπευτικά δεδομένα.

[Πεδία απόκρισης και τεκμήρια →](https://www.genderapi.io/el/docs/v2/responses)

### Τι σημαίνει gender: null και χρεώνεται αυτό το αποτέλεσμα;

Ένα επιτυχές αποτέλεσμα V2 με gender: null σημαίνει ότι τα διαθέσιμα σήματα δεν επέτρεψαν τον προσδιορισμό φύλου. Πρόκειται για την εγγενή τιμή null της JSON και όχι για τη συμβολοσειρά "null". Ένα επιτυχές άγνωστο αποτέλεσμα χρεώνεται με το κόστος της επιλεγμένης λειτουργίας. Χειριστείτε το ως άγνωστο. Ένα σφάλμα του παρόχου ή του αιτήματος είναι ξεχωριστή περίπτωση σφάλματος.

[Άγνωστα αποτελέσματα →](https://www.genderapi.io/el/docs/v2/responses)[Κανόνες χρέωσης πιστώσεων →](https://www.genderapi.io/el/docs/v2/credits-and-usage)

### Μπορώ να στείλω ονόματα σε διαφορετικά συστήματα γραφής;

Ναι. Στείλτε τα ονόματα σε Unicode με τους αρχικούς χαρακτήρες και τα διακριτικά σημεία που έχουν σημασία. Η κάλυψη και ο βαθμός βεβαιότητας εξαρτώνται από το όνομα, την περιοχή και τα διαθέσιμα σήματα. Γι' αυτό ελέγξτε ένα αντιπροσωπευτικό δείγμα από τα συστήματα γραφής και τις χώρες που εξυπηρετεί η εφαρμογή σας.

[Παραδείγματα αιτημάτων για ονόματα →](https://www.genderapi.io/el/docs/v2/gender-from-name)

## Επιλέξτε τύπο αιτήματος και επιλογές AI

Τύποι αιτημάτων V2, παρτίδες, συμπεριφορά του AI και όρια χρήσης.

### Μπορώ να αναλύσω ονόματα, διευθύνσεις email και ονόματα χρήστη σε μία παρτίδα;

Ναι. Το POST /api/v2/gender/batch δέχεται έως 50 στοιχεία με κλειδί API ή 10 με τη δοκιμαστική πρόσβαση IP. Κάθε στοιχείο έχει τα δικά του πεδία type και value, προαιρετικό country και δικές του ρυθμίσεις AI. Από προεπιλογή το AI είναι απενεργοποιημένο για τα στοιχεία μιας παρτίδας. Ελέγξτε κάθε αποτέλεσμα: μια παρτίδα μπορεί να επιστρέψει HTTP 200 ακόμη και αν ορισμένα στοιχεία απέτυχαν. Οι πιστώσεις χρεώνονται για κάθε στοιχείο που επεξεργάστηκε με επιτυχία, και για τα άγνωστα αποτελέσματα.

[Αιτήματα παρτίδας και μερικά σφάλματα →](https://www.genderapi.io/el/docs/v2/batch)

### Πώς λειτουργεί ένα αίτημα με διεύθυνση email;

Χρησιμοποιήστε type: email με έγκυρη διεύθυνση. Το API αναζητά ένα αξιοποιήσιμο σήμα ονόματος στο τοπικό τμήμα πριν από το @. Ο τομέας δεν δείχνει τίποτα για την ταυτότητα ή τη χώρα ενός ατόμου. Τα κοινόχρηστα γραμματοκιβώτια και οι διευθύνσεις χωρίς σήμα ονόματος μπορεί να δώσουν άγνωστο αποτέλεσμα. Ένα μεμονωμένο αίτημα χρησιμοποιεί από προεπιλογή το AI όταν το σύνολο δεδομένων δεν δίνει αποτέλεσμα.

[Παραδείγματα αιτημάτων για διευθύνσεις email →](https://www.genderapi.io/el/docs/v2/gender-from-email)

### Πώς λειτουργεί ένα αίτημα με όνομα χρήστη;

Χρησιμοποιήστε type: username. Ένα κανονικό αίτημα αναζητά ένα αναγνωρίσιμο μικρό όνομα σε ένα όνομα χρήστη ή σε ένα εμφανιζόμενο όνομα. Τα αφηρημένα ψευδώνυμα μπορεί να δώσουν άγνωστο αποτέλεσμα. Ενεργοποιήστε το forceToGenderize αν θέλετε, μετά από έλεγχο χωρίς αποτέλεσμα στο σύνολο δεδομένων, να χρησιμοποιηθεί AI με ανάλυση ψευδωνύμων. Έτσι μπορεί να προσδιοριστεί φύλο ακόμη και χωρίς να εξαχθεί πραγματικό μικρό όνομα.

[Παραδείγματα ονομάτων χρήστη και ψευδωνύμων →](https://www.genderapi.io/el/docs/v2/gender-from-username)

### Πότε χρησιμοποιεί το V2 AI;

Τα μεμονωμένα αιτήματα χρησιμοποιούν από προεπιλογή options.ai_mode: fallback: ελέγχεται πρώτα το σύνολο δεδομένων και, αν δεν προσδιοριστεί φύλο, χρησιμοποιείται AI, με συνολικό κόστος 1 πίστωση. Το off χρησιμοποιεί μόνο το σύνολο δεδομένων για 1 πίστωση. Το always παραλείπει το σύνολο δεδομένων και χρησιμοποιεί AI για 2 πιστώσεις. Τα στοιχεία μιας παρτίδας χρησιμοποιούν από προεπιλογή το off και μπορούν να ενεργοποιήσουν το AI μεμονωμένα. Καμία από αυτές τις λειτουργίες δεν εγγυάται αποτέλεσμα διαφορετικό από null.

[Επιλογές AI και κόστος →](https://www.genderapi.io/el/docs/v2/ai-options)

### Τι κάνει το forceToGenderize;

Αυτή η προαιρετική σημαία λειτουργεί με ονόματα, διευθύνσεις email και ονόματα χρήστη, και στα μεμονωμένα στοιχεία μιας παρτίδας. Ένα αποτέλεσμα που προσδιορίζεται από το σύνολο δεδομένων κοστίζει 1 πίστωση. Διαφορετικά χρησιμοποιείται AI με ανάλυση ψευδωνύμων, για 2 πιστώσεις συνολικά, ακόμη και αν το επιτυχές αποτέλεσμα παραμένει άγνωστο. Δεν απαιτείται πραγματικό μικρό όνομα. Παραλείψτε το ai_mode ή χρησιμοποιήστε fallback. Ο συνδυασμός της σημαίας με off ή always επιστρέφει 422.

[Ανάλυση ψευδωνύμων →](https://www.genderapi.io/el/docs/v2/ai-options)

### Πώς χρεώνονται οι πιστώσεις στο V2;

Διαβάστε το meta.usage.charged_credits για τις πιστώσεις που χρεώθηκαν πράγματι για μια λειτουργία και το billing_status για την επιβεβαίωση της χρέωσης. Οι κανονικές προβλέψεις από το σύνολο δεδομένων και με τη λειτουργία fallback κοστίζουν 1 πίστωση για κάθε στοιχείο που επεξεργάστηκε με επιτυχία. Το always και το AI με ανάλυση ψευδωνύμων κοστίζουν 2 πιστώσεις. Μια ολοκληρωμένη επικύρωση αριθμού τηλεφώνου κοστίζει 1 πίστωση, ακόμη και με μη έγκυρο αποτέλεσμα. Αρκεί ένα θετικό αρχικό υπόλοιπο, επομένως η τελική χρέωση μπορεί να κάνει το υπόλοιπο αρνητικό. Οι πιστώσεις των αποτυχημένων προβλέψεων επιστρέφονται. Μια μη επιβεβαιωμένη χρέωση πρέπει να ελεγχθεί από την υποστήριξη.

[Πιστώσεις και χρήση →](https://www.genderapi.io/el/docs/v2/credits-and-usage)[Δείτε τα πακέτα →](https://www.genderapi.io/el/price)

### Υπάρχουν όρια αιτημάτων στο V2;

Ναι. Οι τρέχουσες προεπιλεγμένες τιμές είναι 120 αιτήματα ανά λεπτό ανά λογαριασμό, 600 ανά λεπτό ανά διεύθυνση IP και 2 ταυτόχρονες λειτουργίες ανά λογαριασμό. Ισχύει επίσης η κοινόχρηστη χωρητικότητα της υπηρεσίας. Τα αιτήματα POST περιορίζονται στα 64 KiB. Οι παρτίδες δέχονται 50 στοιχεία με κλειδί ή 10 με τη δοκιμαστική πρόσβαση IP. Χειριστείτε το HTTP 429 και την κεφαλίδα Retry-After αντί να υποθέτετε ότι τα αιτήματα εντός αυτών των ορίων γίνονται πάντα δεκτά.

[Όρια και χειρισμός νέων προσπαθειών →](https://www.genderapi.io/el/docs/v2/errors-and-retries)

### Μπορώ να επαναλάβω ένα αίτημα που απέτυχε ή έληξε λόγω χρονικού ορίου;

Κάθε αίτημα πρόβλεψης είναι νέα λειτουργία και χρεώνεται κανονικά. Μια λήξη χρονικού ορίου ή μια χαμένη απόκριση δεν αποδεικνύει ότι δεν χρεώθηκαν πιστώσεις. Ελέγξτε το billing_status πριν δοκιμάσετε ξανά. Αν η χρέωση δεν έχει επιβεβαιωθεί, επικοινωνήστε με την υποστήριξη και αναφέρετε το request_id. Σε μια παρτίδα που απέτυχε εν μέρει, επαναλάβετε μόνο τα στοιχεία που απέτυχαν, αφού επιβεβαιωθεί η χρέωση. Σε περίπτωση 429, τηρήστε την κεφαλίδα Retry-After.

[Σφάλματα και ασφαλείς νέες προσπάθειες →](https://www.genderapi.io/el/docs/v2/errors-and-retries)

### Πού θα βρω παραδείγματα κώδικα και εργαλεία για το V2;

Οι οδηγοί του V2 περιέχουν παραδείγματα σε cURL, JavaScript, Python, PHP, Java, C# και Go. Το Swagger και το Postman χρησιμοποιούν την ίδια σύμβαση V2. Επιλέξτε τον τύπο δεδομένων εισόδου και φυλάξτε το κλειδί API σας στις ρυθμίσεις του διακομιστή.

[Τεκμηρίωση V2 →](https://www.genderapi.io/el/api-documentation)[Swagger V2 →](https://www.genderapi.io/swagger/v2/)

### Μπορώ να συνεχίσω να χρησιμοποιώ το V1;

Ναι. Οι υπάρχουσες ενσωματώσεις V1 διατηρούν τα endpoints και τις μορφές απόκρισής τους. Τα V1 και V2 χρησιμοποιούν το ίδιο κλειδί API και το ίδιο υπόλοιπο, αλλά διαφέρουν στα πεδία των αιτημάτων, στις αποκρίσεις και στα σφάλματα. Χρησιμοποιήστε την ξεχωριστή τεκμηρίωση του V1 για να συντηρήσετε έναν υπάρχοντα πελάτη και τον οδηγό μετάβασης όταν θέλετε να περάσετε στο V2.

[Τεκμηρίωση V1 →](https://www.genderapi.io/el/api-documentation/v1)[Μετάβαση από το V1 στο V2 →](https://www.genderapi.io/el/docs/v2/migration)

## Κατανοήστε πώς γίνεται η επεξεργασία των δεδομένων

Πού θα βρείτε τρέχουσες πληροφορίες για την επεξεργασία, τη διατήρηση και τη διαγραφή.

### Αποθηκεύονται τα επιτυχή αιτήματα προς το GenderAPI;

Η Πολιτική Απορρήτου εξηγεί ποια δεδομένα αιτημάτων, λειτουργικά δεδομένα και αρχεία καταγραφής ασφαλείας μπορεί να διατηρούνται, για ποιους σκοπούς υποβάλλονται σε επεξεργασία και πώς γίνεται η διαγραφή. Ελέγξτε αυτές τις πληροφορίες για την ενσωμάτωσή σας και μη στέλνετε περιττά προσωπικά δεδομένα.

[Πολιτική Απορρήτου →](https://www.genderapi.io/el/privacy-policy)

### Αποθηκεύονται οι διευθύνσεις email των αιτημάτων;

Η Πολιτική Απορρήτου περιγράφει πώς διαχειρίζονται οι διευθύνσεις email των αιτημάτων και τα σχετικά τεχνικά δεδομένα. Μια διεύθυνση email μπορεί να αποτελεί προσωπικό δεδομένο. Στείλτε μόνο ό,τι απαιτεί το αίτημα και μην κρατάτε πλήρεις διευθύνσεις στα δικά σας διαγνωστικά αρχεία καταγραφής.

[Διευθύνσεις email και απόρρητο →](https://www.genderapi.io/el/privacy-policy)

### Για πόσο διάστημα διατηρούνται τα αρχεία Excel ή CSV που ανεβάζω;

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

[Διατήρηση αρχείων →](https://www.genderapi.io/el/privacy-policy)[Επικοινωνία με την υποστήριξη →](https://www.genderapi.io/el/contact)

### Μπορούν πάροχοι υπηρεσιών να επεξεργάζονται δεδομένα αιτημάτων ή αρχείων που ανεβάζω;

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

[Πολιτική Απορρήτου →](https://www.genderapi.io/el/privacy-policy)[Υπεργολάβοι επεξεργασίας →](https://www.genderapi.io/el/subprocessors)[Πληροφορίες για τον GDPR →](https://www.genderapi.io/el/gdpr-compliance)

## Συνδέστε τα κλειδιά σας και διαχειριστείτε τον λογαριασμό σας

Δωρεάν πρόσβαση, έλεγχος ταυτότητας, έλεγχος υπολοίπου και υποστήριξη.

### Μπορώ να δοκιμάσω δωρεάν το GenderAPI;

Ναι. Ένας εγγεγραμμένος δωρεάν λογαριασμός περιλαμβάνει 200 πιστώσεις την ημέρα. Ανεξάρτητα από αυτό, η δοκιμαστική πρόσβαση IP του V2 χωρίς κλειδί παρέχει 10 πιστώσεις ανά δημόσια διεύθυνση IP κάθε 24 ώρες, τις οποίες μοιράζονται το V1 και οι άλλοι χρήστες της ίδιας διεύθυνσης IP. Και στις δύο περιπτώσεις ισχύουν τα κανονικά κόστη. Ο αριθμός των πιστώσεων δεν αντιστοιχεί πάντα στον αριθμό των αιτημάτων HTTP.

[Δωρεάν επίπεδο και τιμές →](https://www.genderapi.io/el/price)[Δοκιμαστική πρόσβαση IP →](https://www.genderapi.io/el/docs/v2/authentication)

### Πώς πραγματοποιώ έλεγχο ταυτότητας και πώς προστατεύω το κλειδί API μου;

Χρησιμοποιήστε Authorization: Bearer YOUR_API_KEY σε αξιόπιστο κώδικα διακομιστή. Τα αιτήματα POST απαιτούν επίσης Content-Type: application/json. Κρατήστε το πραγματικό κλειδί εκτός κώδικα του προγράμματος περιήγησης, δημόσιων αποθετηρίων και αρχείων καταγραφής. Ένα κλειδί που λείπει, έχει μη έγκυρη μορφή ή δεν αναγνωρίζεται μπορεί να οδηγήσει στη δοκιμαστική πρόσβαση IP. Γι' αυτό ελέγξτε ότι το meta.access.mode έχει την τιμή api_key. Τα αναγνωρισμένα κλειδιά που είναι απενεργοποιημένα, έχουν λήξει ή υπόκεινται σε περιορισμούς δεν μεταπίπτουν στη δοκιμαστική πρόσβαση.

[Έλεγχος ταυτότητας στο V2 →](https://www.genderapi.io/el/docs/v2/authentication)

### Πώς ελέγχω τις υπόλοιπες πιστώσεις μου;

Καλέστε το GET /api/v2/usage με το κλειδί Bearer σας. Αυτός ο έλεγχος υπολοίπου είναι δωρεάν και επιστρέφει το data.remaining_credits. Χωρίς κλειδί διαβάζεται το κοινόχρηστο υπόλοιπο της δοκιμαστικής πρόσβασης IP. Τα V1 και V2 χρησιμοποιούν το ίδιο υπόλοιπο λογαριασμού. Η τιμή remaining_credits σε μια πρόβλεψη δείχνει το υπόλοιπο τη στιγμή που ολοκληρώθηκε η λειτουργία.

[Υπόλοιπο και χρήση →](https://www.genderapi.io/el/docs/v2/credits-and-usage)

### Πού μπορώ να διαχειριστώ ή να ακυρώσω μια συνδρομή;

Συνδεθείτε στην εφαρμογή GenderAPI για να διαχειριστείτε τη συνδρομή που συνδέεται με το κλειδί API σας. Στις τρέχουσες ρυθμίσεις του λογαριασμού θα βρείτε το πακέτο σας και τις επιλογές ακύρωσης.

[Ανοίξτε τον λογαριασμό σας στο GenderAPI →](https://app.genderapi.io/)

### Πού μπορώ να αλλάξω τα στοιχεία χρέωσης;

Οι ρυθμίσεις χρέωσης και πληρωμής διαχειρίζονται μετά τη σύνδεση στην εφαρμογή GenderAPI, για κάθε κλειδί API ή συνδρομή.

[Ανοίξτε τον λογαριασμό σας στο GenderAPI →](https://app.genderapi.io/)

### Πώς αναφέρω ένα λανθασμένο αποτέλεσμα ή ζητώ βοήθεια με μια ενσωμάτωση;

Στείλτε στην υποστήριξη την έκδοση του API, το endpoint, το request_id και ένα σύντομο αναπαραγώγιμο παράδειγμα. Αναφέρετε τον κωδικό σφάλματος, αν υπάρχει, αλλά αφαιρέστε το κλειδί API σας και τα ευαίσθητα προσωπικά δεδομένα.

[Email στην υποστήριξη →](mailto:support@genderapi.io)

## Οδηγοί υλοποίησης και υπεύθυνης χρήσης

Απαντήσεις για τα αποτελέσματα, το απόρρητο και τη λειτουργία του V2, με συνδέσμους προς τους οδηγούς και έκδοση Markdown για κάθε απάντηση.

### Αποτελέσματα, βαθμός βεβαιότητας και υπεύθυνη χρήση

Όταν μια πρόβλεψη V2 δεν καταλήγει σε αποτέλεσμα, το πεδίο gender επιστρέφει την εγγενή τιμή null της JSON και όχι τη συμβολοσειρά "null". Ένα όνομα μπορεί να είναι αμφίσημο ή τα διαθέσιμα σήματα να μην επαρκούν. Ελέγξτε τα πεδία result_status και reason, όταν υπάρχουν. Διατηρήστε το άγνωστο αποτέλεσμα αντί να το εντάξετε αναγκαστικά σε μια κατηγορία. Μια επιτυχής πρόβλεψη χωρίς αποτέλεσμα χρεώνεται με το κόστος της επιλεγμένης λειτουργίας. Τα σφάλματα του αιτήματος ή του παρόχου είναι ξεχωριστές περιπτώσεις σφάλματος. Τα στοιχεία της σχετικής χρέωσης βρίσκονται στο meta.usage.

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

- [Γιατί ένα αποτέλεσμα είναι αμφίσημο ή άγνωστο;Όταν μια πρόβλεψη V2 δεν καταλήγει σε αποτέλεσμα, το πεδίο gender επιστρέφει την εγγενή τιμή null της JSON και όχι τη συμβολοσειρά "null". Ένα όνομα μπορεί να είναι αμφίσημο ή τα διαθέσιμα σήματα να μην επαρκούν. Ελέγξτε τα πεδία result_status και reason, όταν υπάρχουν. Διατηρήστε το άγνωστο αποτέλεσμα αντί να το εντάξετε αναγκαστικά σε μια κατηγορία. Μια επιτυχής πρόβλεψη χωρίς αποτέλεσμα χρεώνεται με το κόστος της επιλεγμένης λειτουργίας. Τα σφάλματα του αιτήματος ή του παρόχου είναι ξεχωριστές περιπτώσεις σφάλματος. Τα στοιχεία της σχετικής χρέωσης βρίσκονται στο meta.usage.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/ambiguous-and-unknown-name-results)
- [Πώς αξιολογείται η ακρίβεια του GenderAPI;Μια ουσιαστική αξιολόγηση ακρίβειας αναφέρει τον πληθυσμό που εξετάστηκε, την ημερομηνία, τη μέθοδο δειγματοληψίας, το ποσοστό άγνωστων αποτελεσμάτων και τα αποτελέσματα ανά περιοχή και σύστημα γραφής. Η τρέχουσα σελίδα μεθοδολογίας περιγράφει ένα πρωτόκολλο αξιολόγησης και όχι ένα μετρημένο ποσοστό ακρίβειας. Τα πεδία confidence και confidence_kind του V2 δείχνουν σε ποια σήματα βασίζεται ένα αποτέλεσμα. Δεν αντικαθιστούν μια αξιολόγηση με αντιπροσωπευτικά δεδομένα.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/how-accuracy-is-measured)

### Πηγές δεδομένων, απόρρητο και συμμόρφωση

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

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

Η Πολιτική Απορρήτου, οι πληροφορίες για τον GDPR, η Συμφωνία Επεξεργασίας Δεδομένων και ο κατάλογος υπεργολάβων επεξεργασίας περιγράφουν τους δημοσιευμένους όρους επεξεργασίας και τα μέτρα προστασίας. Εξετάστε τα ισχύοντα έγγραφα και κάθε συμφωνία που ισχύει για τον λογαριασμό σας. Για ερωτήματα που αφορούν ειδικά τον οργανισμό σας, για παράδειγμα τους ρόλους στην επεξεργασία, τις διαβιβάσεις δεδομένων ή τα αιτήματα υποκειμένων των δεδομένων, επικοινωνήστε με το GenderAPI. Μια γενική σελίδα συχνών ερωτήσεων δεν αντικαθιστά την ισχύουσα συμφωνία.

- [Πώς επιλέγονται οι πηγές δεδομένων ονομάτων;Η σελίδα για την προέλευση των δεδομένων περιγράφει το πλαίσιο τεκμηρίωσης για τις κατηγορίες πηγών, τα κριτήρια επιλογής, τις άδειες χρήσης και τους περιορισμούς ανά περιοχή και σύστημα γραφής. Προς το παρόν δεν έχει δημοσιευθεί εκεί επαληθευμένος κατάλογος πηγών. Διαβάστε αυτή τη σελίδα και επικοινωνήστε με την υποστήριξη, αν η ενσωμάτωσή σας έχει απαιτήσεις σχετικά με τις πηγές. Μην υποθέτετε πηγές, μέγεθος συνόλου δεδομένων ή τιμές κάλυψης που δεν είναι τεκμηριωμένες.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/how-name-data-sources-are-selected)
- [Πόσο συχνά ενημερώνονται τα δεδομένα ονομάτων;Η τρέχουσα σελίδα για την προέλευση των δεδομένων δεν αναφέρει ενιαίο πρόγραμμα ενημέρωσης για όλες τις εγγραφές ονομάτων ή τους κανόνες επεξεργασίας. Αν η επικαιρότητα των δεδομένων είναι σημαντική για τη χρήση σας, ρωτήστε την υποστήριξη για το συγκεκριμένο σύνολο δεδομένων ή τη διαδικασία και ελέγξτε αντιπροσωπευτικά αποτελέσματα. Η ημερομηνία αναθεώρησης μιας σελίδας δεν σημαίνει ότι όλες οι υποκείμενες εγγραφές ενημερώθηκαν εκείνη την ημέρα.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/how-often-name-data-is-updated)
- [Πού θα βρω πληροφορίες για τον GDPR και τη συμφωνία επεξεργασίας δεδομένων;Η Πολιτική Απορρήτου, οι πληροφορίες για τον GDPR, η Συμφωνία Επεξεργασίας Δεδομένων και ο κατάλογος υπεργολάβων επεξεργασίας περιγράφουν τους δημοσιευμένους όρους επεξεργασίας και τα μέτρα προστασίας. Εξετάστε τα ισχύοντα έγγραφα και κάθε συμφωνία που ισχύει για τον λογαριασμό σας. Για ερωτήματα που αφορούν ειδικά τον οργανισμό σας, για παράδειγμα τους ρόλους στην επεξεργασία, τις διαβιβάσεις δεδομένων ή τα αιτήματα υποκειμένων των δεδομένων, επικοινωνήστε με το GenderAPI. Μια γενική σελίδα συχνών ερωτήσεων δεν αντικαθιστά την ισχύουσα συμφωνία.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/genderapi-gdpr-and-dpa)

### Λειτουργία του API, σφάλματα και χρεώσεις

Χρησιμοποιήστε Authorization: Bearer YOUR_API_KEY σε αξιόπιστο κώδικα διακομιστή. Τα αιτήματα POST του V2 απαιτούν επίσης Content-Type: application/json. Το GET /api/v2/gender δέχεται κλειδί και ως παράμετρο ερωτήματος, αλλά με τις κεφαλίδες τα διαπιστευτήρια δεν εμφανίζονται σε URL του προγράμματος περιήγησης. Ένα κλειδί που λείπει, έχει μη έγκυρη μορφή ή δεν αναγνωρίζεται μπορεί να οδηγήσει στην κοινόχρηστη δοκιμαστική πρόσβαση IP. Σε μια ενσωμάτωση με λογαριασμό, ελέγξτε ότι το meta.access.mode έχει την τιμή api_key. Τα αναγνωρισμένα κλειδιά που είναι απενεργοποιημένα, έχουν λήξει ή υπόκεινται σε περιορισμούς δεν μεταπίπτουν σε δοκιμαστική πρόσβαση.

Το V2 εφαρμόζει όρια στον αριθμό των αιτημάτων και στα ταυτόχρονα αιτήματα. Χειριστείτε το HTTP 429 και την κεφαλίδα Retry-After. Κάθε επαναλαμβανόμενη πρόβλεψη είναι νέα λειτουργία και χρεώνεται κανονικά. Μην επαναλαμβάνετε αυτόματα αιτήματα μετά από λήξη χρονικού ορίου, χαμένη απόκριση ή μη επιβεβαιωμένη χρέωση. Ελέγξτε πρώτα τα code, action και meta.usage.billing_status. Σε περίπτωση billing_reconciliation_required, επικοινωνήστε με την υποστήριξη και αναφέρετε το request_id. Χρησιμοποιήστε περιορισμένο backoff μόνο όταν η χρέωση έχει επιβεβαιωθεί και η τεκμηριωμένη τιμή action επιτρέπει νέα προσπάθεια.

Τα σφάλματα του API V2 χρησιμοποιούν κωδικούς κατάστασης σφάλματος HTTP και Problem Details σύμφωνα με το RFC 9457, με τα σταθερά πεδία code και action. Βασιστείτε σε αυτά τα πεδία αντί να συγκρίνετε το κείμενο του detail και κρατήστε το request_id για την υποστήριξη. Ένα επιτυχές άγνωστο αποτέλεσμα δεν είναι σφάλμα. Οι αποκρίσεις παρτίδας μπορεί να περιέχουν σφάλματα για μεμονωμένα στοιχεία ακόμη και με HTTP 200. Ένας διακομιστής μεσολάβησης μπορεί να επιστρέψει σφάλμα σε μορφή διαφορετική από JSON, και μια χαμένη ή μη αναγνώσιμη απόκριση δεν αποδεικνύει ότι δεν χρεώθηκαν πιστώσεις.

Καλέστε το GET /api/v2/usage με το κλειδί API σας στην κεφαλίδα Bearer από αξιόπιστο κώδικα διακομιστή. Αυτό το αίτημα είναι δωρεάν και επιστρέφει το data.remaining_credits. Χωρίς κλειδί διαβάζεται το υπόλοιπο της κοινόχρηστης δοκιμαστικής πρόσβασης IP. Τα V1 και V2 χρησιμοποιούν το ίδιο υπόλοιπο λογαριασμού. Το πεδίο meta.usage μιας πρόβλεψης δείχνει το κόστος της συγκεκριμένης λειτουργίας και το υπόλοιπο τη στιγμή της ολοκλήρωσής της, το οποίο μπορεί να αλλάξει με ταυτόχρονα αιτήματα. Κρατήστε τα διαπιστευτήρια εκτός αρχείων καταγραφής και μη θεωρείτε έναν έλεγχο υπολοίπου απόδειξη ότι ένα συγκεκριμένο αίτημα με χαμένη απόκριση δεν χρεώθηκε.

Δημιουργήστε τις νέες ενσωματώσεις στο V2 και αφήστε τους υπάρχοντες πελάτες V1 να χρησιμοποιούν τα τεκμηριωμένα endpoints τους μέχρι να θελήσετε να μεταβείτε. Και οι δύο εκδόσεις χρησιμοποιούν τα ίδια κλειδιά API και τις ίδιες πιστώσεις, αλλά διαφέρουν στα πεδία των αιτημάτων, στη δομή των αποκρίσεων και στη μορφή των σφαλμάτων. Ακολουθήστε τον οδηγό μετάβασης, ελέγξτε επιτυχή και άγνωστα αποτελέσματα καθώς και σφάλματα, και προσαρμόστε τον χειρισμό των αποκρίσεων πριν αλλάξετε endpoint. Η τεκμηρίωση του V1 παραμένει διαθέσιμη για τις υπάρχουσες ενσωματώσεις.

Όταν τα αιτήματα αποτυγχάνουν, χρησιμοποιήστε τον κωδικό σφάλματος που επιστρέφεται για να διακρίνετε διακοπές λειτουργίας, μη έγκυρα δεδομένα εισόδου, προβλήματα πρόσβασης στον λογαριασμό, εξαντλημένες πιστώσεις και όρια αιτημάτων. Παρακολουθήστε στην ενσωμάτωσή σας το ποσοστό επιτυχών αιτημάτων και τους χρόνους απόκρισης. Επικοινωνήστε με την υποστήριξη και αναφέρετε το request_id σε περίπτωση ανεξήγητου σφάλματος ή ασαφούς χρέωσης. Βασίστε τους ισχυρισμούς για τη διαθεσιμότητα σε μετρήσεις. Αυτή η σελίδα συχνών ερωτήσεων δεν αναφέρει εγγυημένο ποσοστό διαθεσιμότητας.

- [Πώς πραγματοποιώ έλεγχο ταυτότητας στα αιτήματα V2;Χρησιμοποιήστε Authorization: Bearer YOUR_API_KEY σε αξιόπιστο κώδικα διακομιστή. Τα αιτήματα POST του V2 απαιτούν επίσης Content-Type: application/json. Το GET /api/v2/gender δέχεται κλειδί και ως παράμετρο ερωτήματος, αλλά με τις κεφαλίδες τα διαπιστευτήρια δεν εμφανίζονται σε URL του προγράμματος περιήγησης. Ένα κλειδί που λείπει, έχει μη έγκυρη μορφή ή δεν αναγνωρίζεται μπορεί να οδηγήσει στην κοινόχρηστη δοκιμαστική πρόσβαση IP. Σε μια ενσωμάτωση με λογαριασμό, ελέγξτε ότι το meta.access.mode έχει την τιμή api_key. Τα αναγνωρισμένα κλειδιά που είναι απενεργοποιημένα, έχουν λήξει ή υπόκεινται σε περιορισμούς δεν μεταπίπτουν σε δοκιμαστική πρόσβαση.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/how-to-authenticate-api-requests)
- [Πώς χειρίζομαι τα όρια αιτημάτων και τις νέες προσπάθειες;Το V2 εφαρμόζει όρια στον αριθμό των αιτημάτων και στα ταυτόχρονα αιτήματα. Χειριστείτε το HTTP 429 και την κεφαλίδα Retry-After. Κάθε επαναλαμβανόμενη πρόβλεψη είναι νέα λειτουργία και χρεώνεται κανονικά. Μην επαναλαμβάνετε αυτόματα αιτήματα μετά από λήξη χρονικού ορίου, χαμένη απόκριση ή μη επιβεβαιωμένη χρέωση. Ελέγξτε πρώτα τα code, action και meta.usage.billing_status. Σε περίπτωση billing_reconciliation_required, επικοινωνήστε με την υποστήριξη και αναφέρετε το request_id. Χρησιμοποιήστε περιορισμένο backoff μόνο όταν η χρέωση έχει επιβεβαιωθεί και η τεκμηριωμένη τιμή action επιτρέπει νέα προσπάθεια.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/rate-limits-and-retries)
- [Πώς ερμηνεύω τα σφάλματα του V2;Τα σφάλματα του API V2 χρησιμοποιούν κωδικούς κατάστασης σφάλματος HTTP και Problem Details σύμφωνα με το RFC 9457, με τα σταθερά πεδία code και action. Βασιστείτε σε αυτά τα πεδία αντί να συγκρίνετε το κείμενο του detail και κρατήστε το request_id για την υποστήριξη. Ένα επιτυχές άγνωστο αποτέλεσμα δεν είναι σφάλμα. Οι αποκρίσεις παρτίδας μπορεί να περιέχουν σφάλματα για μεμονωμένα στοιχεία ακόμη και με HTTP 200. Ένας διακομιστής μεσολάβησης μπορεί να επιστρέψει σφάλμα σε μορφή διαφορετική από JSON, και μια χαμένη ή μη αναγνώσιμη απόκριση δεν αποδεικνύει ότι δεν χρεώθηκαν πιστώσεις.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/api-error-codes)
- [Πώς ελέγχω τις υπόλοιπες πιστώσεις μου;Καλέστε το GET /api/v2/usage με το κλειδί API σας στην κεφαλίδα Bearer από αξιόπιστο κώδικα διακομιστή. Αυτό το αίτημα είναι δωρεάν και επιστρέφει το data.remaining_credits. Χωρίς κλειδί διαβάζεται το υπόλοιπο της κοινόχρηστης δοκιμαστικής πρόσβασης IP. Τα V1 και V2 χρησιμοποιούν το ίδιο υπόλοιπο λογαριασμού. Το πεδίο meta.usage μιας πρόβλεψης δείχνει το κόστος της συγκεκριμένης λειτουργίας και το υπόλοιπο τη στιγμή της ολοκλήρωσής της, το οποίο μπορεί να αλλάξει με ταυτόχρονα αιτήματα. Κρατήστε τα διαπιστευτήρια εκτός αρχείων καταγραφής και μη θεωρείτε έναν έλεγχο υπολοίπου απόδειξη ότι ένα συγκεκριμένο αίτημα με χαμένη απόκριση δεν χρεώθηκε.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/check-credits-and-quota)
- [Πώς περνώ από το V1 στο V2 χωρίς διακοπές;Δημιουργήστε τις νέες ενσωματώσεις στο V2 και αφήστε τους υπάρχοντες πελάτες V1 να χρησιμοποιούν τα τεκμηριωμένα endpoints τους μέχρι να θελήσετε να μεταβείτε. Και οι δύο εκδόσεις χρησιμοποιούν τα ίδια κλειδιά API και τις ίδιες πιστώσεις, αλλά διαφέρουν στα πεδία των αιτημάτων, στη δομή των αποκρίσεων και στη μορφή των σφαλμάτων. Ακολουθήστε τον οδηγό μετάβασης, ελέγξτε επιτυχή και άγνωστα αποτελέσματα καθώς και σφάλματα, και προσαρμόστε τον χειρισμό των αποκρίσεων πριν αλλάξετε endpoint. Η τεκμηρίωση του V1 παραμένει διαθέσιμη για τις υπάρχουσες ενσωματώσεις.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/api-versioning-and-breaking-changes)
- [Πώς εντοπίζω σφάλματα και παρακολουθώ τη διαθεσιμότητα της υπηρεσίας;Όταν τα αιτήματα αποτυγχάνουν, χρησιμοποιήστε τον κωδικό σφάλματος που επιστρέφεται για να διακρίνετε διακοπές λειτουργίας, μη έγκυρα δεδομένα εισόδου, προβλήματα πρόσβασης στον λογαριασμό, εξαντλημένες πιστώσεις και όρια αιτημάτων. Παρακολουθήστε στην ενσωμάτωσή σας το ποσοστό επιτυχών αιτημάτων και τους χρόνους απόκρισης. Επικοινωνήστε με την υποστήριξη και αναφέρετε το request_id σε περίπτωση ανεξήγητου σφάλματος ή ασαφούς χρέωσης. Βασίστε τους ισχυρισμούς για τη διαθεσιμότητα σε μετρήσεις. Αυτή η σελίδα συχνών ερωτήσεων δεν αναφέρει εγγυημένο ποσοστό διαθεσιμότητας.Διαβάστε την πλήρη απάντηση →](https://www.genderapi.io/el/frequently-asked-questions/service-status-and-uptime)

## Στείλτε μας ένα αναπαραγώγιμο παράδειγμα

Αναφέρετε το endpoint, τις παραμέτρους του αιτήματος και το σφάλμα που επιστράφηκε, αλλά μη στείλετε το κλειδί API παραγωγής σας ούτε ευαίσθητα προσωπικά δεδομένα.

- [Επικοινωνία με την υποστήριξη](mailto:support@genderapi.io)
- [Δείτε τα σφάλματα του V2](https://www.genderapi.io/el/docs/v2/errors-and-retries)