Ampliar por días
GET /api/rent.php?method=prolong_max
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
| Nombre | Ubicación | Tipo | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|---|
method | query | string | Sí | "prolong_max" | 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. |
id | query | integer | Sí | 123 | ID del pedido |
dtype | query | string | Sí | "day" | Unidad de duración; debe ser siempre "day". |
dcount | query | integer | Sí | 5 | Días de ampliación (1-6), sin superar canprolongmax del pedido. |
Cómo usar este método
Amplía el alquiler por días con dtype=day y dcount entre 1–6. Consulta primero canprolong, canprolongmax y canprolonguntil en Pedidos de alquiler. La ampliación debe respetar los límites de ese pedido.
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_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_RENTAL_ORDER_ID:?Set SMSPVA_RENTAL_ORDER_ID}"
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
--data-urlencode "method=prolong_max" \
--data-urlencode "apikey=$SMSPVA_API_KEY" \
--data-urlencode "id=$SMSPVA_RENTAL_ORDER_ID" \
--data-urlencode "dtype=day" \
--data-urlencode "dcount=5"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
Resultado de la ampliación por días.
application/json
Ampliación de hasta 7 días completada
{
"status": 1
}Incorrect order id
{
"status": 0,
"msg": "Incorrect order id"
}Order not found
{
"status": 0,
"msg": "Order not found"
}Invalid duration parameters
{
"status": 0,
"msg": "More than 7 days or type is not day"
}Insufficient funds in account
{
"status": 0,
"msg": "Insufficient balance"
}| Nombre | Tipo | Descripción |
|---|---|---|
status | integer | Estado de la respuesta: 1 indica éxito; 0, fallo. |