POST /api/v1/analyze HTTP/1.1
Host: legalcookies.es
Content-Type: application/json
X-Api-Key: lc_pk_xxxxxxxxxxxxxxxxxxxx
X-Timestamp: 1705500000000
X-Signature: abc123...

{
  "url": "https://example.com"
}

{
  "success": true,
  "data": {
    "reportId": "abc123def456",
    "hash": "sha256_del_reporte",
    "score": 75,
    "zone": "yellow",
    "verdict": "Cumplimiento parcial",
    "verdictReason": "Se detectaron 3 cookies que requieren consentimiento antes de la interacción del usuario",
    "summary": "El sitio presenta un nivel de cumplimiento parcial. Se detectó un CMP (Cookiebot) pero algunas cookies se instalan antes del consentimiento.",
    "recommendations": [
      "Configurar el CMP para bloquear cookies hasta obtener consentimiento",
      "Revisar las cookies de terceros identificadas como problemáticas",
      "Actualizar la política de cookies con información detallada"
    ],
    "stats": {
      "totalCookies": 15,
      "problematicCookies": 3,
      "exemptCookies": 5,
      "totalStorageItems": 2,
      "totalThirdPartyRequests": 8,
      "cmpDetected": "Cookiebot",
      "analysisDurationMs": 4500
    }
  }
}

X-RateLimit-Limit-Minute: 3
X-RateLimit-Limit-Hour: 20
X-RateLimit-Limit-Day: 100
X-RateLimit-Limit-Total: 1000
X-RateLimit-Remaining-Minute: 2
X-RateLimit-Remaining-Hour: 19
X-RateLimit-Remaining-Day: 99
X-RateLimit-Remaining-Total: 999

{
  "success": false,
  "error": "Invalid request body",
  "code": "INVALID_BODY",
  "details": [
    {
      "code": "invalid_string",
      "message": "URL inválida",
      "path": ["url"]
    }
  ]
}

{
  "success": false,
  "error": "Invalid signature",
  "code": "INVALID_SIGNATURE"
}

{
  "success": false,
  "error": "Daily limit exceeded",
  "code": "LIMIT_EXCEEDED_DAILY",
  "retryAfter": 3600
}

{
  "success": false,
  "error": "Analysis failed",
  "code": "ANALYSIS_ERROR"
}