Precios del servicio por país
Compara precios y disponibilidad por país y operador para un servicio.
Autenticación
| Nombre | Ubicación | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
apikey | header | string | Sí | Tu clave API |
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
service | path | string | Sí | Código del servicio. Lista de servicios (pattern: "^opt[0-9]{1,8}$") |
voice | query | integer | No | Tipo: 0 SMS, 1 identificación de llamada, 2 voz. Valor predeterminado: 0. (enum: [0,1,2]; default: 0) |
No requiere cuerpo de solicitud.
Cómo usar este método
Compara los precios y la disponibilidad de un service entre países y operadores. Usa los códigos elegidos en Obtener número por operador.
La lista puede incluir operadores de SMSPVA y de proveedores externos, como DonorAlpha_UK. Ambos códigos se usan del mismo modo. Los números externos pueden ser menos fiables que las SIM reales de SMSPVA. Un recuento de 9999 indica que la cantidad exacta se desconoce; la disponibilidad puede ser prácticamente ilimitada.
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/serviceprices/opt20?voice=0" \
--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 |
| 405 | Parámetros no válidos |
HTTP 200
Operación completada
Respuesta ilustrativa
{
"statusCode": 200,
"data": {
"scode": "opt20",
"sname": "WhatsApp",
"clist": [
{
"ccode": "UK",
"cname": "United Kingdom",
"opers": [
{
"opcode": "DonorAlpha_UK",
"price": 0.65,
"count": 9999
}
]
}
]
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | Código de estado del resultado |
data | object | Datos de respuesta |
data.scode | string | Código del servicio. |
data.sname | string | Nombre del servicio. |
data.clist | array<object> | Países y operadores disponibles para el servicio. |
data.clist[].ccode | string | Código del país. |
data.clist[].cname | string | Nombre del país. |
data.clist[].opers | array<object> | |
data.clist[].opers[].opcode | string | Código de un operador de SMSPVA o de un proveedor externo. |
data.clist[].opers[].price | number | Precio del operador. (format: "float") |
data.clist[].opers[].count | integer | Números disponibles. Para proveedores externos, 9999 indica una cantidad exacta desconocida y disponibilidad posiblemente ilimitada. |
HTTP 405
Parámetros no válidos
Respuesta ilustrativa
{
"statusCode": 405,
"error": {
"type": "INVALID_PARAMS",
"description": "Invalid params."
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | Código de estado del resultado |
error | object | Detalles del error |
error.type | string | Tipo de error |
error.description | string | Descripción del error |
Guías relacionadas
Si falla la conexión al modificar un pedido, comprueba su estado antes de repetir.