Precio del servicio
Consulta el precio de un país y servicio, incluidos sus operadores.
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 |
|---|---|---|---|---|
country | path | string | Sí | Código de país de dos caracteres en mayúsculas, en el formato ISO 3166-2 indicado por la API. Lista de países |
service | path | string | Sí | Código del servicio. Lista de servicios |
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
Consulta el precio de un country y un service, incluidos los precios de priceByOperators. Elige códigos en las listas, comprueba la disponibilidad o compara otros países.
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/serviceprice/BD/opt0?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 | country o service no es válido. |
HTTP 200
Operación completada
Respuesta ilustrativa
{
"statusCode": 200,
"data": {
"service": "opt0",
"serviceDescription": "myopinions & erewards",
"country": "KZ",
"price": "2.34",
"priceByOperators": {
"Other_KZ": "0.39",
"Activ_KZ": "0.39"
}
}
}Campos de respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
statusCode | integer | Código de estado del resultado |
data | object | Datos de respuesta |
data.service | string | Servicio |
data.serviceDescription | string | Descripción del servicio. |
data.country | string | País |
data.price | string | Precio. |
data.priceByOperators | object | Precios agrupados por operador. |
data.priceByOperators.* | string |
HTTP 405
country o service no es válido.
Respuesta ilustrativa
{
"statusCode": 405,
"error": {
"type": "INVALID_PARAMS",
"description": "Invalid params"
}
}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.