Як атрымаць ключ, сумяшчальны з TMDB, за чатыры крокі
amodb прадае ключы для ўласнага API, якое захоўвае шляхі і JSON TMDB v3. Гэта не ключ ад TMDB, і ён не працуе на api.themoviedb.org. Вы атрымліваеце ключ той жа формы, 32 малыя шаснаццатковыя сімвалы, які ваш кліент TMDB прымае пасля адной змены базавага URL.
- Адкрыйце старонку з цэнамі і абярыце план: 20, 40 або 120 запытаў у хвіліну. Кожны план вяртае ўсе даныя.
- Увайдзіце, указаўшы email. amodb адпраўляе 6-значны код, які дзейнічае 10 хвілін. Пароля няма.
- Аплаціце картай, праз Apple Pay або Google Pay на перыяд ад 1 да 24 месяцаў. Аўтаматычнага працягу няма.
- Адкрыйце Акаўнт, затым Ключы API і стварыце ключ. Скапіруйце яго адразу, бо поўны ключ паказваецца адзін раз.
Гэтыя крокі займаюць каля хвіліны, а ключ пачынае працаваць, як толькі плацёж пацверджаны.
Выкарыстанне ключа: змяніце базавы URL
Пакіньце свой код для TMDB і змяніце два значэнні: базавы URL і ключ. Працуюць абодва спосабы перадачы ключа: api_key у запыце і загаловак Authorization: Bearer.
# TMDB
curl "https://api.themoviedb.org/3/movie/550?api_key=$TMDB_KEY"
# amodb
curl "https://api.amodb.dev/3/movie/550?api_key=$AMODB_KEY"Той жа выклік з загалоўкам Bearer на трох мовах:
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}` },
});
if (!res.ok) throw new Error(`amodb ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);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,
)
res.raise_for_status()
movie = res.json()
print(movie["title"], movie["release_date"])Адказ мае фармат TMDB v3:
{
"id": 550,
"imdb_id": "tt0137523",
"title": "Fight Club",
"release_date": "1999-10-15",
"runtime": 139,
"genres": [{ "id": 18, "name": "Drama" }],
"vote_average": 8.4,
"poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}Чытайце images.secure_base_url з /3/configuration, каб спасылкі на постэры паказвалі на img.amodb.dev. Выявам ключ не патрэбны. Больш пра перадачу ключа на старонцы аўтэнтыфікацыя, а падрабязнае пакрокавае кіраўніцтва ў хуткім старце.
Бясплатны ключ TMDB і ключ amodb: параўнанне
Правільны выбар залежыць ад вашага праекта і ўмоў, а не ад спісу функцый. Слупок TMDB толькі паўтарае тое, што TMDB публікуе ў агульным выглядзе. Актуальныя правілы глядзіце ва ўмовах і дакументацыі TMDB.
| Бясплатны ключ TMDB | Ключ amodb | |
|---|---|---|
| Цана | Бясплатна для прыдатнага выкарыстання па ўмовах TMDB | Платна, аплата наперад на перыяд ад 1 да 24 месяцаў, без пробнага перыяду |
| Як атрымаць | Акаўнт TMDB і запыт ключа на сайце TMDB | Email, 6-значны код, аплата, потым стварэнне ключа ў акаўнце |
| Камерцыйнае выкарыстанне | Праверце ўмовы TMDB наконт камерцыйнага выкарыстання і ўказання аўтарства | Дазволена ўмовамі amodb |
| Ліміт запытаў | Задае TMDB, глядзіце іх дакументацыю | 20, 40 або 120 запытаў у хвіліну ў залежнасці ад плана |
| Даныя | Даныя TMDB | Фармат TMDB v3, плюс ratings, moods, soundtracks, wikidata і showtimes праз append_to_response |
| Фармат ключа | Ключ v3, 32 шаснаццатковыя сімвалы | 32 малыя шаснаццатковыя сімвалы |
| Базавы URL | https:/ | https:/ |
| Метады запісу | Метады акаўнта, спісаў і ацэнак | Не прапануюцца, адказваюць 405 |
Калі хопіць бясплатнага ключа TMDB
Заставайцеся на бясплатным ключы TMDB для асабістага ці вучэбнага праекта, які адпавядае ўмовам TMDB. Калі ваш выпадак падыходзіць, TMDB нічога не каштуе, і з гэтым amodb параўнацца не можа.
Выбірайце ключ amodb, калі праект камерцыйны і вам патрэбна платнае пагадненне, калі патрэбен фіксаваны ліміт у хвіліну, пад які можна планаваць, або калі старонка фільма павінна атрымліваць рэйтынгі з пяці крыніц адным выклікам. Спачатку праверце, чаго няма: метады запісу, стужкі changes і некалькі іншых шляхоў не прапануюцца. Яны пералічаны на старонцы альтэрнатыва TMDB API і ў матэрыяле amodb супраць TMDB.
Камерцыйнае выкарыстанне і ліміты
Камерцыйнае выкарыстанне дазволена ў адпаведнасці з умовамі amodb. Вы можаце паказваць даныя ў сваіх праграмах, на сайтах, у ботах і ўнутраных інструментах, а таксама кэшаваць адказы, каб эканоміць запыты. Нельга перапрадаваць неапрацаваны доступ да API, публікаваць масавыя выгрузкі, перадаваць ключы іншым і адкрываць дадатковыя акаўнты, каб павысіць ліміт. Поўны спіс прыведзены ў правілах дапушчальнага выкарыстання.
Ліміт задае план. Кожны адказ змяшчае X-RateLimit-Limit, X-RateLimit-Remaining і X-RateLimit-Reset, а адказ 429 дадае Retry-After. Падрабязнасці на старонцы ліміты запытаў.