API DOKÜMANTASYONU

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Kayıt Ol (v2)
PURPOSE: Ücretsiz bir hesap oluştur ve giriş şifrenle birlikte bir API token al. Kimlik doğrulama gerekmez.

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

--- AUTHENTICATION ---
Header: Content-Type: application/json

--- REQUEST PARAMETERS ---

Parameter: email
  Type: string
  Required: REQUIRED
  Description: Kayıt olmak için e-posta adresin. Ad ve soyad bilgisi gerekmez.

Parameter: accept_terms
  Type: bool
  Required: REQUIRED
  Description: Doğru olmalı. Kullanıcının Şartlar ve Koşullar ile Gizlilik Politikası’nı kabul etmesi gerekir.

Parameter: newsletter
  Type: bool
  Required: OPTIONAL
  Description: Bültene abone ol. Varsayılan olarak false.

Parameter: locale
  Type: string
  Required: OPTIONAL
  Description: Hesap dili. Şunlardan biri: en, de, es. Varsayılan: en.

--- REQUEST EXAMPLES ---

Example 1: Bir e-posta adresiyle kayıt ol
Request Body (JSON):
{
    "email": "user@example.com",
    "accept_terms": true
}

Example 2: Kaydol ve bültene abone ol
Request Body (JSON):
{
    "email": "user@example.com",
    "accept_terms": true,
    "newsletter": true,
    "locale": "en"
}

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "email": "user@example.com",
    "password": "",
    "api_token": "",
    "free_requests_per_month": 100,
    "status": "awaiting_activation",
    "message": "Account created. Ask the user to click the activation link sent to their email address. The API token below activates automatically once the email is confirmed and can then be used as a Bearer token against the API.",
    "docs_url": "https://gender-api.com/skill.md"
}

--- RESPONSE FIELDS ---

Field: email
  Type: string
  Description: Kayıtlı e-posta adresi.

Field: password
  Type: string
  Description: Web paneline giriş için rastgele oluşturulmuş bir parola. Yalnızca bir kez gösterilir; güvenli bir şekilde sakla. Kullanıcı, daha sonra “şifremi unuttum” adımlarıyla parolayı sıfırlayabilir.

Field: api_token
  Type: string
  Description: API bearer token’ı. /v2/... isteklerinde bunu `"Authorization: Bearer "` şeklinde kullan. Kullanıcı e-postasını onaylar onaylamaz çalışmaya başlar.

Field: free_requests_per_month
  Type: int
  Description: Aylık verilen ücretsiz istek sayısı.

Field: status
  Type: string
  Description: Hesabın durumu. E-posta adresi doğrulanana kadar "awaiting_activation" olarak kalır.

Field: message
  Type: string
  Description: E-posta adresini doğrulamak için sonraki adımın kolay anlaşılır yönlendirmesi.

Field: docs_url
  Type: string
  Description: Yapay zekâ uygulama talimatları (skill.md) için prompta hazır bağlantı.

--- 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/sign-up' \
  -H 'Content-Type: application/json' \
  -d '{"email":"user@example.com","accept_terms":true}'

--- CREDIT USAGE ---
Required Requests: 0

=== END OF INSTRUCTIONS ===