# Resmi GenderAPI.io V2 SDK'ları

> Python, JavaScript, PHP, Ruby, Java, R ve C# için resmi GenderAPI.io V2 SDK'larını kurun. Paketleri, gereksinimleri ve ortak istek davranışını karşılaştırın.

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

Last reviewed: 2026-09-27

## Paket seçin

Resmi açık kaynak SDK'lar, bu kılavuzlarda anlatılan aynı V2 API’sini çağırır. Her paketin 2.x sürümü API V2’yi kullanır. Yeni projelerde 2.x serisini kurun.

| Dil | Paket | Kurulum | Gereksinim |
| --- | --- | --- | --- |
| Python | `genderapi (PyPI)` | `pip install "genderapi>=2,<3"` | Python 3.9+ |
| JavaScript / TypeScript | `genderapi (npm)` | `npm install genderapi@2` | Node.js 18+ |
| PHP | `genderapi/genderapi (Packagist)` | `composer require "genderapi/genderapi:^2.0"` | PHP 8.1+ |
| Ruby | `genderapi (RubyGems)` | `gem install genderapi -v "~> 2.0"` | Ruby 3.0+ |
| Java | `com.github.GenderAPI:genderapi-java (JitPack)` | `implementation 'com.github.GenderAPI:genderapi-java:v2.0.0'` | Java 11+ |
| R | `genderapi (GitHub)` | `remotes::install_github("GenderAPI/genderapi-R", ref = "v2.0.0")` | R 4.1+ |
| C# / .NET | `GenderAPI (NuGet)` | `dotnet add package GenderAPI` | .NET 8 veya .NET Standard 2.0 |

## Paket deposu notları

- Java: Depolarınıza https://jitpack.io adresini ekleyin. Aynı sürüm GitHub Packages’a da io.genderapi:genderapi olarak yayımlanır; bunun için read:packages iznine sahip bir GitHub token’ı gerekir.
- R: 2.0.0 sürümü CRAN incelemesindeyken CRAN hâlâ 1.x paketini sunar. CRAN yayımlayana kadar 2.0.0 sürümünü GitHub etiketinden kurun.
- JavaScript: Paket sunucu tarafı çalışma ortamları içindir. API anahtarınızı açığa çıkaracağı için tarayıcı kodunda kullanmayın.

## Ortak davranış

- Her istemci API anahtarını GENDERAPI_API_KEY değişkeninden okur veya oluşturucu (constructor) üzerinden kabul eder. Anahtarı sunucunuzda tutun.
- API anahtarı olmadan istekler ortak IP denemesini kullanır: IP adresi başına 24 saatte 10 kredi.
- Paketi içe aktarmak veya istemci oluşturmak istek göndermez. Her metot çağrısı tam olarak bir istek gönderir.
- Hiçbir SDK isteği otomatik olarak yeniden denemez. Yeniden deneme normal şekilde ücretlendirilen yeni bir işlemdir; bu nedenle önce hatayı ve ücretlendirme durumunu kontrol edin.
- SDK'lar yönlendirmeleri takip etmez ve varsayılan zaman aşımı 10 saniyedir.
- Belirsiz sonuç başarılı bir yanıttır: gender null olur ve istek normal şekilde ücretlendirilir.
- Hatalar HTTP durum kodunu, hata kodunu, istek kimliğini ve varsa Retry-After değerini sunar.

- [Kimlik doğrulama ve deneme erişimi](https://www.genderapi.io/tr/docs/v2/authentication)
- [Krediler ve kullanım](https://www.genderapi.io/tr/docs/v2/credits-and-usage)
- [Hatalar ve yeniden denemeler](https://www.genderapi.io/tr/docs/v2/errors-and-retries)

## Hızlı başlangıç örnekleri

Her örnek tek bir isim tahmini gönderir ve 1 kredi harcar. Önce sunucu ortamında GENDERAPI_API_KEY değişkenini ayarlayın. Toplu sorgular, kullanım kontrolleri ve hata yönetimi her deponun README dosyasında anlatılır.

**Python**

```python
from genderapi import GenderAPI

client = GenderAPI()  # reads GENDERAPI_API_KEY
result = client.name("Alice", country="US")
print(result.data.gender, result.data.result_status)
print(result.meta.usage.charged_credits)
```

**JavaScript / TypeScript**

```javascript
import { GenderAPI } from "genderapi";

const client = new GenderAPI(); // reads GENDERAPI_API_KEY
const { data, meta } = await client.name("Andrea", { country: "IT" });
console.log(data.gender, data.result_status, meta.usage.charged_credits);
```

**PHP**

```php
<?php
require __DIR__ . '/vendor/autoload.php';

use GenderApi\Client;

$client = new Client(); // reads GENDERAPI_API_KEY
$result = $client->name('Elif', country: 'TR');
echo $result->data->gender ?? 'unknown', ' ', $result->meta->usage->chargedCredits, "\n";
```

**Ruby**

```ruby
require "genderapi"

client = GenderAPI::Client.new # reads ENV["GENDERAPI_API_KEY"]
result = client.name("Andrea", country: "IT")
puts result.data.gender, result.usage.charged_credits
```

**Java**

```java
import io.genderapi.GenderApiClient;
import io.genderapi.model.GenderResponse;

GenderApiClient client = new GenderApiClient(); // reads GENDERAPI_API_KEY
GenderResponse response = client.name("Andrea", "IT");
System.out.println(response.getData().getGender());
System.out.println(response.getMeta().getUsage().getChargedCredits());
```

**R**

```r
library(genderapi)

res <- genderapi_name("Emre", country = "TR")  # reads GENDERAPI_API_KEY
res$data$gender
res$meta$usage$charged_credits
```

**C# / .NET**

```csharp
using GenderApi;

using var client = new GenderApiClient(); // reads GENDERAPI_API_KEY
GenderResponse res = await client.NameAsync("Alice", country: "US");
Console.WriteLine(res.Data!.Gender ?? "unknown");
Console.WriteLine(res.Meta!.Usage!.ChargedCredits);
```

## V1 entegrasyonunu 1.x sürümünde tutun

1.x sürümü paketler mevcut V1 entegrasyonları için kullanılabilir olmaya devam eder ve kullanımdan kaldırılmamıştır. Bir güncellemenin 2.x sürümünü kurmaması için ana sürümü sabitleyin, ardından her entegrasyonu hazır olduğunuzda taşıyın.

| Dil | 1.x kurulumu |
| --- | --- |
| Python | `pip install "genderapi<2"` |
| JavaScript / TypeScript | `npm install genderapi@1` |
| PHP | `composer require "genderapi/genderapi:^1.0"` |
| Ruby | `gem install genderapi -v "~> 1.0"` |
| Java | `implementation 'com.github.GenderAPI:genderapi-java:v1.0.3'` |
| R | `remotes::install_version("genderapi", "1.0.3")` |

- [V1’den geçiş](https://www.genderapi.io/tr/docs/v2/migration)
- [1.x sürümü istemci kütüphaneleri](https://www.genderapi.io/tr/docs-client-libraries)

## Kaynak kod ve sorun bildirimleri

Her SDK açık kaynaklıdır. Hata bildirmek veya özellik istemek için ilgili GitHub deposunu kullanın.

- [GitHub’daki Python SDK'sı](https://github.com/GenderAPI/genderapi-python)
- [GitHub’daki JavaScript SDK'sı](https://github.com/GenderAPI/genderapi-js)
- [GitHub’daki PHP SDK'sı](https://github.com/GenderAPI/genderapi-php)
- [GitHub’daki Ruby SDK'sı](https://github.com/GenderAPI/genderapi-ruby)
- [GitHub’daki Java SDK'sı](https://github.com/GenderAPI/genderapi-java)
- [GitHub’daki R SDK'sı](https://github.com/GenderAPI/genderapi-R)
- [GitHub’daki C# SDK'sı](https://github.com/GenderAPI/genderapi-C)