API-DOKUMENTATION

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Registrera dig (v2)
PURPOSE: Skapa ett gratis konto och få ett inloggningslösenord och en API-token. Ingen autentisering krävs.

--- 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: E-postadressen du registrerar dig med. Inget för- eller efternamn krävs.

Parameter: accept_terms
  Type: bool
  Required: REQUIRED
  Description: Måste vara sant. Användaren måste godkänna Allmänna villkor och integritetspolicyn.

Parameter: newsletter
  Type: bool
  Required: OPTIONAL
  Description: Prenumerera på nyhetsbrevet. Standard är falskt.

Parameter: locale
  Type: string
  Required: OPTIONAL
  Description: Kontospråk. Ett av en, de, es. Standard är en.

--- REQUEST EXAMPLES ---

Example 1: Registrera dig med en e-postadress
Request Body (JSON):
{
    "email": "user@example.com",
    "accept_terms": true
}

Example 2: Registrera dig och prenumerera på nyhetsbrevet
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: Den registrerade e-postadressen.

Field: password
  Type: string
  Description: Ett slumpmässigt inloggningslösenord för webbkontrollpanelen. Det visas bara en gång – spara det säkert. Användaren kan återställa det senare via flödet för ”glömt lösenord”.

Field: api_token
  Type: string
  Description: API-bärartoken. Använd den som "Authorization: Bearer " för /v2/...-förfrågningar. Den börjar fungera så fort användaren har bekräftat sin e-postadress.

Field: free_requests_per_month
  Type: int
  Description: Antalet kostnadsfria förfrågningar du får per månad.

Field: status
  Type: string
  Description: Kontostatusen. "awaiting_activation" tills e-postadressen har bekräftats.

Field: message
  Type: string
  Description: Mänskligt begriplig vägledning om nästa steg (bekräfta e-postadressen).

Field: docs_url
  Type: string
  Description: Länk till de promptklara AI-implementeringsinstruktionerna (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 ===