Farm Together оптом: коды для магазинов по одному API
15 различных продуктов, 15 позиций к продаже, если считать каждый заказываемый вариант отдельно. Заказ возвращает код, который покупатель активирует на стороне издателя. Это описание поставки для магазинов: чекаута на странице нет, розничной цены — тоже.
GLOBAL
Линейка продуктов
Все различные названия продуктов этого тайтла в порядке линейки. Каждая строка называет продукт в B2B-каталоге по тому id, который отдаёт этот эндпоинт; название, которое несут несколько заказываемых позиций, здесь одна строка, а там несколько.
| Продукт | B2B id | Слаг товара |
|---|---|---|
| Candy Pack | 170447367 | candy-pack |
| Celery Pack | 108626762 | celery-pack |
| Chickpea Pack | 170447361 | chickpea-pack |
| Fantasy Pack | 170447369 | fantasy-pack |
| Ginger Pack | 170447360 | ginger-pack |
| Laurel Pack | 170447368 | laurel-pack |
| Mistletoe Pack | 170447362 | mistletoe-pack |
| Oregano Pack | 170447365 | oregano-pack |
| Oxygen Pack | 108626761 | oxygen-pack |
| Paella Pack | 170447366 | paella-pack |
| Standard | 108159324 | standard |
| Sugarcane Pack | 170447363 | sugarcane-pack |
| Supporters Pack | 170447359 | supporters-pack |
| Wasabi Pack | 108626760 | wasabi-pack |
| Wedding Pack | 170447364 | wedding-pack |
Как закрывается заказ
Выдача — код: заказ возвращает строку для активации — подарочную карту, ключ, ваучер на пополнение, — а дальше покупатель активирует её сам на странице издателя. Игровой ID для таких позиций не собирается: чекаут короче, и заказ спокойно оформляется в подарок другому человеку. Коды берутся со склада, поэтому честное ограничение здесь не скорость, а наличие: позиция либо есть, либо её нет, и каталог показывает, что именно. Покажите код один раз, сохраните его у себя и относитесь к нему как к наличным — открытый код нельзя отозвать, заменить или вернуть.
Регионы
Метки регионов берутся прямо со строк поставщика за этим тайтлом. Доступность — по вашему аккаунту: список разрешённых регионов применяется и при чтении каталога, и при создании заказа.
Прочитать из API
Два вызова: тайтл, затем его товары. Оба принимают ваш ключ, и ни один не отдаст того, что вашему аккаунту продавать нельзя.
# the title and its categoriescurl -s https://api.gamecore-api.tech/b2b/catalog/games/farm-together \-H 'X-Api-Key: gc_live_…'# every position you may sell, priced for your accountcurl -s https://api.gamecore-api.tech/b2b/catalog/games/farm-together/products \-H 'X-Api-Key: gc_live_…'
Первая строка линейки выше — это платформенный id товара 170447367 (слаг candy-pack). Страница показывает весь платформенный каталог тайтла, а второй ответ отфильтрован по тому, что разрешено продавать вашему аккаунту, — поэтому конкретного id в нём может не оказаться.
Вопросы магазинов
Похожая поставка
Тайтлы сравнимой глубины каталога с той же механикой выдачи.
Получить ключ и читать живой каталог
Один договор, одна интеграция и весь каталог поставки за ней. Напишите объём и какие тайтлы важны — доступ выдаём на онбординге.