Guthabenstand – Spezifikation

API-URL

Die URL, an die die HTTP-Anfragen gesendet werden:

https://portal.bulkgate.com/api/1.0/simple/info

Hinweis

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

Unterstützte HTTP-Methoden

GET
POST - application/x-www-form-urlencoded
POST - application/json

Beispiele für jede Methode finden Sie unter Anfragemethoden.

Parametertabelle

PARAMETERNAME	WERT	PFLICHT	STANDARDWERT
application_id	Anwendungskennung	Ja	-
application_token	Authentifizierungstoken der Anwendung	Ja	-
wallet	Kennung der Wallet, deren Guthaben Sie abfragen möchten. Ohne diese Angabe wird die Standard-Wallet des Kontos zurückgegeben.	Nein	-

Beispielanfrage

POST /api/1.0/simple/info HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj" }

Antwort

Im Erfolgsfall:

{ "data": { "wallet": "bg1805151838000001", "credit": 215.8138, "currency": "credits", "free_messages": 51, "datetime": "2018-06-13T09:57:21+02:00" } }

Im Fehlerfall:

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