Detalle de Reporte
Obtiene el desglose detallado de un reporte de campaña específico
post
/reports/detailsCuerpo de la petición
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 o lógica de negocio. Códigos posibles:
details_02 (campaign_id no definido o no numérico), details_03 (la campaña no existe), details_04 (la campaña aún se está procesando).successboolean
Siempre false para respuestas de error
messagestring
Descripción del error en español
statusinteger
Código HTTP de la respuesta
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
Código HTTP
codestring
Código de error de autenticación (auth_01, auth_05, auth_06, auth_07, auth_99)
403Prohibido: La dirección IP no está autorizada para acceder (IP whitelist)
successboolean
Siempre false
messagestring
Descripción del error
statusinteger
Código HTTP
codestring
Código de error: auth_04 (IP no autorizada en whitelist)
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
Código HTTP
codestring
Código de error interno
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.