Restaurar alquiler

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ónCopiar enlace

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

ParámetrosCopiar enlace

Cómo usar este métodoCopiar enlace

Restaura un alquiler terminado que cumpla los requisitos. Obtén el ID en Historial, comprueba isAvailForRestore y consulta antes coste y duración.

Si funciona, status=1 y data.id contiene el nuevo ID. Úsalo en Pedidos de alquiler. Si status=0, consulta el motivo en msg.

Ejemplos de solicitudCopiar enlace

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=restore_user" \
  --data-urlencode "apikey=$SMSPVA_API_KEY" \
  --data-urlencode "id=$SMSPVA_RENTAL_ORDER_ID"

RespuestasCopiar enlace

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 200Copiar enlace

La respuesta incluye el ID del pedido restaurado si funciona, o el motivo si falla.

application/json

Restauración completada

{
  "status": 1,
  "data": {
    "id": 123456
  }
}

Incorrect order ID

{
  "status": 0,
  "msg": "Incorrect order id"
}

Order not found

{
  "status": 0,
  "msg": "Order not found"
}

Not enough balance

{
  "status": 0,
  "msg": "NOBALANCE_12.50"
}

Number is busy

{
  "status": 0,
  "msg": "The number is busy, there is already an order for this service"
}

Correcto

Obligatorios: status, data

Error

Obligatorios: status, msg

Guías relacionadasCopiar enlace

• Rental API
• Países y servicios
• Flujo de alquiler
• Errores
• Esquema OpenAPI