API-Dokumentation
Anzahl der Anfragen
Sie können mit der Methode goods bis zu 100 Mal alle 5 Minuten auf unsere API zugreifen und mit der Methode categories einmal alle 5 Minuten (häufiger macht es keinen Sinn, weil Produkt (Positionen werden mit einer Verzögerung von 30 Minuten aktualisiert). Es gibt keine Beschränkungen für den Kauf von Waren über die API, außer in Fällen, in denen eine parasitäre Belastung auf dem Server entsteht, ohne die Waren zu kaufen (Betrugskäufe).
Bei Überschreitung der Grenzwerte wird der Fehler {"error_code":429} mit dem entsprechenden HTTP-Code 429 zurückgegeben.
Weitere Einschränkungen können Sie per Mail mit uns vereinbaren admin@buy-accs.net
Wenn eine parasitäre Last erkannt wird, blockieren wir die IP-Adressen, von denen sie stammen.
Es ist besser, im Voraus Fragen zu stellen, als blockiert zu werden.
API-Anfrageformat
API-Methoden akzeptieren Parameter in POST- und GET-Anfragen.
API-Schlüssel muss im Parameter api_key übergeben werden.
Beispielanfrage:
Response wird im Format application/json.
zurückgegeben.Sollten Fehler auftreten, werden diese im Schlüssel errors.
zurückgegeben Festlegen der Anfragesprache
Beispielanfrage:
Liste der Sprachen:
- de - Deutsch
- en - English (US)
- es - Español (España)
- fr - Français (France)
- ru - Русский
- zh - 中文(简体)
Währung einstellen
Einige Methoden akzeptieren oder erfordern die Einstellung einer Währung zur Anzeige
Beispielanfrage:
Liste der Währungen: rub, usd, eur, cny.
Wenn die Methode die Angabe einer Währung erfordert, wird der entsprechende Fehler im Schlüssel errors zurückgegeben.
Balance finden
Erforderliche Parameter:
- Währung - Code der gewünschten Währung
Beispielanfrage:
Kategorien und Such-Tags abrufen
Beispielanfrage:
Das Kategorien-Array wird im Schlüssel categories.
zurückgegebenJede Kategorie enthält:
- Unterkategorien - Array mit Unterkategorien
- searchMarkCategories – ein Array von Such-Tag-Kategorien. Jede Kategorie von Suchzeichen enthält eine Reihe von Suchzeichen im Schlüssel searchMarks, die zur zusätzlichen Filterung von Produkten in der Methode goods. verwendet werden.
Warenannahme
Erforderliche Parameter:
- Währung - Code der gewünschten Währung
Optionale Parameter:
-
id – Produkt-IDs durch Kommas getrennt
-
category_id - Kategorie-ID
-
subcategory_id - Unterkategorie-ID
-
search_mark_id – Suchmarkierungs-ID
-
limit – Anzahl der zurückzugebenden Artikel. Standard – 100, Minimum – 10, Maximum – 1000
-
sort – Sortierparameter. Verfügbare Parameter: id, title, price, count
-
sort-direction - Sortierrichtung: ASC (Aufsteigend, Standard) oder DESC (Absteigend)
Beispielanfrage:
Rückgabeparameter:
- Waren - Warensortiment
- total - Gesamtzahl der Produkte
- Offset - Offset in der Anzahl der angesehenen Produkte
- pagination – Die Schlüssel prev und next enthalten true und false, je nachdem, ob es eine nächste gibt Seite, wenn aktuelle Parameter
Kauf von Waren
Erforderliche Parameter:
- id - Produkt-ID
- count - Menge der zu kaufenden Waren
Beispiel für Überwucherung:
Die Antwort gibt die Bestellnummer im Schlüssel order_id und den Download-Link im Schlüssel download_url zurück, wenn der Link unmittelbar nach dem Kauf verfügbar ist.
Beispielantwort: