Online einkaufen oder
Shops und Produkte weiterempfehlen!

  • Startseite
  • Standard-API
  • Developer-API

Standard-API > getBalance
Liefert den aktuellen Kontostand (bestätigte + offene Buchungen). ACHTUNG: Da der Fingerprint des Private-Keys sich niemals ändert, empfehlen wir dir diese Methode NIEMALS öffentlich aufzurufen (nur Server-to-Server-Connections!)


Request

Request-URL: http://api.bee5.de/getBalance.php?k=[PUBLIC_KEY]&pk=[MD5_FINGERPRINT]

Parameter
 Beispiel Beschreibung
k
 x123y45678 Bee5-Public-Key (siehe Webmasterbereich).
pk
 c0118193176fe9b7499fedaf2a0d0b45

Fingerprint
MD5-Fingerprint desBee5-Private-Key:

Beispielwert:
- Bee5-Private-Key = Xu38sV2u6ZXu38sV2u6ZXu38sV2u6Zrd

Beispiel-Code:
md5("Xu38sV2u6ZXu38sV2u6ZXu38sV2u6Zrd")

Ergebnis:
c0118193176fe9b7499fedaf2a0d0b45

Beispiel: http://api.bee5.de/getBalance.php?k=x123y45678&pk=c0118193176fe9b7499fedaf2a0d0b45


Response

Response wenn Authentifizierung korrekt:
<?xml version="1.0" encoding="ISO8859-1"?>
<balance>
  <approved>
    <quantity>5</quantity>
    <amount>12,34</amount>
  </approved>
  <open>
    <quantity>21</quantity>
    <amount>76,54</amount>
  </open>
</balance>


Errors

Code Meldung Beschreibung
1000 Insufficient arguments Mindestens ein Request-Parameter ist leer oder falsch
1001 Unknown API-User Der Bee5-Public-Key ist unbekannt (Parameter "k")
1002 Wrong MD5-Verification MD5-Verifizierungscode ist falsch (Parameter "pk")
1003 API-Quota exceeded Das maximal verfügbare Abruf-Kontingent für die Bee5-API wurde überschritten (Standard = 10.000 Calls). Das Kontingent wird monatlich zurückgesetzt. Falls du ein größeres Kontingent benötigst, teile uns bitte mit wie und wo du unsere API verwenden möchtest.
1004 URL on Blacklist Die übergebene URL wird von Bee5 blockiert. Dies kann mehrere Gründe haben: es handelt sich um eine Phishing-Seite, die Seite ist virenverseucht oder sie steht auf unserer internen Blacklist.
1005 To many TLD (max. 20) Es wurden zu viele Top-Level-Domains übergeben. Pro Call dürfen maximal 20 TLDs übergeben werden.
1006 Unknown Short-URL Die übergebene Kurz-URL nicht nicht bekannt, abgelaufen oder passwortgeschützt - es konnte keine Original-/Long-URL gefunden werden.