API de verificación SMS

Compra de números, consulta de códigos y cancelación con una sola solicitud HTTP. Usa el formato handler_api, muy extendido en el sector de números virtuales, así que basta con poner la dirección y la clave en tu programa de registro o bot.

Obtener clave API

Tras iniciar sesión, crea la clave en el menú API de la pantalla de la cuenta. La clave se muestra una sola vez al crearla, así que guárdala de inmediato. La API usa el mismo saldo y los mismos precios que la web.

Dirección base

https://010sms.com/stubs/handler_api.php?api_key=API_KEY&action=...

Solicitudes principales

actionQué hacemosEjemplo de respuesta
getBalanceConsultar saldoACCESS_BALANCE:12.50
getPrices&service=telegram&country=krPrecios y números disponibles por servicio{"kr":{"telegram":{"cost":3.2,"count":7922}}}
getNumber&service=telegram&country=krComprar númeroACCESS_NUMBER:ID:PHONE
getStatus&id=IDConsultar códigoSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Cancelar número (antes del código, reembolso total)ACCESS_CANCEL
setStatus&id=ID&status=3Recibir otro código en el mismo númeroACCESS_RETRY_GET
setStatus&id=ID&status=6Finalizar usoACCESS_ACTIVATION

Parámetros

NombreObligatorioDescripción
api_keyTodosClave API creada en la pantalla de la cuenta
actionTodosgetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberCódigo del servicio (ej.: telegram, whatsapp, google). Es igual a la dirección de la página en la lista de servicios
countrygetNumberkr (número coreano 010; si lo omites, se usa kr)
idgetStatus, setStatusID del número devuelto por getNumber (empieza por N-)
statussetStatus8 cancelar, 3 pedir otro código, 6 finalizar, 1 listo

Texto de respuesta y significado

RespuestaSignificadoDinero
ACCESS_NUMBER:ID:PHONENúmero obtenidoSe descuenta el precio del número
STATUS_WAIT_CODEEsperando el códigoIgual
STATUS_OK:CODELlegó el códigoPago completado
STATUS_WAIT_RETRY:CODEEsperando el siguiente código (incluye el anterior)Sin costo extra
STATUS_CANCELCancelado o tiempo agotadoReembolsado si no hubo código
ACCESS_CANCELCanceladoReembolso total
ACCESS_RETRY_GETEsperando otro código en el mismo númeroSin costo extra
ACCESS_ACTIVATIONTerminaste de usar el númeroIgual
NO_BALANCELo recibes al instante al recargar saldoSin descuento
NO_NUMBERSNo hay números de ese país disponibles ahoraSin descuento
NO_ACTIVATIONSTienes 20 números abiertosSin descuento
EARLY_CANCEL_DENIEDSi el número recibió código, finalízalo (6) en lugar de cancelarloIgual
BAD_KEYLa clave API no es válidaSin descuento
BAD_SERVICE / BAD_COUNTRYEl código de servicio o de país no es válidoSin descuento
NO_ACTIVATIONNo encontramos el ID del númeroIgual
TOO_MANY_REQUESTSSuperaste las 300 solicitudes por minutoSin descuento

Ejemplos por lenguaje

import time, requests

BASE = "https://010sms.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="kr")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

Así se usa

  • Obtén un número con getNumber, ingrésalo en el formulario de registro y llama a getStatus cada 5 segundos.
  • STATUS_OK:cuando llegue el código, ingrésalo y finaliza con setStatus 6.
  • Si el código no llega en 20 minutos, el precio del número se reembolsa automáticamente a tu saldo.
  • Hasta 300 solicitudes por minuto.
API de verificación SMS | 010SMS