Hent prisliste

API-URL

URL for sending av HTTP-forespørsler:

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

Merk

Hvis forespørselen ikke når frem, gjentar du den på reserveserveren backup1.bulkgate.com.

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

Merk

API-et er begrenset av en minuttkvote på 20 forespørsler.

Parametertabell

PARAMETERNAVN	VERDI	OBLIGATORISK	STANDARDVERDI
application_id	Applikasjons-ID	Ja	-
application_token	Applikasjonstoken	Ja	-
country	Matrise med landskodene for de ønskede prislistene	Ja	-
wallet	Navnet på lommeboken du foretrekker.	Nei	Hovedlommebok

I motsetning til de andre endepunktene avviser price-list/get alle parametere som ikke står i tabellen ovenfor, med invalid_input_parameters. country må alltid være en matrise, også for ett enkelt land.

Eksempel på fullstendig forespørsel

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" }

Svaret på denne kommandoen kan være:

Ved suksess:

{ "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": [ "+###############" ] } ] } } }

Element i prislisten

data.price_list er et objekt med landskoden som nøkkel; under hver nøkkel ligger en matrise med ruter. Et land som ikke har noen prisliste, er ikke med i svaret i det hele tatt.

FELT	VERDI
operator	Operatørens navn
operator_code	Operatørkode
type	Avsendertypen for ruten: `gTextOwn`, `gSystem`, `gShort`, `gText`, `gOwn`, `gMobile`, `gPush`, eller `gNone` når ruten ikke har noen
price	Pris for én meldingsdel, avrundet til 4 desimaler og omregnet til lommebokens valuta
currency	Valutaen til lommeboken prislisten tilhører
gate	Gatewaynummer `0`–`6`, `985` for Mobile Connect
economy	Økonomirute
unicode	Ruten støtter Unicode
two_way	Ruten støtter toveiskommunikasjon. Alltid `true` for `gOwn`
registration	Avsender-ID-en må registreres før sending, se Registrering av tekstavsender
registration_fee	Engangsavgift for registrering av avsender-ID-en. Har bare betydning sammen med `registration`
registration_delay	Hvor lang tid registreringen tar. Har bare betydning sammen med `registration`
monthly_fee	Fast månedsavgift for den registrerte avsender-ID-en. Har bare betydning sammen med `registration`
route_quality	En av `HQ`, `PARTNER DIRECT`, `DIRECT`, `SIM`, `WH`, `SS7`, `PARTNER SS7`, `OFFNET DIRECT - NATIONAL`, `OFFNET DIRECT - GROUP`, `OFFNET DIRECT - INTERNATIONAL` og deres `PARTNER`-varianter. En tom streng når kvaliteten ikke er kjent
route_note	Merknad om ruten, `null` når det ikke finnes noen
sender_note	Merknad om avsender-ID-en, `null` når det ikke finnes noen
default_senders	Matrise med rutens standard avsender-ID-er

Ved feil:

{ "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 }

Der:

type og error (beskrivelse av feilen) finner du i tabellen over feiltyper
code er HTTP-feilkoden
detail er tilleggsinformasjon om feilen

Var denne siden nyttig?

Spør AI Kopiert