Límites del sistema
Tabla completa de todos los límites de tamaño, cantidad y frecuencia que aplican a la API de integración.
Autenticación
| Límite | Valor | Descripción |
|---|---|---|
| Expiración del token JWT | 1 hora | Tras expirar, obtener nuevo con POST /auth o renovar con POST /auth/refresh |
| Longitud API Key | Sin límite específico | La API Key puede contener caracteres especiales |
Paginación
| Límite | Valor | Descripción |
|---|---|---|
| Página base | 0 | La primera página es la 0 |
| Registros por página (default) | 20 | Si no se especifica size |
| Registros por página (máximo) | 100 | Valor máximo del parámetro size |
Publicidad activa
| Límite | Valor | Descripción |
|---|---|---|
| Ítems por petición bulk | 500 | Máximo en PUT /declaraciones/{id}/pa |
| Ítems mínimo bulk | 1 | Al menos un ítem |
| Enlaces por obligación | 10 | Máximo URLs por obligación |
| Longitud URL | 2.048 caracteres | Por enlace |
| Orden de enlace | 0-99 | Rango permitido |
| Longitud aclaraciones | 5.000 caracteres | Texto de aclaraciones |
| Criterios autoevaluación | 10 | Por obligación |
| Valor autoevaluación | 0-100 | Rango permitido |
| Opciones de publicación | 0-3 | Rango permitido |
Cuestionarios
| Límite | Valor | Descripción |
|---|---|---|
| Grupos por petición | 100 | Máximo en PUT /cuestionarios/{id} |
| Preguntas totales por petición | 500 | Sumando todas las preguntas de todos los grupos |
| Componentes por pregunta | Al menos 1 | Respuesta no puede estar vacía |
| Longitud texto/memo | 10.000 caracteres | Por componente de tipo texto o memo |
Derecho de acceso
| Límite | Valor | Descripción |
|---|---|---|
| Ítems por petición | 2.000 | Máximo en PUT /derecho-acceso |
| Valor por ítem | 0 - 999.999 | Rango permitido |
| Longitud URL formulario | 750 caracteres | En datos generales |
| Plazo medio días | 0 - 9.999 | Rango permitido |
| Longitud aclaraciones | 5.000 caracteres | En datos generales |
Incidencias
| Límite | Valor | Descripción |
|---|---|---|
| Longitud título | 500 caracteres | Obligatorio |
| Longitud descripción | 10.000 caracteres | Obligatorio |
| Longitud comentario | 10.000 caracteres | Obligatorio |
| Tipo de incidencia | 0-3 | Rango permitido |
Webhooks
| Límite | Valor | Descripción |
|---|---|---|
| Webhooks por entidad | 5 | Máximo registros activos |
| Longitud URL | 2.000 caracteres | |
| Longitud secreto | 512 caracteres | Para firma HMAC-SHA256 |
| Eventos mínimos | 1 | Al menos un evento al registrar |
| Eventos totales disponibles | 11 | Ver lista de eventos |
| Protocolo URL | Solo HTTPS | HTTP no aceptado |
Resumen visual
graph TD
A["Límites principales"] --> B["PA: 500 ítems bulk, 10 enlaces"]
A --> C["Cuestionarios: 100 grupos, 500 preguntas"]
A --> D["DA: 2.000 ítems"]
A --> E["Webhooks: 5 por entidad"]
A --> F["Token: 1 hora"]
A --> G["Paginación: 100 por página"]Lotes para operaciones grandes
Si necesita enviar más ítems de los permitidos por petición, divida la operación en lotes:
- PA: Lotes de 500 ítems máximo
- DA: Lotes de 2.000 ítems máximo
- Cuestionarios: 500 preguntas máximo (raramente se alcanza)
Límites de validación vs. límites técnicos
Los límites listados son límites de validación que la API impone activamente. Además, existen límites técnicos del servidor (tamaño máximo de request, timeout de conexión, etc.) que no se listan aquí pero que podrían afectar a peticiones muy grandes.
Rendimiento
Para operaciones con muchos ítems (especialmente DA con >1.000 ítems), las peticiones pueden tardar varios segundos. El token JWT se valida al inicio de la petición, no durante la ejecución, así que no expirará a mitad de una operación larga.