Каталог брендов (Brands)
API брендов позволяет получать справочник вендоров, издателей игр и провайдеров сервисов (например, Moonton, Hoyoverse, Steam, Riot Games), для которых в вашем workspace есть доступные офферы.
Для каждого бренда доступны:
- Уникальный идентификатор
id(UUID) и текстовыйslug. - Человекочитаемое название
title. - Мультиязычное описание
description(ru,enи др.). - Метаданные логотипа
logo(прямой URL к CDN, размеры и alt-текст). - Мультиязычный структурированный список часто задаваемых вопросов
faq, сгруппированный по языкам ({ ru: [...], en: [...] }). - Список доступных для вашего workspace типов продуктов бренда
products([{ id, slug, title }]). - Дата создания
created_atи дата обновленияupdated_at.
1. Список брендов: GET /v1/brands
Заголовок раздела «1. Список брендов: GET /v1/brands»Возвращает пагинированный список брендов с доступными для текущего workspace офферами, с возможностью фильтрации и поиска по названию и слагу.
curl -X GET "https://api.dandanpay.net/v1/brands?limit=20&offset=0&search=moonton" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"const response = await fetch('https://api.dandanpay.net/v1/brands?limit=20', { headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'application/json', },});const data = await response.json();console.log(data.results);Параметры запроса (Query Parameters)
Заголовок раздела «Параметры запроса (Query Parameters)»| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
limit |
integer | 50 |
Количество записей на странице (максимум 100) |
offset |
integer | 0 |
Смещение для постраничной пагинации |
search |
string | — | Поисковый запрос (поиск по подстроке в title и slug без учёта регистра) |
Формат ответа 200 OK
Заголовок раздела «Формат ответа 200 OK»{ "total": 1, "limit": 20, "offset": 0, "results": [ { "id": "0199c440-149f-7c57-9c79-f31e3bf31ffc", "slug": "moonton", "title": "Moonton", "description": { "ru": "Международный разработчик и издатель мобильных игр, наиболее известный по MOBA-хиту Mobile Legends: Bang Bang.", "en": "International mobile game developer and publisher, best known for the MOBA hit Mobile Legends: Bang Bang." }, "logo": { "url": "https://cdn.example.com/brands/moonton.png", "alt": "Логотип Moonton", "width": 256, "height": 256 }, "faq": { "ru": [ { "question": "Как активировать алмазы в Mobile Legends?", "answer": "Пополнение происходит автоматически по вашему User ID и Server ID (Zone ID). Зайдите в профиль игры для уточнения данных." }, { "question": "Сколько времени занимает доставка?", "answer": "Доставка большинства товаров бренда Moonton осуществляется мгновенно (в течение 1-2 минут)." } ], "en": [ { "question": "How to activate diamonds in Mobile Legends?", "answer": "Top-up is processed automatically using your User ID and Server ID (Zone ID)." } ] }, "products": [ { "id": "019aca0a-269b-77bf-aa77-a05ddfd7c3e7", "slug": "crystals", "title": "Кристаллы" }, { "id": "019addf8-df00-7dac-a79d-1494d7a1ae04", "slug": "topup", "title": "Topup" } ], "created_at": "2025-11-28T16:22:22.699Z", "updated_at": "2026-09-16T13:30:00.000Z" } ]}2. Детальная карточка бренда: GET /v1/brands/{idOrSlug}
Заголовок раздела «2. Детальная карточка бренда: GET /v1/brands/{idOrSlug}»Возвращает детальную информацию о бренде. В качестве параметра {idOrSlug} можно передавать как UUID бренда, так и его уникальный slug.
curl -X GET "https://api.dandanpay.net/v1/brands/moonton" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"curl -X GET "https://api.dandanpay.net/v1/brands/0199c440-149f-7c57-9c79-f31e3bf31ffc" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"Формат ответа 200 OK
Заголовок раздела «Формат ответа 200 OK»{ "id": "0199c440-149f-7c57-9c79-f31e3bf31ffc", "slug": "moonton", "title": "Moonton", "description": { "ru": "Международный разработчик и издатель мобильных игр, наиболее известный по MOBA-хиту Mobile Legends: Bang Bang.", "en": "International mobile game developer and publisher, best known for the MOBA hit Mobile Legends: Bang Bang." }, "logo": { "url": "https://cdn.example.com/brands/moonton.png", "alt": "Логотип Moonton", "width": 256, "height": 256 }, "faq": { "ru": [ { "question": "Как активировать алмазы в Mobile Legends?", "answer": "Пополнение происходит автоматически по вашему User ID и Server ID (Zone ID)." }, { "question": "Сколько времени занимает доставка?", "answer": "Доставка большинства товаров бренда Moonton осуществляется мгновенно (в течение 1-2 минут)." } ], "en": [ { "question": "How to activate diamonds in Mobile Legends?", "answer": "Top-up is processed automatically using your User ID and Server ID (Zone ID)." } ] }, "products": [ { "id": "019aca0a-269b-77bf-aa77-a05ddfd7c3e7", "slug": "crystals", "title": "Кристаллы" }, { "id": "019addf8-df00-7dac-a79d-1494d7a1ae04", "slug": "topup", "title": "Topup" } ], "created_at": "2025-11-28T16:22:22.699Z", "updated_at": "2026-09-16T13:30:00.000Z"}Структура объекта бренда
Заголовок раздела «Структура объекта бренда»| Поле | Тип | Описание |
|---|---|---|
id |
UUID | Уникальный идентификатор бренда |
slug |
string | Уникальный буквенно-цифровой идентификатор (например, mlbb, telegram, steam) |
title |
string | Человекочитаемое название бренда |
description |
object | Словарь мультиязычных описаний в формате {"ru": "...", "en": "..."} |
logo |
object | null | Метаданные логотипа бренда (см. таблицу ниже) |
faq |
object | Словарь мультиязычных списков вопросов и ответов в формате {"ru": [{ "question": "...", "answer": "..." }]} |
products |
array | Список доступных типов продуктов бренда ([{ id, slug, title }]) |
created_at |
ISO 8601 | Дата создания записи |
updated_at |
ISO 8601 | Дата последнего обновления |
Поля элемента products[]
Заголовок раздела «Поля элемента products[]»| Поле | Тип | Описание |
|---|---|---|
id |
UUID | Уникальный идентификатор типа продукта (принимается как product_id в POST /v1/orders/validate) |
slug |
string | Символьный код продукта (соответствует product_slug в GET /v1/offers и принимается как product_id в POST /v1/orders/validate) |
title |
string | Название типа продукта |
Поля объекта logo
Заголовок раздела «Поля объекта logo»| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
url |
string | Да | Прямой URL к изображению логотипа (SVG, WebP, PNG) |
alt |
string | Нет | Текстовое описание для атрибута alt (доступность и SEO) |
width |
number | Нет | Базовая ширина логотипа в пикселях |
height |
number | Нет | Базовая высота логотипа в пикселях |