Codigos de error, estados y limites

Formato de respuesta estandar

Todas las respuestas de la API de WhatsBoost siguen un formato JSON consistente con tres campos:

{
  "status": 200,
  "message": "Mensaje descriptivo o false",
  "data": "Datos de respuesta o false"
}

{
  "status": 200,
  "message": "Message has been sent!",
  "data": 15234
}

{
  "status": 401,
  "message": "Invalid API secret supplied!",
  "data": false
}

Codigos HTTP y mensajes de error

A continuacion se detalla cada codigo de estado HTTP que puede devolver la API, junto con todos los mensajes de error posibles y las acciones recomendadas para resolverlos.

200 OK - Operacion exitosa

301 Esperando informacion

400 Bad Request - Parametros incorrectos

401 Unauthorized - API Key invalida

403 Forbidden - Sin permisos o limites alcanzados

404 Not Found - Recurso no encontrado

500 Server Error - Error interno

503 Service Unavailable

Estados de mensaje

Cada mensaje enviado a traves de la API pasa por una serie de estados internos. Puedes consultar el estado actual de un mensaje en los endpoints GET /api/get/sms.sent o GET /api/get/wa.sent.

Modos de envio SMS

Al enviar un SMS, debes especificar el modo de envio con el parametro mode. Cada modo tiene parametros adicionales obligatorios.

Limites y cuotas

Cada plan de suscripcion tiene limites diarios y de recursos que se reinician automaticamente a medianoche en la zona horaria del usuario. Cuando se alcanza un limite, la API devuelve un error 403.

Limites de envio (diarios)

Limites de recursos (por cuenta)

Consultar tu cuota actual

Puedes consultar el estado actual de tu suscripcion y limites restantes con:

curl -X GET "//whatsboost.netapi/get/subscription?secret=TU_API_KEY"

Respuesta de ejemplo:

{
  "status": 200,
  "message": false,
  "data": {
    "name": "Plan Pro",
    "send_limit": 1000,
    "receive_limit": 500,
    "wa_send_limit": 5000,
    "wa_receive_limit": 2000,
    "ussd_limit": 100,
    "device_limit": 5,
    "wa_account_limit": 3,
    "webhook_limit": 10,
    "action_limit": 10,
    "contact_limit": 5000,
    "apikey_limit": 5,
    "scheduled_limit": 100
  }
}

Endpoints GET para consultar estado

WhatsBoost ofrece una serie de endpoints GET para consultar datos de tu cuenta. Todos requieren el parametro secret con tu API Key y soportan paginacion.

Parametros de paginacion

Endpoints disponibles

Ejemplo de consulta paginada

curl -X GET "//whatsboost.netapi/get/sms.sent?secret=TU_API_KEY&page=2&limit=25"

Guia de troubleshooting

Soluciones rapidas a los problemas mas comunes al integrar la API de WhatsBoost.

Prompt IA: Manejo de errores

Copia este prompt en tu asistente de IA para implementar un manejo de errores robusto con la API de WhatsBoost.

Eres un desarrollador experto en integraciones de APIs. Necesito implementar un manejo de errores robusto para la API de WhatsBoost.

API BASE URL: //whatsboost.netapi/

FORMATO DE RESPUESTA:
Todas las respuestas son JSON con: status (int), message (string|false), data (mixed|false).

CODIGOS DE ERROR:
- 400: Parametros incorrectos. No reintentar, corregir el request.
- 401: API Key invalida. Verificar el parametro "secret".
- 403: Sin permisos o limites alcanzados. Verificar plan y cuotas.
- 404: Recurso no encontrado (dispositivo, cuenta, pasarela).
- 500: Error del servidor. Reintentar con backoff exponencial.
- 503: Servidores a capacidad maxima. Reintentar con backoff.

ESTADOS DE MENSAJE:
1=Pendiente, 2=En proceso, 3=Enviado, 4=Fallido.

REQUISITOS:
1. Implementa una funcion wrapper que maneje todos los codigos de error.
2. Para errores 500/503, reintentar hasta 3 veces con backoff exponencial (1s, 2s, 4s).
3. Para errores 403 de limite, encolar el mensaje y reintentar despues de medianoche.
4. Logear todos los errores con timestamp, endpoint, parametros y respuesta.
5. Implementar circuit breaker: si hay 5 errores 500 consecutivos, pausar 5 minutos.

Mi stack es: [INDICA TU STACK AQUI]