Detalle de Reporte
Obtiene el desglose detallado de un reporte de campaña específico
post
/reports/detailsCuerpo de la solicitud
application/json
campaign_idintegerrequerido
ID de la campaña
sandboxinteger
1 = consultar una campaña de envíos de prueba (sandbox)Respuesta
200Operación exitosa
successboolean
messagestring
Mensaje de estado
statusinteger
codestring
Código de respuesta
detailsobject
▸ Ver atributos hijos▾ Ocultar atributos hijos
effectivenessnumber
Porcentaje de efectividad de entrega
totalsinteger
Total de mensajes
deliveredinteger
Mensajes entregados
failedinteger
Mensajes fallidos
pendinginteger
Mensajes pendientes
not_chargedinteger
Mensajes no cobrados
400Error de validación. Código posible:
details_02 (campaign_id no definido o no numérico).successboolean
Siempre false para respuestas de error
messagestring
Descripción del error en español
statusinteger
Campo legado dentro del cuerpo. Conserva su valor histórico (normalmente 200) y NO coincide con el status HTTP real: la respuesta puede llegar con HTTP 400/402/404/409/502 mientras este campo sigue en su valor legado. Usa el status HTTP de transporte y el
code, no este campo.codestring
Código de error estructurado ({dominio}_{número}). Identifica de forma única la causa del error para manejo programático.
401No autorizado: API Key no provista, inválida o expirada
successboolean
Siempre false
messagestring
Descripción del error de autenticación en español
statusinteger
Campo legado en el cuerpo. Es el status HTTP de transporte; para autenticación coincide con el status real (401). Usa el status HTTP y el code, no este campo.
codestring
Código de error de autenticación (auth_01, auth_03, auth_05)
403Prohibido: La dirección IP no está autorizada para acceder (IP whitelist)
successboolean
Siempre false
messagestring
Descripción del error
statusinteger
Campo legado en el cuerpo. Puede NO coincidir con el status HTTP real: para auth_06 y auth_07 este campo vale 401 (valor histórico congelado) mientras el status HTTP de transporte es 403. Usa el status HTTP y el code, no este campo.
codestring
Código de error: auth_04 (IP no autorizada), auth_06 (cuenta deshabilitada), auth_07 (admin inválido)
404La campaña no existe (
code: details_03). Con el opt-out X-Api-Http-Semantics: 0 el status es 200.successboolean
Siempre false para respuestas de error
messagestring
Descripción del error en español
statusinteger
Campo legado dentro del cuerpo. Conserva su valor histórico (normalmente 200) y NO coincide con el status HTTP real: la respuesta puede llegar con HTTP 400/402/404/409/502 mientras este campo sigue en su valor legado. Usa el status HTTP de transporte y el
code, no este campo.codestring
Código de error estructurado ({dominio}_{número}). Identifica de forma única la causa del error para manejo programático.
409La campaña aún se está procesando y todavía no es consultable (
code: details_04). Con el opt-out X-Api-Http-Semantics: 0 el status es 200.successboolean
Siempre false para respuestas de error
messagestring
Descripción del error en español
statusinteger
Campo legado dentro del cuerpo. Conserva su valor histórico (normalmente 200) y NO coincide con el status HTTP real: la respuesta puede llegar con HTTP 400/402/404/409/502 mientras este campo sigue en su valor legado. Usa el status HTTP de transporte y el
code, no este campo.codestring
Código de error estructurado ({dominio}_{número}). Identifica de forma única la causa del error para manejo programático.
429Demasiadas peticiones: Límite de rate limit excedido (100 mensajes/segundo producción, 1000 envíos de prueba por día en sandbox)
successboolean
Siempre false
messagestring
Descripción del error
statusinteger
Código HTTP
codestring
Código de error de rate limit
500Error interno del servidor
successboolean
Siempre false
messagestring
Descripción del error
statusinteger
Campo legado dentro del cuerpo. Conserva su valor histórico (p.ej. 200 o 401 según el endpoint) y NO coincide con el status HTTP real (500). Usa el status HTTP de transporte y el
code, no este campo.codestring
Código de error interno (p.ej. server_01, o auth_99 en un error interno de autenticación)
request_idstring· uuid
Identificador único de la petición. Inclúyelo al contactar a soporte.
Además de los errores globales de autenticación (auth_*, ver Errores y límites), este endpoint puede responder:
Códigos de error
| Código | Cuándo ocurre | Qué hacer |
|---|---|---|
details_02 | campaign_id ausente o no numérico. | Envía el identificador numérico de la campaña. |
details_03 | La campaña no existe o no pertenece a tu cuenta. | Verifica el campaign_id con /campaigns. |
details_04 | La campaña aún se está procesando. | Espera a que termine y reintenta. |
El éxito responde details_01 con efectividad y totales por estado.