SMSPVAdevelopers
Rental API
SMSPVA / DOCUMENTATION

Flujo de alquiler

Crear, activar, leer SMS, ampliar y restaurar un alquiler.

SMSPVA API

1. Elegir país, servicio y duración

Usa las listas actualizadas y países. Compara precios y proveedores en datos por proveedor con el país y duración que vas a contratar.

Para varios servicios, envía códigos separados por comas en services y consulta disponibilidad multiservicio. En ese método, pasa dtype y dcount explícitamente como recomienda la fuente. La mayoría de métodos de duración usan week/month, no días.

2. Crear una vez

Usa Crear alquiler o Crear multiservicio. Conserva data.id, pnumber, ccode y until. Son datos de alquiler, no de Activation V2. Ambas solicitudes usan GET y pueden crear pedidos de pago. Si se pierde la respuesta, comprueba pedidos antes de repetir.

3. Activar antes de enviar SMS

Llama a Activar y consulta state en los pedidos: 0 no activo, 1 activo, 2 activando, -1 fuera del sistema. Envía SMS solo cuando esté activo; status=1 en la activación no sustituye esa comprobación.

4. Leer mensajes

Rental SMS devuelve data.SmsList y data.OtherSms. Primero comprueba status=1. Una lista vacía es un resultado correcto sin mensajes en esa lista; no se aplica el HTTP 202 de Activation V2.

Las lecturas repetidas pueden incluir SMS ya procesados. Guarda el estado de procesamiento en tu aplicación. Espacia el polling y deténlo al completar la tarea o vencer el alquiler; respeta las respuestas de límite de cada método. Los ejemplos hacen una solicitud sin reintentos automáticos.

5. Modificar o ampliar

Los ejemplos no ejecutan estas acciones automáticamente.

6. Restaurar

Consulta historial e isAvailForRestore. Ejecuta cálculo previo, revisa precio y duración y llama a Restaurar. data.id contiene el nuevo pedido restaurado. HTTP 200 con status=0 y msg sigue siendo un error.

Fechas

La creación documenta until como string y la lista de pedidos como integer. Se conservan los tipos por respuesta. Los timestamps son segundos Unix; no uses el modelo orderExpireIn de Activation V2.

En esta página