Historial de alquiler
GET /api/rent.php?method=get_rent_history
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.
Autenticación
Envía apikey como parámetro obligatorio de consulta.
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|---|
method | query | string | Sí | "get_rent_history" | Nombre del método |
apikey | query | string | Sí | SMSPVA_API_KEY | Tu clave API La encontrarás en Profile and APIKEY, en el menú superior derecho del sitio. |
skip | query | integer | No | 0 | Resultados que se omiten |
take | query | integer | No | 10 | Cantidad de resultados |
Cómo usar este método
Busca alquileres terminados y comprueba isAvailForRestore para saber cuáles se pueden restaurar. Si el pedido lo permite, consulta coste y duración antes de restaurarlo.
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_API_KEY:?Set SMSPVA_API_KEY}"
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
--data-urlencode "method=get_rent_history" \
--data-urlencode "apikey=$SMSPVA_API_KEY" \
--data-urlencode "skip=0" \
--data-urlencode "take=10"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": [
{
"orderId": 857191,
"resourceCode": "opt9",
"number": "37067787324",
"branchId": 684,
"haveSms": false,
"isAvailForRestore": true,
"days": 30,
"country": "LT",
"begin": 1768902473,
"end": 1771494473,
"closed": 1768903921
}
]
}| Nombre | Tipo | Descripción |
|---|---|---|
status | integer | Estado de la respuesta: 1 indica éxito; 0, fallo. |
data | array<object> | |
data[].orderId | integer | ID del pedido |
data[].resourceCode | string | Código de servicio Lista de servicios |
data[].number | string | Número alquilado con prefijo de país, sin el signo +. |
data[].branchId | integer | ID interno de la rama del pedido |
data[].haveSms | boolean | Indica si se recibieron SMS durante el alquiler. |
data[].isAvailForRestore | boolean | Indica si se puede restaurar. Si es true, Restore renueva el alquiler con un número nuevo. |
data[].days | integer | Días contratados en el alquiler |
data[].country | string | Código de país del número. Lista de países |
data[].begin | integer | Fecha de inicio (timestamp Unix) |
data[].end | integer | Fecha de finalización (timestamp Unix) |
data[].closed | integer | Fecha de cierre (timestamp Unix) |