Documentation API
Vous pouvez accéder à notre API en utilisant la méthode goods jusqu'à 100 fois toutes les 5 minutes et une fois toutes les 5 minutes en utilisant la méthode categories (le plus souvent cela ne sert à rien, car le produit les positions sont mises à jour avec un délai de 30 minutes). Il n'y a aucune limite à l'achat de biens via l'API, sauf dans les cas où une charge parasite est créée sur le serveur sans acheter les biens (achats frauduleux).
Si les limites sont dépassées, l'erreur {"error_code":429} sera renvoyée avec le code HTTP correspondant 429.
Pour d'autres restrictions, vous pouvez nous convenir par mail admin@buy-accs.ru
Lorsqu'une charge parasite est détectée, nous bloquons les adresses IP d'où elles proviennent.
Il vaut mieux poser des questions à l'avance que de se faire bloquer.
API acceptent les paramètres dans les requêtes POST et GET.
La clé API doit être passée en paramètre api_key.
Exemple de demande :
La réponse est renvoyée au format application/json.
Si des erreurs surviennent, elles seront renvoyées dans la clé errors.
Exemple de demande :
Liste des langues :
- de - Deutsch
- en - English (US)
- es - Español (España)
- fr - Français (France)
- ru - Русский
- zh - 中文(简体)
Certaines méthodes acceptent ou nécessitent de définir une devise à afficher
Exemple de demande :
Liste des devises : rub, usd, eur, cny.
Si la méthode nécessite de spécifier une devise, alors l'erreur correspondante sera renvoyée dans la clé errors.
Paramètres requis :
- currency - Code de la devise souhaitée
Exemple de demande :
Exemple de demande :
Le tableau catégories est renvoyé dans la clé categories.
Chaque catégorie contient :
- sous-catégories - tableau avec sous-catégories
- searchMarkCategories - un tableau de catégories de balises de recherche. Chaque catégorie de marques de recherche contient un tableau de marques de recherche dans la clé searchMarks qui sont utilisées pour un filtrage supplémentaire des produits dans la méthode goods. .
Paramètres requis :
- currency - Code de la devise souhaitée
Paramètres facultatifs :
-
id - ID de produits séparés par des virgules
-
category_id - ID de catégorie
-
subcategory_id - ID de sous-catégorie
-
search_mark_id - ID de marque de recherche
-
limit - Nombre d'articles à retourner. Standard - 100, minimum - 10, maximum - 1000
-
offset - Décalage du nombre de produits consultés
-
sort - paramètre de tri. Paramètres disponibles : id, title, price, count
-
sort-direction - Sens de tri : ASC (Ascendant, standard) ou DESC (Descendant)
Exemple de demande :
Paramètres de retour :
- goods - Gamme de marchandises
- total - Nombre total de produits
- offset - Décalage du nombre de produits consultés
- pagination - Les clés prev et next contiennent true et false selon qu'il y a un next page lorsque les paramètres actuels
Paramètres requis :
- id - ID produit
- count - Quantité de marchandises à acheter
Exemple de prolifération:
La réponse renvoie le numéro de commande dans la clé order_id et le lien de téléchargement dans la clé download_url si le lien est disponible immédiatement après l'achat.
Exemple de réponse :