Получить ключ API

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

Начните с быстрого старта, чтобы сделать первый вызов за две минуты. Затем прочитайте, как работают ключи, лимиты запросов, ошибки, языки и изображения. amodb сохраняет пути и JSON TMDB v3 и OMDb, поэтому большинство страниц объясняют, что совпадает, что добавляет amodb и в каких немногих местах он отличается.

Обновлено Открыть в Markdown

Первый запрос
bashjspyphpgo 
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
const data = await res.json();
import os
import requests

res = requests.get(
    "https://api.amodb.dev/3/movie/550",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
data = res.json()
<?php
$ch = curl_init("https://api.amodb.dev/3/movie/550?language=en-US");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("AMODB_KEY")],
]);
$data = json_decode(curl_exec($ch), true);
req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/movie/550?language=en-US", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()

var data map[string]any
json.NewDecoder(res.Body).Decode(&data)

Базовые URL

НазначениеБазовый URLПараметр ключа
В стиле TMDB v3https://api.amodb.dev/3api_key или Authorization: Bearer
В стиле OMDbhttps://api.amodb.dev/omdb/apikey
Изображенияhttps://img.amodb.dev/t/p/{size}/{file}нет
Каталог тарифовhttps://api.amodb.dev/plansнет

С чего начать

  • Быстрый старт

    Первый вызов amodb: получите ключ, запросите детали фильма через curl, JavaScript, Python, PHP или Go и загрузите постер с img.amodb.dev. Меньше 2 минут.

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

    Как передать ключ amodb: api_key в запросе, заголовок Authorization Bearer или apikey для вызовов OMDb. Формат ключа, хранение, ротация и ошибки 401.

  • Лимиты запросов

    amodb ограничивает ключ запросами в минуту в скользящем окне 60 секунд: 20, 40 или 120 по тарифу. Читайте заголовки лимита и обрабатывайте 429 с Retry-After.

Основные понятия

  • Ошибки

    Все ошибки amodb: HTTP-статус, status_code и сообщение TMDB, а также формат ошибки OMDb. Что означает каждая и что должен делать ваш клиент дальше.

  • Языки

    amodb отдает названия, описания и имена на 14 языках. Передайте в language тег в стиле TMDB, например ru-RU или pt-BR; другие теги откатываются на английский.

  • Изображения

    Загружайте постеры, фоны и фото людей с img.amodb.dev по путям и размерам TMDB от w92 до original. Без ключа, кэш на 30 дней, один шаблон URL для всех.

Ресурсы

  • Журнал изменений

    Список изменений API amodb, хоста изображений img.amodb.dev, тарифов и сайта по датам. Новые записи сверху: что изменилось и что нужно сделать вам.

  • Статус

    Как проверить, работает ли amodb: публичный эндпоинт health, коды ошибок, указывающие на сбой, и как сообщить о проблеме со всеми нужными нам подробностями.

Справочник API

Все эндпоинты

Фильмы

Сериалы

Люди

Поиск и списки

Расширения amodb

В стиле OMDb

Руководства

Все руководства

Другие руководства и разделы

  • Сравнения amodb

    Сравнения amodb с другими API метаданных фильмов и сериалов: совместимость, языки, лимиты, изображения и цены, с числами, которые можно проверить.

  • Сценарии использования

    Как команды применяют amodb для данных о фильмах и сериалах: каталоги, медиасерверы, рекомендации, боты и исследования, с нужными эндпоинтами и лимитами.