Solución de problemas

Causas

• Formato JSON inválido
• Campos obligatorios faltantes
• URL del endpoint no coincide

Soluciones

• Valida el formato JSON
• Verifica los campos obligatorios en la documentación de la API
• Verifica la URL del endpoint

Causas

• Encabezado Authorization faltante o vacío
• Formato de clave API inválido (debe ser tm_test_xxx... o tm_live_xxx...)
• Clave API incorrecta para este endpoint
• La clave API ha sido desactivada por el propietario del endpoint

Soluciones

• Incluye el encabezado Authorization (ej., Bearer tm_test_xxx...)
• Usa tm_test_xxx... para Sandbox, tm_live_xxx... para Producción
• Regenera la clave si es necesario
• Contacta al propietario del endpoint para reactivar tu clave API

Causas

• El endpoint está desactivado
• Suscripción expirada o cuota mensual excedida
• Producción no desplegada (se usó clave tm_live_)

Soluciones

• Verifica que el endpoint esté activo
• Verifica el estado de la suscripción
• Despliega a Producción si usas clave tm_live_

Causas

• El cuerpo de la solicitud excede el límite de 100KB
• Arrays anidados o cadenas grandes en la carga útil JSON

Soluciones

• Reduce el tamaño de la carga útil eliminando o recortando campos grandes
• Divide en múltiples solicitudes más pequeñas si los datos son genuinamente grandes
• Contacta a support@3minapi.com si 100KB es insuficiente para tu caso de uso

Causas

• Encabezado Content-Type faltante o incorrecto
• Content-Type debe ser application/json

Soluciones

• Agrega el encabezado: Content-Type: application/json

Causas

• Límite de solicitudes mensuales excedido

Soluciones

• Mejora tu plan o espera al reinicio mensual
• Monitorea el uso en el panel

Incluye 500 (Error interno del servidor), 502 (Bad Gateway), 503 (Servicio no disponible), etc.

Causas

• Problema temporal del servidor
• Servicio ascendente (base de datos) temporalmente no disponible
• Servicio temporalmente sobrecargado o en mantenimiento

Soluciones

• Implementa reintentos con retroceso exponencial (ej., 1s → 2s → 4s, máx. 3 intentos)
• Verifica el estado del servicio si los errores persisten
• Contacta soporte si el problema persiste: contact@3minapi.com
• Nota: 5xx significa que la solicitud no fue recibida. Una vez que obtienes 202 Accepted, el procesamiento de datos está garantizado.

• Verifica que la URL del webhook sea correcta
• Usa URL HTTP o HTTPS
• El endpoint debe ser accesible públicamente
• Verifica el estado del webhook en los registros

• Devuelve código de estado 2xx para éxito
• Responde dentro de 7 segundos
• El sistema reintenta hasta 3 veces automáticamente
• Los reintentos de webhook pueden retrasar el procesamiento de datos