# API V2 JSON yanıtları ve güven puanı

> GenderAPI V2 data ve meta alanlarını anlayın: cinsiyet, belirsizlik nedenleri, güven puanı, veri kümesi kanıtı, yapay zekâ puanı, erişim ve ücretlendirme.

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

Last reviewed: 2026-09-25

## JSON yanıtını anlayın

Başarılı tekli yanıt data ve meta içerir. Aşağıdaki veri kümesi örneği temsilidir; ölçülmüş ürün doğruluğu veya canlı istekte aynı sonuç sözü değildir. IP denemesini gösterir. Hesap anahtarlı isteklerde access.mode: api_key, yalnızca denemeye ait kota alanlarında null döner.

| Alan | Anlam |
| --- | --- |
| data.input | Girdi türü, değeri ve ülkesi. forceToGenderize, true olduğunda eklenir. |
| data.name | Eşleşen veya çıkarılan ad; bulunamıyorsa null. |
| data.gender | male, female veya JSON null. Doğrulanmış kişisel kimlik değil, tahmindir. |
| data.result_status / reason | identified durumunda reason null; unknown durumunda not_found, no_name_candidate, ambiguous veya insufficient_evidence olur. |
| data.confidence | 0–1 arası puan veya null. Cinsiyet null ise güven puanı da null’dır. |
| data.confidence_kind | observed_frequency: baskın veri kümesi sayısı / toplam. model_reported: yapay zekâ puanı; kalibre edilmiş olasılık değildir. Bilgi yoksa null. |
| data.sample_count | Veri kümesindeki örnek sayısı veya null. Yapay zekâ örnek sayısı üretmez. |
| data.source | dataset, ai veya none. |
| data.country / country_source | Veri kümesi veya ai_association kaynaklı ülke ilişkisi; bilgi yoksa null. Vatandaşlık, ikamet veya etnik köken kanıtı değildir. |
| data.match | Eşleşen isim, yöntem (normalized, token, substring veya model_inference), ülke/genel kapsam ve eşleşen ülke. Olmayan kanıt null’dır. |
| meta.request_id / duration_ms | İşlem kimliği ve milisaniye cinsinden işlem süresi. |
| meta.access | Erişimin nasıl sağlandığı ve varsa IP denemesine geçiş nedeni. |
| meta.usage | Net kredi tutarı, tamamlanma anındaki bakiye, ücretlendirme durumu ve deneme yenileme bilgileri. |

```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
    }
  }
}
```

- [Tam yanıt şemaları ve toplu örnekler](https://api.genderapi.io/api/v2/openapi.json)

## Başarıyla tamamlanan belirsiz sonuç

HTTP 200, işlemin tamamlandığını gösterir; cinsiyet bulunmasını garanti etmez. JSON null değerini male, female, boş metin veya sıfır güven puanına çevirmeyin. data.result_status ve data.reason alanlarını HTTP hatalarından ayrı değerlendirin.

Bu temsili veri kümesi örneği source: none ve reason: not_found döndürür; yine de 1 kredidir. Eşit dağılımlı kayıtta reason: ambiguous dönebilir ve sample_count korunur. Belirsiz yapay zekâ sonucunda source: ai ve reason: insufficient_evidence kullanılır.

```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
    }
  }
}
```

## Güven puanı ve eşleşme kanıtını yorumlama

0.9 güven puanı, 0–1 ölçeğindedir. observed_frequency için baskın sayının seçilen veri kümesi toplamına oranıdır; uçtan uca ölçülmüş ürün doğruluğu değildir. model_reported, yapay zekânın verdiği ve veri kümesi frekanslarına göre kalibre edilmemiş puandır.

Uygulama eşiğinizi kendi değerlendirme verileriniz ve confidence_kind ile belirleyin. Veri kümesi ve yapay zekâ puanlarını aynı şeyi ölçüyormuş gibi sıralamayın. Yapay zekâda veri kümesi kaydı seçilmediğinden match.name, match.scope ve match.country null; match.method ise model_inference olur.

Tam ad sorgusunda sonuç, bütün metin yerine bir bileşenden gelebilir. data.input gönderilen değeri, data.name dönen adı, data.match ise adayı ve sorgu kapsamını gösterir.

## İlgili rehberler

- [Toplu yanıt ve öğe düzeyindeki hatalar](https://www.genderapi.io/tr/docs/v2/batch#batch-response)
- [Ücretlendirme durumu ve kalan krediler](https://www.genderapi.io/tr/docs/v2/credits-and-usage)
- [Yanıt uyumluluğu ve yeniden denemeler](https://www.genderapi.io/tr/docs/v2/errors-and-retries#retries)