Документация API
Количество запросов
Обращаться к нашему API по методу goods можно до 100 раз в 5 минут и 1 раз в 5 минут по методу categories (чаще нет смысла, т.к. позиции товара обновляются с задержкой в 30 минут). По покупке товара через API - лимитов нет, кроме случаев если создается паразитная нагрузка на сервер без покупки товара (фрод-покупки).
При привышении лимитов будет возвращена ошибка {"error_code":429} с соответствующим HTTP кодом 429.
По остальным ограничениям вы можете договориться с нами по почте admin@buy-accs.net
При выявлении паразитной нагрузки, мы блокируем IP адреса с которых они идут.
Лучше заранее задать вопросы, нежели получить блокировку.
Формат запроса API
Методы API принимают параметры в POST и GET запросе.
API ключ необходимо передать в параметре api_key.
Пример запроса:
Ответ возвращается в формате application/json.
В случае возникновения ошибок они будут возвращены в ключе errors.
Установка языка запроса
Пример запроса:
Список языков:
- de - Deutsch
- en - English (US)
- es - Español (España)
- fr - Français (France)
- ru - Русский
- zh - 中文(简体)
Установка валюты
Некоторые методы принимают или требуют установку валюты для отображения
Пример запроса:
Список валют: rub, usd, eur, cny.
В случае если метод требует указание валюты, то в ключе errors будет возвращена соответствующая ошибка.
Получение баланса
Обязательные параметры:
- currency - Код необходимой валюты
Пример запроса:
Получение категорий и поисковых меток
Пример запроса:
Массив категорий возвращается в ключе categories.
В каждой категории содержится:
- subcategories - массив с подкатегориями
- searchMarkCategories - массив категорий поисковых меток. Каждая категория поисковых меток содержит массив поисковых меток в ключе searchMarks которые используются для дополнительной фильтрации товаров в методе goods.
Получение товаров
Обязательные параметры:
- currency - Код необходимой валюты
Опциональные параметры:
-
id - ID товаров через запятую
-
category_id - ID категории
-
subcategory_id - ID подкатегории
-
search_mark_id - ID поисковой метки
-
limit - Количество возвращаемых товаров. Стандартно - 100, минимально - 10, максимально - 1000
-
sort - параметр сортировки. Доступные параметры: id, title, price, count
-
sort-direction - Направление сортировки: ASC (Возрастающее, стандартно) или DESC (Нисходящее)
Пример запроса:
Возвращаемые параметры:
- goods - Массив товаров
- total - Общее количество товаров
- offset - Отступ в количестве просматриваемых товаров
- pagination - Ключи prev и next содержат true и false в зависимости есть ли следующая страница при текущих параметрах
Покупка товара
Обязательные параметры:
- id - ID товара
- count - Количество товара для покупки
Пример зароса:
В ответе возвращается номер заказа в ключе order_id и ссылка на скачивание в ключе download_url в случае если ссылка доступна сразу после покупки.
Пример ответа: