Документация API

Получить ключ

Обращаться к нашему API по методу goods можно до 100 раз в 5 минут и 1 раз в 5 минут по методу categories (чаще нет смысла, т.к. позиции товара обновляются с задержкой в 30 минут). По покупке товара через API - лимитов нет, кроме случаев если создается паразитная нагрузка на сервер без покупки товара (фрод-покупки).
При привышении лимитов будет возвращена ошибка {"error_code":429} с соответствующим HTTP кодом 429.

По остальным ограничениям вы можете договориться с нами по почте admin@buy-accs.net

При выявлении паразитной нагрузки, мы блокируем IP адреса с которых они идут.

Лучше заранее задать вопросы, нежели получить блокировку.

Методы 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

• offset - Отступ в количестве просматриваемых товаров

• sort - параметр сортировки. Доступные параметры: id, title, price, count

• sort-direction - Направление сортировки: ASC (Возрастающее, стандартно) или DESC (Нисходящее)

Пример запроса:

Возвращаемые параметры:

• goods - Массив товаров
• total - Общее количество товаров
• offset - Отступ в количестве просматриваемых товаров
• pagination - Ключи prev и next содержат true и false в зависимости есть ли следующая страница при текущих параметрах

В массиве товаров содержится

• not_valid_percent - количество невалида при продажах в процентах от 0 до 100, при этом значение -1 обозначает что у товара отсутствуют продажи.
• supplier_id - ID поставщика

Обязательные параметры:

• id - ID товара
• count - Количество товара для покупки

Опциональные параметры:

• show_ad - Отображать рекламу в файле. 1 - отображение рекламы (по умолчанию), 0 - скрытие рекламы.

Пример зароса:

В ответе возвращается номер заказа в ключе order_id и ссылка на скачивание в ключе download_url в случае если ссылка доступна сразу после покупки.

Пример ответа: