SMSPVAdevelopers
Rental API
SMSPVA / DOCUMENTATION

Ampliar por días

GET /api/rent.php?method=prolong_max

SMSPVA API
GEThttps://smspva.com/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

NombreUbicaciónTipoObligatorioEjemploDescripción
methodquerystringSí"prolong_max"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í123ID del pedido
dtypequerystringSí"day"Unidad de duración; debe ser siempre "day".
dcountqueryintegerSí5Dí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"
}
NombreTipoDescripción
statusintegerEstado de la respuesta: 1 indica éxito; 0, fallo.

Guías relacionadas

En esta página