A TVDB API használata a HTTPie-jal

TheTVDB_hu.md

TheTVDB

API dokumentáció

Lásd: https://api.thetvdb.com/swagger

Hitelesítés

JSON Web Token (JWT) révén történik. Lásd:

• Michael B. Jones, John Bradley, Nat Sakimura. JSON Web Token (JWT). RFC 7797. May 2015.
• https://jwt.io/

JWT token kérése a hitelesítéshez:

http https://api.thetvdb.com/login apikey=<api-key> userkey=<unique-id> username=<username> -v

Itt találhatók a fenti parancsban megadásra kerülő azonosítók (bejelentkezés szükséges): https://www.thetvdb.com/member/api

A válasz üzenettörzse tartalmazza a tokent, melyet helyezzünk el a TheTVDB.jwt állományba.

A további kérésekben az Authorization fejlécmezőben kell visszaküldeni a tokent, mint például:

http https://api.thetvdb.com/search/series "Authorization: Bearer $(<TheTVDB.jwt)" name=="The Big Bang Theory" -v

A --session parancssori opció révén elérhető, hogy a további kérésekbe automatikusan beillesztésre kerüljön a token:

rm -f TheTVDB.json
http --session=./TheTVDB.json https://api.thetvdb.com/search/series "Authorization: Bearer $(<TheTVDB.jwt)" name=="The Big Bang Theory" -v
cat TheTVDB.json
http --session=./TheTVDB.json https://api.thetvdb.com/search/series name=="Game of Thrones" -v

Az API használata

http --session=./TheTVDB.json https://api.thetvdb.com/languages
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/filter keys==id,seriesName,firstAired,overview
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/filter keys==id,seriesName,firstAired,overview Accept-Language:hu
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/filter keys==id,seriesName,firstAired,overview Accept-Language:fr
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/filter keys==id,seriesName,firstAired,overview Accept-Language:zh
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/actors
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/episodes/summary
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/episodes
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/episodes page==2
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/episodes page==3
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/episodes/query/params
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/episodes/query airedSeason==1
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/episodes/query airedSeason==1 airedEpisode==1
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/episodes/query airedEpisode==1
http --session=./TheTVDB.json https://api.thetvdb.com/episodes/332484
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/images
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/images/query/params
http --session=./TheTVDB.json https://api.thetvdb.com/series/80379/images/query keyType==poster
date -d 2019-09-28 +%s
http --session=./TheTVDB.json https://api.thetvdb.com/updated/query fromTime==$(date -d 2019-09-28 +%s) -v