Datos por proveedor
GET /api/rent.php?method=getdataWithProviders
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
apikey es opcional. Omítelo para datos públicos o envíalo para datos y precios personalizados según el contrato.
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|---|
method | query | string | Sí | "getdataWithProviders" | Nombre del método |
apikey | query | string | No | (optional) | Clave API opcional; permite obtener datos y precios personalizados. |
country | query | string | Sí | "KZ" | Código de país del número. Lista de países |
dtype | query | string | No | "week" | Unidad del período: week o month. Si se omite, se usa week. |
dcount | query | integer | No | 1 | Número de períodos; con dtype=week, número de semanas. Si se omite, se usa 1. |
extend | query | string | No | "1" | Activa el formato de respuesta ampliado. |
Cómo usar este método
Compara los servicios de un country, sus precios diarios y los proveedores disponibles. Usa el mismo dtype y dcount que tendrá el alquiler.
Elige el país en Países de alquiler y usa el código del servicio en Crear alquiler o Crear alquiler multiservicio.
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.
# Optional: add --data-urlencode "apikey=$SMSPVA_API_KEY" for account-specific data.
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
--data-urlencode "method=getdataWithProviders" \
--data-urlencode "country=KZ" \
--data-urlencode "dtype=week" \
--data-urlencode "dcount=1"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": {
"services": [
{
"name": "1cupis & okcupid & winline",
"service": "opt48",
"price_day": 5,
"img": "images/ico/cupis_okcupid_winline.ico",
"procent_days": 0,
"procent": 0,
"day_step": 0,
"count": {
"Claro_AR": 27
},
"totalCount": 12
}
],
"totalAmount": 1735,
"allOperators": [
"Claro_AR"
]
}
}| Nombre | Tipo | Descripción |
|---|---|---|
status | integer | Estado de la respuesta: 1 indica éxito; 0, fallo. |
data | object | |
data.services | array<object> | |
data.services[].name | string | Nombre del servicio |
data.services[].service | string | Código de servicio Lista de servicios |
data.services[].price_day | number | Precio diario de este servicio |
data.services[].img | string | URL del icono del servicio |
data.services[].procent_days | integer | Días necesarios para el descuento |
data.services[].procent | integer | Porcentaje de descuento |
data.services[].day_step | integer | Incremento de días para el precio |
data.services[].count | object | Números disponibles por operador para este servicio |
data.services[].count.* | integer | |
data.services[].totalCount | integer | Total de números disponibles para este servicio |
data.totalAmount | integer | Total de números disponibles para todos los servicios |
data.allOperators | array<string> | Operadores disponibles en este país |
msg | string | Motivo del error cuando status vale 0, incluso si HTTP es 200. |