Disponibilidad por proveedor
GET /api/rent.php?method=getCountWithProviders
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í | "getCountWithProviders" | Nombre del método |
apikey | query | string | No | (optional) | Clave API opcional; permite obtener datos 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. |
Cómo usar este método
Compara la disponibilidad por servicio y proveedor. Para cada código de servicio, Amount relaciona proveedores con cantidades y Total muestra la suma. Lee esas claves de la respuesta, porque pueden cambiar.
Comprueba status incluso con HTTP 200. Si vale 0, el error está en msg.
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=getCountWithProviders" \
--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": {
"opt48": {
"Amount": {
"Limbo_AT": 12,
"Tele2_AT": 1,
"yesss_AT": 69
},
"Total": 82
}
}
}| Nombre | Tipo | Descripción |
|---|---|---|
status | integer | Estado de la respuesta: 1 indica éxito; 0, fallo. |
data | object | Cantidades por proveedor y total para cada código de servicio. |
data.* | object | |
data.*.Amount | object | Cantidad de números disponibles por proveedor. |
data.*.Amount.* | integer | |
data.*.Total | integer | Total de números disponibles para el servicio. |
msg | string | Motivo del error cuando status vale 0. |