API DOKÜMANTASYONU

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: İlk İsimle Sorgula (v2)
PURPOSE: İlk adlardan cinsiyeti belirle, isteğe bağlı ülke yerelleştirmesiyle doğruluğu artır.

--- API DETAILS ---
Method: POST
URL: https://gender-api.com/v2/gender

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <Yetkilendirme belirteciniz> 
link

--- REQUEST PARAMETERS ---

Parameter: first_name
  Type: string
  Required: REQUIRED
  Description: Sorgulamak için isim

Parameter: country
  Type: string
  Required: OPTIONAL
  Description: ISO 3166 ALPHA-2 Ülke Kodu link

Parameter: locale
  Type: string
  Required: OPTIONAL
  Description: Tarayıcı Dil Ayarı

Parameter: ip
  Type: string
  Required: OPTIONAL
  Description: Geçerli IPv4 veya IPv6 adresi

Parameter: id
  Type: string
  Required: OPTIONAL
  Description: Maksimum 50 karakter. Bu kimliği herhangi bir alfanumerik değere ayarlayabilirsiniz.
            Örnek olarak, kimliği veritabanınızdaki veri kümesinin iç kimliği olarak ayarlayabilirsiniz. Asenkron bir ortamda, bu size önceki bir isteği yanıta daha iyi bağlamanıza yardımcı olabilir

--- REQUEST EXAMPLES ---

Example 1: Sadece ad ile sorgu yapma
Request Body (JSON):
{
    "first_name": "Sandra"
}

Example 2: Ad ve ülke kodu ile sorgu yapma
Request Body (JSON):
{
    "first_name": "Sandra",
    "country": "US"
}

Example 3: Ad ve tarayıcı yereli ile sorgu yapma
Request Body (JSON):
{
    "first_name": "Sandra",
    "locale": "en_US"
}

Example 4: Ad ve bölge belirlemek için IP adresi kullanarak sorgu yapma
Request Body (JSON):
{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}

Example 5: Birden fazla adı tek bir istekte sorgula
Request Body (JSON):
[
    {
        "first_name": "Sandra",
        "country": "US"
    },
    {
        "first_name": "Jason",
        "country": "US"
    }
]

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "gender": "female"
}

--- RESPONSE FIELDS ---

Field: input
  Type: object
  Description: Gönderilen veri yükü

Field: details.credits_used
  Type: int
  Description: Bu sorgu için kullanılan istek sayısı

Field: details.samples
  Type: int
  Description: İstediğinizle eşleşen veritabanımızdaki kayıt sayısı

Field: details.country
  Type: string
  Description: Bulduğumuz ülke

Field: details.first_name_sanitized
  Type: string
  Description: Normalizasyon işlemimizi uyguladıktan sonra isim

Field: details.duration
  Type: string
  Description: Sunucunun isteği işlemesi için gereken zaman

Field: result_found
  Type: bool
  Description: Belirtilen isim için bir cinsiyet sorgulayabildiysek doğru

Field: first_name
  Type: string
  Description: Cinsiyetlendirme için kullandığımız ilk isim

Field: probability
  Type: float
  Description: Bu (0 ile 1 arasındaki) değer, veritabanımızın güvenilirliğini belirler. 1 değeri, cinsiyet talebinize yönelik sonuçların %100 doğru olduğu anlamına gelir.

Field: gender
  Type: string
  Description: Olası değerler: erkek, kadın, bilinmiyor

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X POST \
  'https://gender-api.com/v2/gender' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <Yetkilendirme belirteciniz> link' \
  -d '{"first_name":"Sandra"}'

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Tam İsimle Sorgula (v2)
PURPOSE: Tam adları otomatik olarak parçala ve cinsiyeti tek, verimli bir API çağrısıyla belirle.

--- API DETAILS ---
Method: POST
URL: https://gender-api.com/v2/gender

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <Yetkilendirme belirteciniz> 
link

--- REQUEST PARAMETERS ---

Parameter: full_name
  Type: string
  Required: REQUIRED
  Description: Sorgulamak için isim

Parameter: country
  Type: string
  Required: OPTIONAL
  Description: ISO 3166 ALPHA-2 Ülke Kodu link

Parameter: locale
  Type: string
  Required: OPTIONAL
  Description: Tarayıcı Dil Ayarı

Parameter: ip
  Type: string
  Required: OPTIONAL
  Description: Geçerli IPv4 veya IPv6 adresi

Parameter: id
  Type: string
  Required: OPTIONAL
  Description: Maksimum 50 karakter. Bu kimliği herhangi bir alfanumerik değere ayarlayabilirsiniz.
            Örnek olarak, kimliği veritabanınızdaki veri kümesinin iç kimliği olarak ayarlayabilirsiniz. Asenkron bir ortamda, bu size önceki bir isteği yanıta daha iyi bağlamanıza yardımcı olabilir

--- REQUEST EXAMPLES ---

Example 1: Sadece tam adla sorgula
Request Body (JSON):
{
    "full_name": "Theresa Miller"
}

Example 2: Tam ad ve ülke kodu ile sorgula
Request Body (JSON):
{
    "full_name": "Theresa Miller",
    "country": "US"
}

Example 3: Tam ad ve tarayıcı dil koduyla sorgula
Request Body (JSON):
{
    "full_name": "Thomas Johnson",
    "locale": "en_US"
}

Example 4: Tam ada göre sorgula ve konumlandırma için IP adresi kullan
Request Body (JSON):
{
    "full_name": "Markus Stefan NonExistingLastName",
    "ip": "54.201.16.177"
}

Example 5: Birden fazla adı tek bir istekte sorgula
Request Body (JSON):
[
    {
        "full_name": "Theresa Miller"
    },
    {
        "full_name": "Thomas Johnson",
        "country": "US"
    }
]

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "input": {
        "full_name": "Theresa Miller"
    },
    "details": {
    "credits_used": 1,
        "duration": "33ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

--- RESPONSE FIELDS ---

Field: input
  Type: object
  Description: Gönderilen veri yükü

Field: details.credits_used
  Type: int
  Description: Bu sorgu için kullanılan istek sayısı

Field: details.samples
  Type: int
  Description: İstediğinizle eşleşen veritabanımızdaki kayıt sayısı

Field: details.country
  Type: string
  Description: Bulduğumuz ülke

Field: details.full_name_sanitized
  Type: int
  Description: Normalizasyon işlemimizi uyguladıktan sonra isim

Field: details.duration
  Type: string
  Description: Sunucunun isteği işlemesi için gereken zaman

Field: result_found
  Type: bool
  Description: Belirtilen isim için bir cinsiyet sorgulayabildiysek doğru

Field: full_name
  Type: string
  Description: Cinsiyetlendirme için kullandığımız tam isim

Field: probability
  Type: float
  Description: Bu (0 ile 1 arasındaki) değer, veritabanımızın güvenilirliğini belirler. 1 değeri, cinsiyet talebinize yönelik sonuçların %100 doğru olduğu anlamına gelir.

Field: gender
  Type: string
  Description: Olası değerler: erkek, kadın, bilinmiyor

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X POST \
  'https://gender-api.com/v2/gender' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <Yetkilendirme belirteciniz> link' \
  -d '{"full_name":"Theresa Miller"}'

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: E‑posta Adresine Göre Sorgula (v2)
PURPOSE: E‑posta adreslerinden isimleri çıkar ve gelişmiş ayrıştırma algoritmalarıyla cinsiyeti belirle.

--- API DETAILS ---
Method: POST
URL: https://gender-api.com/v2/gender

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <Yetkilendirme belirteciniz> 
link

--- REQUEST PARAMETERS ---

Parameter: email
  Type: string
  Required: REQUIRED
  Description: Sorgulanacak e-posta adresi

Parameter: country
  Type: string
  Required: OPTIONAL
  Description: ISO 3166 ALPHA-2 Ülke Kodu link

Parameter: locale
  Type: string
  Required: OPTIONAL
  Description: Tarayıcı Dil Ayarı

Parameter: ip
  Type: string
  Required: OPTIONAL
  Description: Geçerli IPv4 veya IPv6 adresi

Parameter: id
  Type: string
  Required: OPTIONAL
  Description: Maksimum 50 karakter. Bu kimliği herhangi bir alfanumerik değere ayarlayabilirsiniz.
            Örnek olarak, kimliği veritabanınızdaki veri kümesinin iç kimliği olarak ayarlayabilirsiniz. Asenkron bir ortamda, bu size önceki bir isteği yanıta daha iyi bağlamanıza yardımcı olabilir

--- REQUEST EXAMPLES ---

Example 1: Sadece e-posta adresine göre sorgula
Request Body (JSON):
{
    "email": "theresa.miller14@gmail.com"
}

Example 2: E-posta adresi ve ülke koduna göre sorgula
Request Body (JSON):
{
    "email": "thomas.clarks@hotmail.com",
    "country": "US"
}

Example 3: E-posta adresi ve tarayıcı yereli ile sorgula
Request Body (JSON):
{
    "email": "Thomas.j32@live.com",
    "locale": "en_US"
}

Example 4: E-posta adresine göre sorgula ve konumlandırmak için bir IP adresi kullanın
Request Body (JSON):
{
    "email": "thomasfromnewyork@gmail.com",
    "ip": "54.201.16.177"
}

Example 5: Birden fazla adı tek bir istekte sorgula
Request Body (JSON):
[
    {
        "email": "thomas.clarks@hotmail.com",
        "country": "US"
    },
    {
        "email": "theresa.miller14@gmail.com"
    }
]

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "input": {
        "email": "theresa.miller14@gmail.com"
    },
    "details": {
        "credits_used": 1,
        "duration": "12ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

--- RESPONSE FIELDS ---

Field: input
  Type: object
  Description: Gönderilen veri yükü

Field: details.credits_used
  Type: int
  Description: Bu sorgu için kullanılan istek sayısı

Field: details.samples
  Type: int
  Description: İstediğinizle eşleşen veritabanımızdaki kayıt sayısı

Field: details.country
  Type: string
  Description: Bulduğumuz ülke

Field: details.email_sanitized
  Type: int
  Description: Normalizasyon işlemimizi uyguladıktan sonra isim

Field: details.duration
  Type: string
  Description: Sunucunun isteği işlemesi için gereken zaman

Field: result_found
  Type: bool
  Description: Belirtilen isim için bir cinsiyet sorgulayabildiysek doğru

Field: email
  Type: string
  Description: Cinsiyetlendirme için kullandığımız e-posta adresi

Field: probability
  Type: float
  Description: Bu (0 ile 1 arasındaki) değer, veritabanımızın güvenilirliğini belirler. 1 değeri, cinsiyet talebinize yönelik sonuçların %100 doğru olduğu anlamına gelir.

Field: gender
  Type: string
  Description: Olası değerler: erkek, kadın, bilinmiyor

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X POST \
  'https://gender-api.com/v2/gender' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <Yetkilendirme belirteciniz> link' \
  -d '{"email":"theresa.miller14@gmail.com"}'

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Menşe Ülkesini Al (v2)
PURPOSE: İsimlere göre muhtemel çıkış ülkesini ve etnik kökeni keşfet.

--- API DETAILS ---
Method: POST
URL: https://gender-api.com/v2/country-of-origin

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <Yetkilendirme belirteciniz> 
link

--- REQUEST PARAMETERS ---

Parameter: first_name
  Type: string
  Required: REQUIRED
  Description: Sorgulamak için ilk isim

Parameter: full_name
  Type: string
  Required: OPTIONAL
  Description: İlk isim alanı yerine sağlanabilir tam ad

Parameter: email
  Type: string
  Required: OPTIONAL
  Description: İlk isim alanı yerine sağlanabilir e-posta adresi

Parameter: id
  Type: string
  Required: OPTIONAL
  Description: Maksimum 50 karakter. Bu kimliği herhangi bir alfanumerik değere ayarlayabilirsiniz.
            Örnek olarak, kimliği veritabanınızdaki veri kümesinin iç kimliği olarak ayarlayabilirsiniz. Asenkron bir ortamda, bu size önceki bir isteği yanıta daha iyi bağlamanıza yardımcı olabilir

--- REQUEST EXAMPLES ---

Example 1: İsimle sorgulama yapın
Request Body (JSON):
{
    "first_name": "Johann"
}

Example 2: Tam isme göre sorgu
Request Body (JSON):
{
    "full_name": "Theresa Miller"
}

Example 3: E-posta adresine göre sorgula
Request Body (JSON):
{
    "full_name": "sophia5342@gmail.com"
}

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "input": {
        "first_name": "Johann",
        "id": 12
    },
    "details": {
        "credits_used": 2,
        "duration": "414ms",
        "samples": 890,
        "country": null,
        "first_name_sanitized": "johann"
    },
    "result_found": true,
    "country_of_origin": [
        {
            "country_name": "Germany",
            "country": "DE",
            "probability": 0.52,
            "continental_region": "Europe",
            "statistical_region": "Western Europe"
        },
        {
            "country_name": "Austria",
            "country": "AT",
            "probability": 0.48,
            "continental_region": "Europe",
            "statistical_region": "Western Europe"
        }
    ],
    "first_name": "Johann",
    "probability": 0.9,
    "gender": "male",
    "language_of_origin": "Germanic",
    "meaning": "Johann is the German variation of the name John, which means 'God is gracious'. It was frequently used in the Middle Ages across Europe, particularly as a name for religious figures.",
    "ethnicity": {
        "id": "GERMANIC",
        "name": "Germanic (German, Austrian, Swiss)",
        "distribution": [
            {
                "id": "GERMANIC",
                "name": "Germanic (German, Austrian, Swiss)",
                "percentage": 90
            },
            {
                "id": "DUTCH",
                "name": "Dutch",
                "percentage": 5
            },
            {
                "id": "FRENCH",
                "name": "French",
                "percentage": 5
            }
        ]
    }
 }

--- RESPONSE FIELDS ---

Field: input
  Type: object
  Description: Gönderilen veri yükü

Field: details.credits_used
  Type: int
  Description: Bu sorgu için kullanılan istek sayısı

Field: details.samples
  Type: int
  Description: İstediğinizle eşleşen veritabanımızdaki kayıt sayısı

Field: details.country
  Type: string
  Description: Bulduğumuz ülke

Field: details.first_name_sanitized
  Type: string
  Description: Normalizasyon işlemimizi uyguladıktan sonra isim

Field: details.duration
  Type: string
  Description: Sunucunun isteği işlemesi için gereken zaman

Field: result_found
  Type: bool
  Description: Belirtilen isim için bir cinsiyet sorgulayabildiysek doğru

Field: country_of_origin_map_url
  Type: string
  Description: Bu isim hakkında interaktif bir harita için URL

Field: first_name
  Type: string
  Description: Cinsiyetlendirme için kullandığımız ilk isim

Field: probability
  Type: float
  Description: Bu değer (0 ile 1 arasında) veritabanımızın güvenirliğini belirler. 1 değeri, cinsiyetinizle ilgili isteğinizin sonuçlarının %100 doğru olduğu anlamına gelir

Field: gender
  Type: string
  Description: Olası değerler: erkek, kadın, bilinmiyor

Field: country_of_origin
  Type: object
  Description: En büyük 25 köken ülkesi. Desteklenen ülkelerin listesi için "Complete List Of Possible Countries" kısmına bak. Her kayıtta country_name, country, probability, continental_region ve statistical_region alanları bulunur

Field: language_of_origin
  Type: string
  Description: Bu ismin köken dili

Field: meaning
  Type: string
  Description: Bu ismin anlamının kısa bir açıklaması

Field: ethnicity
  Type: object
  Description: Etnisite alanı, adla ilişkili birincil etnik grup hakkında detaylar sağlar ve adın çeşitli etnik gruplar arasında nasıl dağıldığını gösterir

Field: ethnicity.id
  Type: string
  Description: Kimlik alanı, belirlenen ana etnik grup için bir tanımlayıcı içerir. Tüm olası etnik grupların tam listesi için "Complete List Of Possible Ethnic Groups" bölümüne bakın

Field: ethnicity.name
  Type: string
  Description: İsim alanı belirlenen ana etnik grubun ismini içerir. Tüm olası etnik grupların tam listesi için "Complete List Of Possible Ethnic Groups" kısmına bak

Field: ethnicity.distribution
  Type: array
  Description: Dağılım alanı, ismin farklı etnik gruplar içerisindeki oranı hakkında bilgi içerir. Her dizi girişi, id (string), isim (string) ve yüzde (float) alanlarını içerir. Tüm olası değerlerin tam listesi için "Olası Etnik Grupların Tam Listesi"ne bakın

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X POST \
  'https://gender-api.com/v2/country-of-origin' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <Yetkilendirme belirteciniz> link' \
  -d '{"first_name":"Johann"}'

--- CREDIT USAGE ---
Required Requests: 2

=== END OF INSTRUCTIONS ===

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: İstatistikleri Al (v2)
PURPOSE: Hesabın için ayrıntılı kullanım istatistiklerini ve kalan istek kredilerini görüntüle.

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/v2/statistic

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <Yetkilendirme belirteciniz> 
link

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "is_limit_reached": false,
    "remaining_credits": 24999,
    "details": {
        "credits_used": 0,
        "duration": "83ms"
    },
    "usage_last_month": {
        "date": "2018-03",
        "credits_used": 25
    }
}

--- RESPONSE FIELDS ---

Field: is_limit_reached
  Type: bool
  Description: Talepler kalmadıysa doğru döner

Field: remaining_credits
  Type: int
  Description: Kaldırılan talep sayısı

Field: details.credits_used
  Type: int
  Description: Bu sorgu için kullanılan istek sayısı

Field: details.duration
  Type: string
  Description: Sunucunun isteği işlemesi için gereken zaman

Field: usage_last_month.date
  Type: string
  Description: Geçen ayın tarihi

Field: usage_last_month.credits_used
  Type: int
  Description: Son bir ay içinde kullandığınız talepler

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/v2/statistic' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <Yetkilendirme belirteciniz> link' \

=== END OF INSTRUCTIONS ===