# API v2 JSON αποκρίσεις και εμπιστοσύνη

> Κατανόηση πεδίων δεδομένων και μεταδεδομένων GenderAPI v2: φύλο, άγνωστοι λόγοι, εμπιστοσύνη, στοιχεία δεδομένων, βαθμολογίες AI, λειτουργία πρόσβασης και μεταδεδομένα χρέωσης.

Canonical HTML: https://www.genderapi.io/el/docs/v2/responses

Last reviewed: 2026-09-25

## Κατανοήστε την απόκριση JSON

Οι επιτυχείς μεμονωμένες αποκρίσεις περιέχουν data και meta. Η απόκριση δεδομένων παρακάτω είναι ένα ενδεικτικό παράδειγμα, όχι μια μέτρηση της ακρίβειας του προϊόντος ή μια υπόσχεση για το ίδιο ζωντανό αποτέλεσμα. Εμφανίζει δοκιμαστική πρόσβαση IP. Αιτήματα επικυρωμένα με κλειδί λογαριασμού επιστρέφουν access.mode: api_key. Τα πεδία που ισχύουν μόνο για τη δοκιμή έχουν την τιμή null.

| Πεδίο | Σημασία |
| --- | --- |
| data.input | Τύπος εισαγωγής, τιμή και χώρα. Το forceToGenderize περιλαμβάνεται όταν το true. |
| data.name | Αντιστοιχισμένο ή εξαγόμενο όνομα. null όταν δεν είναι διαθέσιμο. |
| data.gender | male, female ή JSON null. Αυτή είναι μια πρόβλεψη, όχι απόδειξη της ταυτότητας ενός ατόμου. |
| data.result_status / reason | Όταν το result_status είναι identified, το reason είναι null. Όταν η κατάσταση είναι unknown, ο λόγος είναι not_found, no_name_candidate, ambiguous ή insufficient_evidence. |
| data.confidence | 0–1 σκορ ή null. Το μηδενικό φύλο έχει εμπιστοσύνη null. |
| data.confidence_kind | observed_frequency: ο αριθμός του κυρίαρχου φύλου διαιρούμενος με το συνολικό πλήθος στο επιλεγμένο σύνολο δεδομένων. model_reported: βαθμολογία AI, όχι βαθμονομημένη πιθανότητα. Η τιμή είναι null όταν δεν είναι διαθέσιμη. |
| data.sample_count | Μέγεθος δείγματος συνόλου δεδομένων ή null. Η τεχνητή νοημοσύνη δεν επινοεί μέτρηση δειγμάτων. |
| data.source | dataset, ai ή none. |
| data.country / country_source | Συσχέτιση χώρας από σύνολο δεδομένων ή ai_association ή null. Δεν προσδιορίζει την εθνικότητα, την κατοικία ή την εθνικότητα. |
| data.match | Το αντίστοιχο όνομα στο σύνολο δεδομένων, η μέθοδος (normalized, token, substring ή model_inference), το εύρος (country ή global) και η χώρα αντιστοίχισης. Οι μη διαθέσιμες πληροφορίες έχουν τιμή null. |
| meta.request_id / duration_ms | Αναγνωριστικό λειτουργίας και διάρκεια επεξεργασίας σε χιλιοστά του δευτερολέπτου. |
| meta.access | Πώς παραχωρήθηκε η πρόσβαση και ο λόγος της δοκιμαστικής εναλλακτικής, εάν υπάρχει. |
| meta.usage | Καθαρή χρέωση, υπόλοιπο χρόνου ολοκλήρωσης, κατάσταση χρέωσης και δοκιμαστική επαναφορά. |

```json
{
  "data": {
    "input": {
      "type": "name",
      "value": "Onur",
      "country": "TR"
    },
    "name": "onur",
    "gender": "male",
    "country": "TR",
    "confidence": 0.9,
    "confidence_kind": "observed_frequency",
    "sample_count": 100,
    "source": "dataset",
    "result_status": "identified",
    "reason": null,
    "country_source": "dataset",
    "match": {
      "name": "onur",
      "method": "normalized",
      "scope": "country",
      "country": "TR"
    }
  },
  "meta": {
    "request_id": "11111111-1111-4111-8111-111111111111",
    "duration_ms": 12,
    "access": {
      "mode": "ip_trial",
      "reason": "api_key_missing"
    },
    "usage": {
      "charged_credits": 1,
      "remaining_credits": 9,
      "billing_status": "confirmed",
      "resets_at": "2026-09-26T12:00:00.000Z",
      "limit": 10,
      "period_seconds": 86400
    }
  }
}
```

- [Ολοκληρωμένα σχήματα απόκρισης και παραδείγματα παρτίδων](https://api.genderapi.io/api/v2/openapi.json)

## Ένα επιτυχημένο άγνωστο αποτέλεσμα

HTTP 200 σημαίνει τη λειτουργία που ολοκληρώθηκε. δεν εγγυάται ένα φύλο. Διατηρήστε το JSON null αντί να το μετατρέψετε σε male, female, κενή συμβολοσειρά ή μηδενική εμπιστοσύνη. Ελέγξτε τα σφάλματα data.result_status και data.reason ξεχωριστά από τα σφάλματα HTTP.

Αυτό το παράδειγμα μόνο για σύνολο δεδομένων επιστρέφει τα source: none και reason: not_found και εξακολουθεί να κοστίζει 1 πίστωση. Εάν οι μετρήσεις των δεδομένων για τα δύο φύλα είναι ίσες, το αποτέλεσμα μπορεί να περιέχει reason: ambiguous διατηρώντας παράλληλα το sample_count. Ένα άγνωστο αποτέλεσμα AI χρησιμοποιεί source: ai και reason: insufficient_evidence.

```json
{
  "data": {
    "input": {
      "type": "name",
      "value": "zzzxxyy",
      "country": null
    },
    "name": null,
    "gender": null,
    "country": null,
    "confidence": null,
    "confidence_kind": null,
    "sample_count": null,
    "source": "none",
    "result_status": "unknown",
    "reason": "not_found",
    "country_source": null,
    "match": {
      "name": null,
      "method": null,
      "scope": null,
      "country": null
    }
  },
  "meta": {
    "request_id": "11111111-1111-4111-8111-111111111111",
    "duration_ms": 12,
    "access": {
      "mode": "ip_trial",
      "reason": "api_key_missing"
    },
    "usage": {
      "charged_credits": 1,
      "remaining_credits": 8,
      "billing_status": "confirmed",
      "resets_at": "2026-09-26T12:00:00.000Z",
      "limit": 10,
      "period_seconds": 86400
    }
  }
}
```

## Ερμηνεύστε την εμπιστοσύνη και τα αντίστοιχα στοιχεία

Η εμπιστοσύνη 0,9 είναι σε κλίμακα 0–1. Για το observed_frequency σημαίνει το κυρίαρχο πλήθος διαιρούμενο με το επιλεγμένο σύνολο δεδομένων. δεν μετράται η ακρίβεια του προϊόντος από άκρο σε άκρο. Η βαθμολογία model_reported παρέχεται από το AI και δεν είναι βαθμονομημένη με βάση τις συχνότητες δεδομένων.

Επιλέξτε οποιοδήποτε όριο εφαρμογής χρησιμοποιώντας τα δικά σας δεδομένα αξιολόγησης και το confidence_kind. Μην ταξινομείτε απευθείας τις βαθμολογίες δεδομένων και τεχνητής νοημοσύνης σαν να μέτρησαν το ίδιο πράγμα. Τα AI match.name, match.scope και match.country είναι null επειδή δεν επιλέχθηκε καμία σειρά δεδομένων. Το match.method είναι το model_inference.

Για τα πλήρη ονόματα, ένα αποτέλεσμα δεδομένων μπορεί να προέρχεται από ένα στοιχείο και όχι από την πλήρη συμβολοσειρά. Το data.input διατηρεί την υποβληθείσα τιμή. Το data.name περιγράφει το όνομα που επιστράφηκε και το data.match περιγράφει το υποψήφιο και το πεδίο αναζήτησης.

## Σχετικοί οδηγοί

- [Μαζική απόκριση και σφάλματα ανά στοιχείο](https://www.genderapi.io/el/docs/v2/batch#batch-response)
- [Κατάσταση χρέωσης και υπολειπόμενες πιστώσεις](https://www.genderapi.io/el/docs/v2/credits-and-usage)
- [Συμβατότητα απόκρισης και επαναλήψεις](https://www.genderapi.io/el/docs/v2/errors-and-retries#retries)