/v1/offers/accounts, /v1/offers/currency
и так далее — со своими полями. Вы интегрируетесь только с теми категориями,
в которых продаёте, и новая категория на площадке ваши не затронет.
Это публичная часть API. Экраны кабинета продавца — выплаты, споры,
настройки аккаунта — в неё не входят, и API-ключ до них не дотягивается.
Оффер — это одно объявление на маркетплейсе. В API они называются offers,
и ниже тоже.
Базовый URL
/v1/....
Первый запрос
1
Создайте ключ
В кабинете продавца откройте Продавец → API-ключи и создайте ключ. Он
показывается один раз — скопируйте его сразу, прочитать его потом нельзя.
2
Отправьте его
Ключ передаётся в заголовке
Authorization каждого запроса. Обменивать
его ни на что не нужно.3
Узнайте поля категории
Что принимает вызов создания в категории, описано на её странице
справочника: у оффера аккаунта есть цена и картинки, у оффера валюты —
продукт и остаток. От игры зависят Этот путь принимает
attributes, и их отдаёт эндпоинт
схемы: поля, их типы и какие из них обязательны.slug игры. Остальные пути каталога адресуют игру по
id, который возвращает GET /v1/offers/games, — на slug они ответят 400.Чтение каталога публичное — его можно изучить ещё до получения ключа.Статусы
Новый оффер —draft: он ваш, и никто другой его не видит. publish делает
его active, и с этого момента его можно купить — предварительной проверки
нет. Опубликовать оффер, которому нечего продать, нельзя — ответ 409:
сначала добавьте остаток. Редактирование не меняет статус: active остаётся
в продаже, draft остаётся черновиком.
paused тоже в ваших руках — через pause и unpause. archived — конечная
точка: DELETE снимает оффер насовсем, но вы по-прежнему можете его читать.
reserved и sold меняются заказами, а не вызовами. removed — снятие
модерацией постфактум, ни один вызов этого API его не выполняет.
Цены
Все цены в API — целые числа в центах США.price: 4990 — это $49.90.
Дробных сумм нет, единственная валюта — USD.
Что дальше
Аутентификация
Ключи, списки разрешённых адресов, лимиты и что означают ошибки.
Справочник API
Все эндпоинты и песочница, из которой можно отправлять живые запросы.