URL Base
https://api.neuracall.com
Autenticación
Todos los endpoints (excepto /v1/auth) requieren un token Bearer en el header Authorization:
Authorization: Bearer <access_token>
Ver guía de autenticación
Aprende como obtener y usar tokens de acceso
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "PROCESS_COMPLETED",
"score_percentage": 85.0,
...
}
Paginación
Los endpoints de listado soportan paginación:
| Parametro | Tipo | Default | Descripción |
|---|
page | integer | 0 | Número de pagina (0-indexed) |
size | integer | 20 | Items por pagina (max 100) |
{
"content": [...],
"page": 0,
"size": 20,
"content_length": 20,
"total_elements": 150,
"total_pages": 8
}
| Formato | Extension | MIME Type |
|---|
| MP3 | .mp3 | audio/mpeg |
| WAV | .wav | audio/wav |
| M4A | .m4a | audio/mp4 |
| FLAC | .flac | audio/flac |
| OGG | .ogg | audio/ogg |
| WEBM | .webm | audio/webm |
Manejo de Errores
Los errores retornan un código HTTP 4xx o 5xx con el siguiente formato:
{
"code": "001-001-0001",
"path": "body.external_id",
"message": "The field external_id is required"
}
Códigos HTTP
| Código | Descripción |
|---|
| 400 | Bad Request - Datos de solicitud invalidos |
| 401 | Unauthorized - Token invalido o expirado |
| 403 | Forbidden - Sin permisos para esta operación |
| 404 | Not Found - Recurso no encontrado |
| 422 | Validation Error - Error de validación de datos |
| 500 | Internal Server Error - Error del servidor |
Rate Limiting
La API tiene límites de tasa para garantizar disponibilidad. Si excedes el limite, recibiras un error 429.
Contacta a soporte si necesitas límites más altos para tu caso de uso.
Versionado
La API actual es v1. Todos los endpoints incluyen el prefijo /v1/ en la ruta.
SDKs y Ejemplos
Grupos de Endpoints
