Obtener lista de precios

URL de la API

URL a la que se envían las solicitudes HTTP:

https://portal.bulkgate.com/api/1.0/price-list/get

Nota

Si la solicitud no llega a su destino, repítala en el servidor de respaldo backup1.bulkgate.com.

POST /api/1.0/price-list/get HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json

Nota

La API está limitada a una cuota de 20 solicitudes por minuto.

Tabla de parámetros

NOMBRE DEL PARÁMETRO	VALOR	OBLIGATORIO	VALOR PREDETERMINADO
application_id	ID de aplicación	Sí	-
application_token	Token de aplicación	Sí	-
country	Array de códigos de país de la lista de precios deseada	Sí	-
wallet	Nombre del monedero que prefiera.	No	Monedero principal

A diferencia de los demás endpoints, price-list/get rechaza con invalid_input_parameters cualquier parámetro que no figure en la tabla anterior. country debe ser siempre un array, incluso para un solo país.

Ejemplo de solicitud completa

POST /api/1.0/price-list/get HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "country": ["sk", "cz"], "wallet": "bg1905014138000023" }

La respuesta a este comando puede ser:

En caso de éxito:

{ "data": { "price_list": { "sk": [ { "operator": "4ka", "operator_code": "23103", "type": "gSystem", "price": 0.03, "currency": "EUR", "gate": 0, "economy": false, "unicode": true, "two_way": true, "registration": false, "registration_fee": 0, "registration_delay": 0, "monthly_fee": 0, "route_quality": "HQ", "route_note": null, "sender_note": null, "default_senders": [ "+##############" ] }, { "operator": "O2", "operator_code": "23106", "type": "gSystem", "price": 0.03, "currency": "EUR", "gate": 0, "economy": false, "unicode": true, "two_way": true, "registration": false, "registration_fee": 0, "registration_delay": 0, "monthly_fee": 0, "route_quality": "HQ", "route_note": null, "sender_note": null, "default_senders": [ "+###############" ] } ] } } }

Elemento de la lista de precios

data.price_list es un objeto cuyas claves son los códigos de país; bajo cada clave hay un array de rutas. Un país que no tiene lista de precios no aparece en absoluto en la respuesta.

CAMPO	VALOR
operator	Nombre del operador
operator_code	Código del operador
type	Tipo de ID de remitente de la ruta: `gTextOwn`, `gSystem`, `gShort`, `gText`, `gOwn`, `gMobile`, `gPush`, o `gNone` si la ruta no tiene ninguno
price	Precio de una parte del mensaje, redondeado a 4 decimales y convertido a la moneda del monedero
currency	Moneda del monedero al que pertenece la lista de precios
gate	Número de pasarela `0`–`6`, `985` para Mobile Connect
economy	Ruta económica
unicode	La ruta admite Unicode
two_way	La ruta admite la comunicación bidireccional. Siempre `true` para `gOwn`
registration	El ID de remitente debe registrarse antes del envío, consulte Registro de remitente de texto
registration_fee	Tarifa única por el registro del ID de remitente. Solo tiene sentido junto con `registration`
registration_delay	Cuánto tarda el registro. Solo tiene sentido junto con `registration`
monthly_fee	Tarifa mensual recurrente por el ID de remitente registrado. Solo tiene sentido junto con `registration`
route_quality	Uno de los valores `HQ`, `PARTNER DIRECT`, `DIRECT`, `SIM`, `WH`, `SS7`, `PARTNER SS7`, `OFFNET DIRECT - NATIONAL`, `OFFNET DIRECT - GROUP`, `OFFNET DIRECT - INTERNATIONAL` y sus variantes `PARTNER`. Una cadena vacía si la calidad no se conoce
route_note	Nota sobre la ruta, `null` si no hay ninguna
sender_note	Nota sobre el ID de remitente, `null` si no hay ninguna
default_senders	Array de los ID de remitente predeterminados de la ruta

En caso de error:

{ "type": "invalid_wallet", "code": 400, "error": "Invalid wallet", "detail": null }

{ "type": "the_quota_of_send_per_minute_has_been_exceeded", "code": 400, "error": "The quota of send per minute has been exceeded", "detail": null }

{ "type": "invalid_input_parameters", "code": 400, "error": "Invalid input parameters", "detail": null }

{ "type": "unknown_identity", "code": 401, "error": "Unknown identity / unauthorized / empty application_id", "detail": null }

Donde:

type y error (descripción del error) se encuentran en la tabla de tipos de error
code representa el código de error HTTP
detail es información adicional sobre el error

¿Le ha resultado útil esta página?

Preguntar a la IA Copiado