Flujo de alquiler
Crear, activar, leer SMS, ampliar y restaurar un alquiler.
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
- Añadir servicio: requiere
id,pnumberyservice;rent_dayses opcional. - Ampliar: week/month; consulta
canprolong,canprolongmaxycanprolonguntil. - Ampliar por días: dtype=day, dcount=1–6, dentro de
canprolongmax. - Eliminar pedido: GET con method=delete, no HTTP DELETE.
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.