Crear alquiler
GET /api/rent.php?method=create
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í | "create" | 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. |
dtype | query | string | Sí | "week" | Unidad del período: week o month |
dcount | query | integer | Sí | 1 | Número de períodos; si dtype=week, es el número de semanas. |
country | query | string | Sí | "KZ" | Código de país del número. Lista de países |
service | query | string | Sí | "opt6" | Código de servicio Lista de servicios |
provider | query | string | No | "T-Mobile" | Proveedor opcional. Si lo omites, se elige uno al azar entre los disponibles. |
partner_key | query | string | No | "partnerkeyhere" | Clave de socio opcional para referidos. |
Cómo usar este método
Alquila un número para un servicio. Para varios servicios en el mismo número, usa Crear alquiler multiservicio tras comprobar la disponibilidad.
Elige un país y compara servicios, proveedores y precios con la misma duración. Busca el alquiler creado en Pedidos de alquiler y actívalo antes de enviar un SMS.
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=create" \
--data-urlencode "apikey=$SMSPVA_API_KEY" \
--data-urlencode "dtype=week" \
--data-urlencode "dcount=1" \
--data-urlencode "country=KZ" \
--data-urlencode "service=opt6"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": 40370,
"pnumber": "9096037108",
"ccode": "+7",
"service": "opt6",
"until": "1587633960"
}
}| Nombre | Tipo | Descripción |
|---|---|---|
status | integer | Estado de la respuesta: 1 indica éxito; 0, fallo. |
data | object | |
data.id | integer | ID del pedido |
data.pnumber | string | Número sin prefijo de país |
data.ccode | string | Código numérico de país |
data.service | string | Código de servicio Lista de servicios |
data.until | string | Fecha de vencimiento (timestamp Unix) |
msg | string | Motivo del error cuando status vale 0. |