ΤΕΚΜΗΡΙΩΣΗ API

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Λήψη στατιστικών (v2)
PURPOSE: Ανάκτησε αναλυτικά στατιστικά χρήσης και τα υπόλοιπα credits αιτημάτων για τον λογαριασμό σου.

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

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <το token εξουσιοδότησής σου> 
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: Επιστρέφει true αν δεν υπάρχουν άλλα διαθέσιμα αιτήματα

Field: remaining_credits
  Type: int
  Description: Αριθμός διαθέσιμων αιτημάτων

Field: details.credits_used
  Type: int
  Description: Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

Field: details.duration
  Type: string
  Description: Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

Field: usage_last_month.date
  Type: string
  Description: Ημερομηνία του προηγούμενου μήνα

Field: usage_last_month.credits_used
  Type: int
  Description: Αιτήματα που έχεις χρησιμοποιήσει τον τελευταίο μήνα

--- 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 <το token εξουσιοδότησής σου> link' \

=== END OF INSTRUCTIONS ===