DOCUMENTACIÓN DE LA API

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Regístrate (v2)
PURPOSE: Crea una cuenta gratis y recibe una contraseña de acceso y un token de API. No se requiere autenticación.

--- 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: La dirección de correo electrónico con la que te registrarás. No hace falta indicar nombre ni apellido.

Parameter: accept_terms
  Type: bool
  Required: REQUIRED
  Description: Debe ser true. El usuario debe aceptar los Términos y Condiciones y la Política de Privacidad.

Parameter: newsletter
  Type: bool
  Required: OPTIONAL
  Description: Suscríbete al boletín. Por defecto es false.

Parameter: locale
  Type: string
  Required: OPTIONAL
  Description: Idioma de la cuenta. Uno de en, de, es. El valor predeterminado es en.

--- REQUEST EXAMPLES ---

Example 1: Regístrate con una dirección de correo electrónico
Request Body (JSON):
{
    "email": "user@example.com",
    "accept_terms": true
}

Example 2: Regístrate y suscríbete al boletín informativo
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: La dirección de correo electrónico registrada.

Field: password
  Type: string
  Description: Una contraseña de inicio de sesión aleatoria para el panel web. Solo se devuelve una vez; guárdala de forma segura. Más adelante, el usuario puede restablecerla mediante el flujo de recuperación de contraseña.

Field: api_token
  Type: string
  Description: El token *bearer* de la API. Úsalo como "Authorization: Bearer " para las solicitudes a /v2/.... Empieza a funcionar cuando el usuario confirma su email.

Field: free_requests_per_month
  Type: int
  Description: El número de solicitudes gratuitas que se conceden al mes.

Field: status
  Type: string
  Description: El estado de la cuenta. "awaiting_activation" hasta que se confirme la dirección de correo electrónico.

Field: message
  Type: string
  Description: Guía fácil de entender sobre el siguiente paso (confirmar la dirección de correo electrónico).

Field: docs_url
  Type: string
  Description: Enlace a las instrucciones de implementación listas para usar con IA (skill.md).

--- 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 ===