Disponibilidad de todos los números
Consulta la disponibilidad por país, operador y servicio.
Autenticación
| Nombre | Ubicación | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
apikey | header | string | Sí | Tu clave API |
Parámetros
Sin parámetros de ruta o consulta. No requiere cuerpo.
Cómo usar este método
Consulta los números disponibles por país, operador y servicio. Para un país concreto, usa Disponibilidad por país. Compara el coste en Todos los precios.
Ejemplos de solicitud
Requisitos y configuración del entorno. cURL usa un shell POSIX. El ejemplo JavaScript también es válido en TypeScript sobre Node.js. Java utiliza el cliente estándar y muestra JSON sin analizar; usa la biblioteca JSON de tu aplicación.
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
curl --fail-with-body --max-time 30 --request GET \
--url "https://api.smspva.com/activation/countnumbers" \
--header "apikey: $SMSPVA_API_KEY"Respuestas
Los ejemplos muestran el formato de respuesta. Los precios, las cantidades y los datos de cuenta son orientativos; consulta la API para obtener valores actuales.
| HTTP | Descripción |
|---|---|
| 200 | Operación completada |
| 402 | Se ha superado el límite de solicitudes. |
HTTP 200
Operación completada
Respuesta ilustrativa
{
"statusCode": 200,
"data": [
{
"operator": "Primetel_CY",
"country": "CY",
"services": [
{
"service": "opt0",
"total": 12
}
]
}
]
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | Código de estado del resultado |
data | array<object> | Datos de respuesta |
data[].operator | string | Operador |
data[].country | string | País |
data[].services | array<object> | |
data[].services[].service | string | Servicio |
data[].services[].total | integer | Cantidad de números |
HTTP 402
Se ha superado el límite de solicitudes.
Respuesta ilustrativa
{
"statusCode": 402,
"error": {
"type": "RATELIMIT_EXCEED",
"description": "Rate limit exceeded."
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | |
error | object | |
error.type | string | |
error.description | string |
Guías relacionadas
Si falla la conexión al modificar un pedido, comprueba su estado antes de repetir.