API V2.x Discussion

A place for developers to advertise their TheTVDB.com enabled app and get help from other developers with the API.
MattS
Posts: 221
Joined: Sat Mar 27, 2010 12:17 am
Contact:

Re: API V2.x Discussion

Postby MattS » Mon Nov 21, 2016 7:43 am

Quick update, we'll be pushing a change to beta today that adds the lastUpdated field to the basic results returned from the /series/:id/episodes endpoint. As long as no issues are found, this will go out to prod in a day or so as well.

More info: https://trello.com/b/7zl7PE1j/api-2-x-f ... -bug-fixes

MattS
Posts: 221
Joined: Sat Mar 27, 2010 12:17 am
Contact:

Re: API V2.x Discussion

Postby MattS » Wed Nov 30, 2016 8:35 am

MattS wrote:Quick update, we'll be pushing a change to beta today that adds the lastUpdated field to the basic results returned from the /series/:id/episodes endpoint. As long as no issues are found, this will go out to prod in a day or so as well.

More info: https://trello.com/b/7zl7PE1j/api-2-x-f ... -bug-fixes


This change is live on the production api now.

wenkel
Posts: 6
Joined: Wed Oct 05, 2016 12:10 am

Re: API V2.x Discussion

Postby wenkel » Sun Dec 11, 2016 4:14 am

Can someone explain to me how exactly the versioning of the API works? Here: https://api.thetvdb.com/swagger it says that it's v2.1.1 . Trello shows me higher versions? Are they released somewhere else? Are they beta releases?

Are there braking changes between them?

konti
Posts: 2
Joined: Wed Oct 05, 2016 12:51 am

Re: API V2.x Discussion

Postby konti » Sun Dec 11, 2016 7:24 am

ryko wrote:
MattS wrote:
ryko wrote:Hello,

Is there a way to get /series/{id}/images/query to return a summary of episode thumbnails for a given season? I've been playing around with the API, and it seems like the only way to get the thumbnail data is through individual calls to /episodes/{id}, which I'm not too fond of (with respect to TVDB's servers).


Could you elaborate on what data you're looking for there? Is it a count of the thumbnails, a list of urls, or something else?



Hello,

For a given season, I wish to obtain all the episode summaries and thumbnail (if there is one). I can make a single call to the API to get the episode summaries. However, I haven't found a way to get the URL to the episode thumbnails without actually hitting the API for each episode through /episodes/{id}. It would be great if the /series/{id}/images/query can be used to return a list of URLs for all available episode thumbnails for a given season. If that function is available, I can call the API twice to get all the data I need instead of calling it for each episode.


I've added a comment to Trello on an existing ticket which actually comes from this request. Has this request ever been registered on Trello, as I couldn't find it.

Is this okay? Or should I still request for a new ticket?
https://trello.com/c/VH3uGCV8/18-return ... firstaired

MattS
Posts: 221
Joined: Sat Mar 27, 2010 12:17 am
Contact:

Re: API V2.x Discussion

Postby MattS » Sun Dec 11, 2016 11:11 am

wenkel wrote:Can someone explain to me how exactly the versioning of the API works? Here: https://api.thetvdb.com/swagger it says that it's v2.1.1 . Trello shows me higher versions? Are they released somewhere else? Are they beta releases?

Are there braking changes between them?


That's my fault, forgot to bump the version in the swagger docs to match the release version. Trello is the authoritative source for the versions deployed

.
konti wrote:
I've added a comment to Trello on an existing ticket which actually comes from this request. Has this request ever been registered on Trello, as I couldn't find it.

Is this okay? Or should I still request for a new ticket?
https://trello.com/c/VH3uGCV8/18-return ... firstaired


Yup, that's fine, I can see your comment.

vankasteelj
Posts: 7
Joined: Tue Feb 09, 2016 11:57 am

Re: API V2.x Discussion

Postby vankasteelj » Mon Jan 30, 2017 7:36 pm

Hello, is there some way to get episode image through the API ? I don't seem to be able to. series/images/query/params returns [fanart,poster,season,seasonwide,series], but no episode? That's was like the best call for me when using v1

Sidenote : is v1 still available if there is no episode-specific image calls yet?

PS : https://www.npmjs.com/package/tvdbapi is now available

n0rua
Posts: 45
Joined: Tue Apr 22, 2014 12:01 pm

Re: API V2.x Discussion

Postby n0rua » Mon May 29, 2017 11:46 am

I have a question: in v1, if I retrieved a series data, among the various data, there were fanart, poster and banner paths.
Now with v2, I see just the banner path.

Is there any quick way to retrieve the poster of a specific Show (the one that has currently the best votes/ratio)?

mlaggner
Posts: 9
Joined: Sun May 19, 2013 12:31 pm

Re: API V2.x Discussion

Postby mlaggner » Mon May 29, 2017 1:19 pm

according to the docs at https://api.thetvdb.com/swagger#!/Serie ... ages_query there should be a languageId in the image response, but unfortunately I cannot find this tag in my test cases

https://api.thetvdb.com/series/83462/im ... ype=poster

Code: Select all

data": [
    {
      "id": 42756,
      "keyType": "poster",
      "subKey": "",
      "fileName": "posters/83462-1.jpg",
      "resolution": "680x1000",
      "ratingsInfo": {
        "average": 4.4,
        "count": 17
      },
      "thumbnail": "_cache/posters/83462-1.jpg"
    }, ...
]
Creator of tinyMediaManager

mlaggner
Posts: 9
Joined: Sun May 19, 2013 12:31 pm

Re: API V2.x Discussion

Postby mlaggner » Sun Jun 04, 2017 1:04 am

another small finding / feature request:

at the moment you provide the banner url along with a search response - but most applications do not provide banners along with search results, they rather use a poster for visualization.
Could you add the poster file name (probably the highest voted poster?) along with the search result. https://api.thetvdb.com/swagger#!/Searc ... rch_series

thanks
Creator of tinyMediaManager

knossos
Posts: 9
Joined: Thu Oct 15, 2015 4:53 am

Re: API V2.x Discussion

Postby knossos » Sat Jul 08, 2017 4:58 pm

What secret is used for checking the JWT signature? I've tried various things such as tvdb's cert public key, the user's password, the user's account id, etc, and none seem to work.