Errores y límites
Gestiona errores, espera y solicitudes inciertas.
La tabla de cada método es la referencia. Un estado HTTP puede tener distintos significados según el método; no sustituyas los códigos de esta API por interpretaciones HTTP convencionales. Conserva statusCode, error.type y error.description.
La espera no es un fallo final
Receive SMS devuelve 202 / SMS_NOT_YET_RECEIVED con el objeto error de forma intencionada. Trátalo antes de los errores generales y repite la consulta dentro del plazo del pedido.
Límites y fallos de conexión
Respeta los errores de límite documentados por método, como ACCESS_LIMITED. Consulta los límites y errores del método que estés usando. Un timeout o respuesta no JSON no equivale a un error API confirmado. Los ejemplos no reintentan automáticamente. Revisa los pedidos antes de repetir una solicitud de número incierta.
Índice de respuestas
Un guion indica que la fuente no incluye un ejemplo estructurado del tipo de error. Se conservan las diferencias entre métodos.
| HTTP | error.type | Descripción | Métodos |
|---|---|---|---|
| 400 | APIKEY_NOT_SET | Falta la cabecera apikey, está vacía o su longitud no es válida. | Consultar saldo, Información de usuario |
| 400 | APIKEY_NOT_SET | No se ha recibido la clave API. | Operadores, Tasas de conversión, Precios por país y operador |
| 400 | APIKEY_NOT_SET | Falta la cabecera apikey, está vacía o tiene menos de 30 caracteres. | Configuración de mensajes |
| 401 | USER_NOT_FOUND | No se encontró una cuenta para esa clave API. | Configuración de mensajes |
| 402 | RATELIMIT_EXCEED | Se ha superado el límite de solicitudes. Esta API devuelve HTTP 402 para este error. | Configuración de mensajes |
| 403 | USER_BANNED | La cuenta está bloqueada. | Configuración de mensajes |
| 500 | SERVER_ERROR | Error interno. Si los detalles están habilitados, la descripción puede incluir la excepción. | Configuración de mensajes |
| 402 | RATELIMIT_EXCEED | Se ha superado el límite de solicitudes. | Disponibilidad de todos los números |
| 405 | INVALID_PARAMS | country o service no es válido. | Precio del servicio |
| 405 | INVALID_PARAMS | Parámetros no válidos | Precios del servicio por país, Obtener número, Obtener número por operador, Recibir SMS, Borrar SMS, Detener SMS, Cancelar pedido |
| 407 | LOW_BALANCE | El saldo no alcanza para recibir SMS del país y servicio elegidos. | Obtener número |
| 411 | ACCESS_LIMITED | Acceso limitado por karma bajo o exceso de solicitudes. | Obtener número, Recibir SMS, Detener SMS, Cancelar pedido, Bloquear número |
| 500 | NUMBER_FETCH_FAIL | No se pudo obtener el número. | Obtener número |
| 501 | PRICE_FETCH_FAIL | No se encontró el número. | Obtener número |
| 502 | NUMBER_NOT_FOUND | No se encontró el número. | Obtener número |
| 503 | SERVER_BUSY | El servidor está sobrecargado. Inténtalo más tarde. | Obtener número |
| 407 | — | El saldo no alcanza para recibir SMS del país y servicio elegidos. | Obtener número por operador |
| 411 | — | Acceso limitado por karma bajo o exceso de solicitudes. | Obtener número por operador |
| 500 | — | No se pudo obtener el número. | Obtener número por operador |
| 501 | — | No se encontró el número. | Obtener número por operador |
| 502 | — | No se encontró el número. | Obtener número por operador, Estado del número |
| 503 | — | El servidor está sobrecargado. Inténtalo más tarde. | Obtener número por operador |
| 406 | INVALID_ORDER_FORMAT | El ID del pedido no es válido o no se encontró. | Recibir SMS |
| 407 | LOW_BALANCE | Se ha recibido el SMS, pero el saldo no alcanza para pagarlo. | Recibir SMS |
| 410 | ORDER_CLOSED | El pedido está cerrado y ya no está disponible. | Recibir SMS |
| 500 | SMS_FETCH_FAIL | No se pudo obtener el SMS. | Recibir SMS |
| 501 | SERVER_FAIL | El servidor no pudo procesar la solicitud. | Recibir SMS, Pedidos actuales, Borrar SMS, Detener SMS, Bloquear número |
| 503 | SERVER_BUSY | El servidor está sobrecargado. Inténtalo más tarde. | Recibir SMS, Pedidos actuales, Detener SMS, Cancelar pedido, Bloquear número |
| 405 | INVALID_NUMBER_FORMAT | Formato de número no válido | Estado del número |
| 406 | ORDER_NOT_FOUND | El ID del pedido no es válido o no se encontró. | Estado del número, Detener SMS, Cancelar pedido, Bloquear número |
| 500 | SERVER_ERROR | Error interno. La descripción puede incluir información de diagnóstico. | Estado del número |
| 501 | — | El servidor no pudo procesar la solicitud. | Estado del número |
| 503 | — | El servidor está sobrecargado. Inténtalo más tarde. | Estado del número |
| 504 | — | av2.resp.504.desc: la fuente no incluye una descripción desarrollada para esta respuesta. | Estado del número |
| 404 | NO_SMS_TO_CLEAN | No se ha recibido un SMS, o hay uno pendiente de pago. | Borrar SMS |
| 406 | ORDER_NOT_FOUND | No se encontró el pedido. | Borrar SMS |
| 503 | SERVER_BUSY | No se ha recibido un SMS, o hay uno pendiente de pago. | Borrar SMS |
| 501 | SERVER_BUSY | El servidor no pudo procesar la solicitud. | Cancelar pedido |
| 405 | INVALID_PARAMS | Formato de número no válido | Bloquear número |