SMSPVAdevelopers
Rental API
SMSPVA / DOCUMENTATION

Añadir servicio al pedido

GET /api/rent.php?method=add_service_to_order

SMSPVA API
GEThttps://smspva.com/api/rent.php?method=add_service_to_order

Envía una solicitud GET y comprueba status en el JSON: 1 indica éxito y 0 fallo, incluso con HTTP 200. Si falla, consulta el motivo en msg.

Esta solicitud puede modificar un alquiler o generar cargos. Si pierdes la respuesta, comprueba los pedidos y el historial antes de repetir: el cambio puede haberse realizado. Los ejemplos no reintentan automáticamente.

Autenticación

Envía apikey como parámetro obligatorio de consulta.

Parámetros

NombreUbicaciónTipoObligatorioEjemploDescripción
methodquerystringSí"add_service_to_order"Nombre del método
apikeyquerystringSíSMSPVA_API_KEYTu clave API La encontrarás en Profile and APIKEY, en el menú superior derecho del sitio.
idqueryintegerSí56547ID del pedido
servicequerystringSí"opt89"Código de servicio Lista de servicios
pnumberquerystringSí"79335445295"Número alquilado con prefijo de país, sin el signo +.
rent_daysqueryintegerNo7Días opcionales de alquiler. Si se omiten, se usan 7 días en la mayoría de países y 1 día en Canadá.

Cómo usar este método

Añade un servicio a un alquiler existente. Obtén su ID y pnumber en Pedidos de alquiler y consulta el servicio y precio en Datos por proveedor para ese país.

Ejemplos de solicitud

Entorno y dependencias. Los ejemplos codifican los parámetros y esperan hasta 30 segundos. Comprueba HTTP y status antes de usar data. cURL muestra el JSON para que lo revises; Java usa Jackson para leerlo.

  • SMSPVA_RENTAL_ORDER_ID: id.
  • SMSPVA_RENTAL_NUMBER: pnumber.
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_RENTAL_ORDER_ID:?Set SMSPVA_RENTAL_ORDER_ID}"
: "${SMSPVA_RENTAL_NUMBER:?Set SMSPVA_RENTAL_NUMBER}"
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
  --data-urlencode "method=add_service_to_order" \
  --data-urlencode "apikey=$SMSPVA_API_KEY" \
  --data-urlencode "id=$SMSPVA_RENTAL_ORDER_ID" \
  --data-urlencode "service=opt89" \
  --data-urlencode "pnumber=$SMSPVA_RENTAL_NUMBER" \
  --data-urlencode "rent_days=7"

Respuestas

Consulta la respuesta correspondiente a tu solicitud. Los valores y las fechas son orientativos. Los campos opcionales pueden variar según el resultado o el formato elegido.

HTTP 200

Success

application/json

Respuesta ilustrativa

{
  "status": 1,
  "data": {
    "id": 4211321,
    "pnumber": "37067181111",
    "service": "opt95",
    "until": 1771583220
  }
}
NombreTipoDescripción
statusintegerEstado de la respuesta: 1 indica éxito; 0, fallo.
dataobjectDetalles del servicio añadido
data.idintegerID del pedido
data.pnumberstringNúmero de teléfono
data.servicestringCódigo de servicio Lista de servicios
data.untilintegerVencimiento del servicio (timestamp Unix)

Guías relacionadas

En esta página