Autenticación

La API Annie Insights utiliza autenticación de clave API a través del encabezado HTTP x-api-key.

Cómo funciona

Incluya su clave API en cada solicitud como encabezado HTTP:

x-api-key: YOUR_API_KEY

Ejemplo

curl -X POST \
  https://api.annie-insights.com/api/v2/clinical-images \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"PatientID": "P-001", "TimeStamp": "2026-05-24", "ImageName": "https://..."}'

Obtener una clave API

Tipo	Cómo llegar	Caso de uso
Clave de zona de pruebas	Disponible en la página Sandbox	Pruebas y desarrollo
Clave de producción	Contacto [api-support@hcds.ai](correo a:api-support@hcds.ai)	Integración productiva

Mejores prácticas de seguridad

aviso

Nunca exponga su clave API en el código del lado del cliente. Realice siempre llamadas API desde su servidor backend.

• Almacene las claves de forma segura: use variables de entorno o un administrador de secretos
• Rote las claves periódicamente: solicite una nueva clave si sospecha que está comprometida
• Utilice solo HTTPS: todos los puntos finales de API requieren cifrado TLS
• Monitorear el uso: realice un seguimiento del recuento de solicitudes mediante encabezados de respuesta

Respuestas de error

Si la autenticación falla, la API devuelve:

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "statusCode": 401
}

Consulte Error Handling para conocer todos los códigos de error.