🎵 DBMedia
Войти
REST API v1.0

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

Полное руководство по использованию DBMedia API для интеграции с вашими приложениями, плагинами Jellyfin/Kodi и сторонними сервисами.

Введение

DBMedia API предоставляет доступ к базе данных артистов, альбомов и треков в формате JSON. Все эндпоинты доступны по базовому URL:

Base URL: https://dbmedia.o-24.ru/api

Аутентификация

Большинство эндпоинтов работают без аутентификации, но с более строгими лимитами. Для повышенных лимитов используйте Bearer-токен:

Способ 1: Заголовок Authorization (рекомендуется)

GET /api/artists
Authorization: Bearer YOUR_API_TOKEN

Способ 2: Query-параметр

GET /api/artists?api_token=YOUR_API_TOKEN

Создать и просмотреть токен можно в разделе Настройки профиля. Токен показывается только один раз!

Лимиты и ошибки

Тип пользователя Общие запросы Поиск
Гость (без токена) 60 / мин по IP 20 / мин по IP
С токеном 300 / мин 60 / мин

При превышении лимита API вернёт ответ:

HTTP 429 Too Many Requests
{
  "message": "Too Many Requests.",
  "retry_after": 45
}

Заголовки ответа X-RateLimit-Limit, X-RateLimit-Remaining и Retry-After помогут вам контролировать использование.

GET /api/artists

Получить список всех артистов с пагинацией.

Параметры запроса:

page — номер страницы (по умолчанию: 1)
limit — записей на странице (1-100, по умолчанию: 20)

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

{
  "data": [
    {
      "id": 3882,
      "name": "The Beatles",
      "type": "group",
      "origin": "Liverpool, UK",
      "views": 15420
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 245,
    "per_page": 20,
    "total": 4892
  }
}
GET /api/artists/{id}

Получить детальную информацию об артисте, включая его альбомы, треки и участников (для групп).

Параметры пути:

id — ID артиста (обязательно)

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

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://dbmedia.o-24.ru/api/artists/3882
GET /api/albums

Получить список альбомов с информацией об артисте и обложкой.

Параметры запроса:

page — номер страницы
limit — записей на странице (макс. 100)
GET /api/albums/{id}

Детальная информация об альбоме: артист, треки, жанры, стили, изображения.