API для разработчиков

Получайте лучшие обложки, логотипы, иконки и фоны для настольных игр одним запросом. По внутреннему ID или ID BoardGameGeek и Tesera.

Получить ключДокументация (OpenAPI)

Как начать

  1. Зарегистрируйтесь и создайте ключ в настройках.
  2. Передавайте ключ в заголовке Authorization: Bearer КЛЮЧ.
  3. Вызывайте /api/v1/games/best — и получайте URL картинок.

Примеры

Лучшие ассеты по BGG ID
curl -H "Authorization: Bearer bgd_…" \
  "https://5e7889afa424.vps.myjino.ru/api/v1/games/best?platform=bgg&ids=174430,167791&types=cover,logo,icon&aspect=1:1&lang=ru"
{
  "success": true,
  "data": [
    { "id": "174430", "gameId": 12, "status": 200,
      "assets": {
        "cover": { "id": 345, "url": "https://…/o/cover/ab/….jpg", "variants": { "1024x1024": "https://…webp" }, "thumb": "https://…_300.webp", … },
        "logo":  { … }, "icon": { …, "ico": "https://…/i/….ico" }
      } }
  ]
}
Все обложки игры
GET https://5e7889afa424.vps.myjino.ru/api/v1/covers/game/12?aspects=1:1,2:3&styles=official&sort=score&limit=25
GET https://5e7889afa424.vps.myjino.ru/api/v1/covers/by/bgg/174430?language=ru,none
Загрузка логотипа
curl -H "Authorization: Bearer bgd_…" -F game_id=12 -F style=white -F language=ru \
  -F file=@logo.png "https://5e7889afa424.vps.myjino.ru/api/v1/logos"

Лимиты

По умолчанию 120 запросов в минуту и 5000 в сутки на ключ. Для интеграций с большим объёмом напишите нам — есть партнёрский тариф.

Типы ассетов

Размеры, группы пропорций и стили доступны программно: GET /api/v1/meta/asset-types.

Лицензия контента

Контент загружен пользователями и предоставляется «как есть» для некоммерческого использования. Указывайте автора (username) и ссылку на ассет, где это возможно.