| Request-URL: http://api.adtago.de/GetBalance.php?p=[PUBLIC_KEY]&k=[MD5_FINGERPRINT]&c=[CRYPT_VALUE] |
| Parameter | Beispiel | Beschreibung |
| [PUBLIC_KEY] | x1234y6789 | adtago-Public-Key (siehe Produkte > adtago API) |
| [CRYPT_VALUE] | 1250674857 | Frei definierbarer dynamischer Wert (empfohlener Wert: Timestamp) Der angebene Wert sollte sich laufend verändern und ein durchgehender String sein (keine Leer- oder Sonderzeichen!) |
| [MD5_FINGERPRINT] | c0118193176fe9b7499fedaf2a0d0b45 | Fingerprint MD5-Fingerprint aus [CRYPT_VALUE] und adtago-Private-Key: CRYPT_VALUE+ adtago-Private-Key (direkt aneinander - ohne Trennzeichen!) Beispiel-Code (CRYPT_VALUE = timestamp, z.B. 1250674857) Beispiel-Code: md5("1250674857Xu38sV2u6ZXu38sV2u6ZXu38sV2u6Zrd") Ergebnis: c0118193176fe9b7499fedaf2a0d0b45 |
| Beispiel: http://api.adtago.de/GetBalance.php?p=x1234y6789&k=c0118193176fe9b7499fedaf2a0d0b45&c=1250674857 |
| Response bei korrekter Authentifizierung: |
| <?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> |
| Code | Meldung | Beschreibung |
| 1000 | Insufficient arguments | Mindestens ein Request-Parameter ist leer oder falsch |
| 1001 | Unknown API-User | Der adtago-Public-Key ist unbekannt (Parameter "p") |
| 1002 | Wrong MD5-Verification | MD5-Verifizierungscode ist falsch (Parameter "k") |
| 1003 | API-Quota exceeded | Das maximal verfügbare Abruf-Kontingent für die adtago-API wurde überschritten (Standard = 30.000 Calls). Das Kontingent wird monatlich zurückgesetzt. Falls Sie ein größeres Kontingent benötigen, teilen Sie uns bitte mit wie und wo Sie unsere API verwenden möchten. |
| 1004 | To many TLD (max. 20) | Es wurden zu viele Top-Level-Domains übergeben. Pro Call dürfen maximal 20 TLDs übergeben werden. |
| 1005 | Wrong request argument: ##ERROR_MSG## | Ein oder mehrere Abfrage-Parameter sind falsch (z.B. falsche Datumsangabe). In ##ERROR_MSG## werden die falschen Angabe aufgezählt. |
| Beispiel-Error: |
| <?xml version="1.0" encoding="ISO8859-1"?> <error> <code>1000</code> <msg>Insufficient arguments</msg> </error> |