Preisliste herunterladen

API-URL

URL zum Senden von HTTP-Anfragen:

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

Hinweis

Wenn die Anfrage ihr Ziel nicht erreicht, wiederholen Sie sie auf dem Backup-Server backup1.bulkgate.com.

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

Hinweis

Die API ist durch ein Minutenkontingent von 20 Anfragen begrenzt.

Parametertabelle

PARAMETERNAME	WERT	PFLICHT	STANDARDWERT
application_id	Application ID	Ja	-
application_token	Application token	Ja	-
country	Array der Ländercodes der gewünschten Preisliste	Ja	-
wallet	Name der gewünschten Wallet.	Nein	Haupt-Wallet

Anders als die übrigen Endpunkte lehnt price-list/get jeden Parameter, der nicht in der obigen Tabelle steht, mit invalid_input_parameters ab. country muss immer ein Array sein, auch bei einem einzigen Land.

Beispiel einer vollständigen Anfrage

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

Mögliche Antworten auf diesen Befehl:

Im Erfolgsfall:

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

Eintrag der Preisliste

data.price_list ist ein Objekt, dessen Schlüssel die Ländercodes sind; unter jedem Schlüssel steht ein Array von Routen. Ein Land, für das keine Preisliste existiert, ist in der Antwort überhaupt nicht enthalten.

FELD	WERT
operator	Name des Netzbetreibers
operator_code	Code des Netzbetreibers
type	Typ der Absenderkennung der Route: `gTextOwn`, `gSystem`, `gShort`, `gText`, `gOwn`, `gMobile`, `gPush` oder `gNone`, wenn die Route keinen hat
price	Preis eines Nachrichtenteils, auf 4 Dezimalstellen gerundet und in die Währung der Wallet umgerechnet
currency	Währung der Wallet, zu der die Preisliste gehört
gate	Nummer des Gateways `0`–`6`, `985` für Mobile Connect
economy	Economy-Route
unicode	Die Route unterstützt Unicode
two_way	Die Route unterstützt Zwei-Wege-Kommunikation. Bei `gOwn` immer `true`
registration	Die Absenderkennung muss vor dem Versand registriert werden, siehe Registrierung des Textabsenders
registration_fee	Einmalige Gebühr für die Registrierung der Absenderkennung. Nur zusammen mit `registration` aussagekräftig
registration_delay	Wie lange die Registrierung dauert. Nur zusammen mit `registration` aussagekräftig
monthly_fee	Wiederkehrende monatliche Gebühr für die registrierte Absenderkennung. Nur zusammen mit `registration` aussagekräftig
route_quality	Einer der Werte `HQ`, `PARTNER DIRECT`, `DIRECT`, `SIM`, `WH`, `SS7`, `PARTNER SS7`, `OFFNET DIRECT - NATIONAL`, `OFFNET DIRECT - GROUP`, `OFFNET DIRECT - INTERNATIONAL` und deren `PARTNER`-Varianten. Ein leerer String, wenn die Qualität nicht bekannt ist
route_note	Hinweis zur Route, `null`, wenn keiner vorhanden ist
sender_note	Hinweis zur Absenderkennung, `null`, wenn keiner vorhanden ist
default_senders	Array der Standard-Absenderkennungen der Route

Im Fehlerfall:

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

Dabei gilt:

type und error (Beschreibung des Fehlers) finden Sie in der Tabelle der Fehlertypen
code steht für den HTTP-Fehlercode
detail enthält zusätzliche Informationen zum Fehler

War diese Seite hilfreich?

KI fragen Kopiert