Partner-API
› Grundlagen › Konventionen
Konventionen
Anfragen
| Methode | Ausschließlich GET. Andere Methoden werden mit 405 abgewiesen. |
| Protokoll | Nur HTTPS. Unverschlüsselte Aufrufe werden umgeleitet, dabei stünde dein Schlüssel im Klartext auf der Leitung. |
| Kodierung | Parameterwerte URL-kodiert, UTF-8. Ein Kaufmanns-Und im Kategorienamen wird zu %26, ein Leerzeichen zu %20. |
| Zeitüberschreitung | Wir antworten in der Regel unter einer Sekunde. Setze im Client 30 Sekunden an. |
Antworten
| Format | application/json; charset=utf-8 |
| Preise | Dezimalzahl mit Punkt als Trennzeichen, zwei Nachkommastellen, immer Euro. Beispiel: 22.61 |
| Prozente | Dezimalzahl mit einer Nachkommastelle. 51.6 bedeutet 51,6 Prozent unter dem üblichen Preis. |
| Datum | ISO 8601. Reine Tagesangaben als JJJJ-MM-TT, Zeitpunkte als JJJJ-MM-TTThh:mm:ss. |
| Fehlende Werte | null, nie ein leerer Text und nie 0. Ein null bei price_lowest heißt „nicht bekannt“, nicht „kostenlos“. |
| Unbekannte Felder | Wir dürfen jederzeit Felder ergänzen. Dein Client sollte unbekannte Felder überspringen statt daran zu scheitern. |
Statuscodes
| Code | Bedeutung |
|---|---|
200 | Erfolg. Auch dann, wenn die Trefferliste leer ist. |
400 | Ein Parameter fehlt oder liegt außerhalb des erlaubten Bereichs. |
401 | Kein oder ungültiger Schlüssel. |
403 | Schlüssel gültig, aber für diesen Zugriff nicht berechtigt. |
404 | Die angefragte Ressource kennen wir nicht. |
429 | Tageslimit ausgeschöpft. |
500 | Fehler bei uns. Bitte melden, gerne mit Zeitpunkt und Aufruf. |
503 | Ein Teildienst ist vorübergehend nicht erreichbar. Später erneut versuchen. |