API para recibir SMS de verificación

La base es https://smsnitro.com/api/v1, con respuestas en JSON y códigos HTTP estándar. La clave va en la cabecera X-Api-Key; también se acepta Authorization: Bearer seguida de la clave.

• Saldo: GET /balance devuelve el saldo disponible y el retenido en pedidos abiertos, en dólares.
• Catálogo: GET /services lista servicios con precio y tasa de entrega; GET /services/{servicio}/countries muestra cada país con su precio.
• Pedidos: POST /orders compra un número; GET /orders y GET /orders/{id} sirven para la consulta de estado y para leer el SMS.
• Acciones sobre el pedido: finish para cerrarlo, cancel para recuperar el importe antes de que llegue un SMS, resend para pedir otro código en el mismo número sin costo y ban para reportar un número ya usado.

Muchos programas de registro y bots solo saben hablar el protocolo de SMS-Activate. Para ellos existe el endpoint https://smsnitro.com/api/stubs/handler_api.php, que acepta GET o POST con los parámetros api_key y action y siempre responde con HTTP 200, así que el cliente debe leer el cuerpo de la respuesta.

Acciones disponibles: getBalance, getNumber, getStatus, setStatus, getPrices, getNumbersStatus, getServicesList y getCountries. Los importes vienen en dólares, la moneda de la cuenta. Ojo con un detalle: country=0 o vacío apunta a Estados Unidos, no a Rusia como en el protocolo original.

Hay paquetes oficiales: pip install smsnitro para Python y npm i smsnitro para Node.js o TypeScript. Ambos traen una función que espera el código con tiempo límite y excepciones claras cuando el pedido termina sin SMS. La colección de Postman incluye todas las llamadas y también se importa en Insomnia o Bruno.

• Los precios de la API son los mismos del panel, sin recargo por usarla.
• El precio queda fijo al comprar y solo se cobra si llega el SMS; si no llega, se devuelve automáticamente.
• En algunos números la cancelación se habilita unos 2 minutos después de la compra.
• Hay un límite de solicitudes por minuto en la compra y en el reenvío de SMS; los SDKs consultan el estado cada 4 segundos, un ritmo razonable para tu propio código.
• Cada cuenta tiene una sola clave activa. Generar una nueva desde el panel revoca la anterior al instante.