Отримати ключ 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: публічний ендпоінт стану, коди помилок, що вказують на інцидент, і як повідомити про проблему з потрібними нам подробицями.

Довідник API

Усі ендпоінти

Фільми

Серіали

Люди

Пошук і списки

Розширення amodb

У стилі OMDb

Посібники

Усі посібники

Інші посібники та розділи

  • Порівняння amodb

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

  • Сценарії використання

    Як команди використовують amodb для даних про фільми й серіали: каталоги, медіасервери, рекомендації, боти та дослідження, з ендпоінтами й лімітами для кожного.