V3 Testing

A place for developers to advertise their TheTVDB.com enabled app and get help from other developers with the API.
ChristyEzzell
Posts: 896
Joined: Tue Feb 26, 2019 12:01 pm

Wed Oct 16, 2019 4:03 pm

Dear Developers,

We wanted to reach out and thank you from being a valued member of TheTVDB community. It's our goal to be the preferred and most accurate site for movie and film metadata and your participation in that endeavor is invaluable. To that end, we would like to extend you an invitation to test the latest version of the site - https://beta.thetvdb.com/

We have made some significant improvements, including:

Enhanced stability
Performance optimization
Flexible seasons
A new "people" table
More specifics are available in our V3 forum

These improvements are designed to aid our partners/users use of the site. We've made these systems backwards compatible via our new API. Our goal is to start rolling out the new API on 10/30/19 and we would greatly appreciate if you would be willing to test our API endpoints before then and get your feedback in advance of launch so that we can assure our users the best experience possible.

Here are the endpoints:
V1 - https://beta.thetvdb.com/api
V2 - https://api-beta.thetvdb.com

Any questions or concerns, please don't hesitate to post here.

TheTVDB Team
User avatar
szsori
Site Admin
Posts: 2242
Joined: Fri Nov 03, 2006 2:23 pm

Mon Oct 21, 2019 2:04 pm

Just an update on this. One Kodi developer signed off on the change and we previously had Plex and Trakt sign off, although they're doing some additional testing now. We've yet to hear back from Emby, Jellyfin, and everyone else. Given that Plex and Kodi comprise a large portion of our traffic, we'll be moving forward with launch unless we hear back on any issues from other developers. This is your chance to get in there and make sure it works. Please let us know ASAP if you run into issues.
Salvidrim
Posts: 15
Joined: Tue Sep 08, 2015 5:04 pm

Fri Oct 25, 2019 8:49 am

What about your employer TVTime? There are unresolved import issues this week which I assume are related to testing the new API...
https://twitter.com/Salvidrim/status/1187584569891004421 wrote:updates added on TVDB Wednesday have been imported into TVTime last night (series ID #331355, #334816), however several updates added Monday-Tuesday have not yet been synced (series ID #351214, #290854, #253001, #83620, #266508).
still unresolved, still same series IDs as my last tweet above. Updates from Monday-Tuesday on @thetvdb still not imported in @tvshowtime, updates from Thursday imported fine.
I assume the support account hasn't responded because this is still being investigated, I'm just keen to make sure this is adressed before release :)
~ Ben Salvidrim
TVDB & Wikipedia longtime editor and TVTime user
ChristyEzzell
Posts: 896
Joined: Tue Feb 26, 2019 12:01 pm

Fri Oct 25, 2019 1:25 pm

For any TV Time related support issues please contact [email protected]
Salvidrim
Posts: 15
Joined: Tue Sep 08, 2015 5:04 pm

Fri Oct 25, 2019 3:14 pm

ChristyEzzell wrote:
Fri Oct 25, 2019 1:25 pm
For any TV Time related support issues please contact [email protected]
Thanks for the guidance, yes I am aware of how to get help for the TV Time app. This thread is about V3 API issues that are arising, which seems to be impacting database syncs.

---------------

As for my above, some of the missing data has been imported since my last post (series IDs #290854, #253001) but some are still not being importable (#83620, #266508), so I assume this API fix is still an ongoing process. Not sure what backend change could have affected specifically these changes performed October 21st, while earlier and later changes which are both importing just fine in the API
~ Ben Salvidrim
TVDB & Wikipedia longtime editor and TVTime user
ChristyEzzell
Posts: 896
Joined: Tue Feb 26, 2019 12:01 pm

Fri Oct 25, 2019 4:18 pm

Sorry, maybe I misunderstood your question. Are you seeing differences on this show between the beta site -- https://beta.thetvdb.com/ and the production site -- https://www.thetvdb.com/? We are running a nightly import of content from the production site into beta, so it is possible you hit discrepancies in the data at one of those times.
Salvidrim
Posts: 15
Joined: Tue Sep 08, 2015 5:04 pm

Fri Oct 25, 2019 4:55 pm

No, the episodes are on both https://beta.thetvdb.com/ & https://www.thetvdb.com/. Anyways this isn't the "V3 Website feedback" thread, this is about the API

Via API some episodes updated Oct.21st are not being synced (even though episodes updated later & earlier are synced fine).

Since episodes for some the series IDs I provided above seem to have been fixed in the middle of the day after me reporting it, it seems the API fix is still ongoing.

Example episode IDs: #7414212, #7414211
~ Ben Salvidrim
TVDB & Wikipedia longtime editor and TVTime user
tripmckay
Posts: 32
Joined: Sat Jan 07, 2012 8:40 am
Contact:

Tue Oct 29, 2019 11:43 pm

Thanks for notifying! (Although 2 weeks is a really short lead time.)

The test suite for thetvdb-java (https://github.com/UweTrottmann/thetvdb-java), which implements API v2.2.0, passes using `api-beta.thetvdb.com` (https://circleci.com/gh/UweTrottmann/thetvdb-java/32).

There is just one regression that may be of interest (but maybe is intentional): when calling the episode endpoint with an invalid language code, like `xx`, it used to return an error response and no data. Using the beta it returns the English translation and no error.

Full request/response (redacted the authorization header) API 3.0.0:

Code: Select all

--> GET https://api-beta.thetvdb.com/episodes/398671 http/1.1
Accept-Language: xx
Authorization: Bearer REDACTED
Host: api-beta.thetvdb.com
Connection: Keep-Alive
Accept-Encoding: gzip
User-Agent: okhttp/3.12.0
Accept: application/vnd.thetvdb.v2.2.0
--> END GET
<-- 200 OK https://api-beta.thetvdb.com/episodes/398671 (374ms)
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Encoding
Date: Wed, 30 Oct 2019 06:36:06 GMT
Cache-Control: private, max-age=300
Last-Modified: Thu, 01 Jan 1970 00:00:00 GMT
Vary: Accept-Language
X-Powered-By: Thundar!
X-Thetvdb-Api-Version: 3.0.0
Content-Encoding: gzip
X-Cache: Miss from cloudfront
Via: 1.1 0a3e1253cb6f224f76f674198cf488fe.cloudfront.net (CloudFront)
X-Amz-Cf-Pop: MUC50-C1
X-Amz-Cf-Id: pvY-xaFLVhB3kHsyeOWO5tgR15zvbR7_Qib9Dlu4db5PeVu2DhwUDA==

{"data":{"id":398671,"airedSeason":1,"airedSeasonID":238066,"airedEpisodeNumber":1,"episodeName":"Flowers for Your Grave","firstAired":"2009-03-09","guestStars":["Brian Avers","Colby French","Dan Castellaneta","James Patterson","Keir Dullea","Monet Mazur","Stephen J. Cannell"],"directors":["Rob Bowman"],"writers":["Andrew W. Marlowe"],"overview":"Author Richard Castle joins NYC Detective Kate Beckett to help solve the case of a serial killer, who is reenacting murders from Castle's novels. Castle becomes very intrigued with the murders and continues to shadow Beckett, much to her chagrin.","language":{"episodeName":"en","overview":"en"},"productionCode":"101","showUrl":"","lastUpdated":1572351038,"dvdDiscid":"","dvdSeason":1,"dvdEpisodeNumber":1,"dvdChapter":null,"absoluteNumber":1,"filename":"/episodes/83462/398671.jpg","seriesId":83462,"lastUpdatedBy":1,"airsAfterSeason":null,"airsBeforeSeason":null,"airsBeforeEpisode":null,"imdbId":"tt1303973","contentRating":"TV-14","thumbAuthor":null,"thumbAdded":"","thumbWidth":"640","thumbHeight":"360","siteRating":7.9,"siteRatingCount":1745,"isMovie":0}}
<-- END HTTP (1112-byte, 659-gzipped-byte body)
Full request/response API 2.2.0:

Code: Select all

--> GET https://api.thetvdb.com/episodes/398671 http/1.1
Accept-Language: xx
Authorization: Bearer REDACTED
Host: api.thetvdb.com
Connection: Keep-Alive
Accept-Encoding: gzip
User-Agent: okhttp/3.12.0
Accept: application/vnd.thetvdb.v2.2.0
--> END GET
<-- 200 OK https://api.thetvdb.com/episodes/398671 (735ms)
Date: Wed, 30 Oct 2019 06:38:39 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Set-Cookie: __cfduid=d7040e6f02d5e30dffa563c51d2e91c3a1572417518; expires=Thu, 29-Oct-20 06:38:38 GMT; path=/; domain=.thetvdb.com; HttpOnly
Cache-Control: private, max-age=600
Last-Modified: Wed, 28 Aug 2019 03:24:22 GMT
Vary: Accept-Language
X-Powered-By: Thundar!
X-Thetvdb-Api-Version: 2.2.0
CF-Cache-Status: DYNAMIC
Expect-CT: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
Server: cloudflare
CF-RAY: 52db6334290fb85d-WAW
Content-Encoding: gzip

{"data":{"id":398671,"airedSeason":1,"airedSeasonID":36354,"airedEpisodeNumber":1,"episodeName":null,"firstAired":"2009-03-09","guestStars":["Stephen J. Cannell","James Patterson","Dan Castellaneta","Keir Dullea","Colby French","Brian Avers","Monet Mazur"],"director":"Rob Bowman","directors":["Rob Bowman"],"writers":["Andrew W. Marlowe"],"overview":null,"language":{"episodeName":"","overview":""},"productionCode":"101","showUrl":"","lastUpdated":1566962662,"dvdDiscid":"","dvdSeason":1,"dvdEpisodeNumber":1,"dvdChapter":null,"absoluteNumber":1,"filename":"episodes/83462/398671.jpg","seriesId":83462,"lastUpdatedBy":535759,"airsAfterSeason":null,"airsBeforeSeason":null,"airsBeforeEpisode":null,"thumbAuthor":289491,"thumbAdded":"","thumbWidth":"400","thumbHeight":"225","imdbId":"tt1303973","siteRating":7.9,"siteRatingCount":135},"errors":{"invalidLanguage":"Some translations were not available in the specified language"}}
<-- END HTTP (930-byte, 551-gzipped-byte body)
All the best for the v3 rollout!

Uwe
Wanderer189
Posts: 6
Joined: Sun Nov 27, 2016 12:13 pm

Thu Nov 14, 2019 7:00 pm

Long time supporter, contributor, beta tester. But the roll over is sure messing up Kodi 3rd party addons. Is there something that needs to be done to them to work with v3? Or is this just another major bloop like the API issue last time it was attempted??
mdeeswrath
Posts: 1
Joined: Fri Nov 15, 2019 8:58 am

Fri Nov 15, 2019 9:15 am

Hi everyone,
Firstly, I want to thank you for doing such an amazing job of providing this service to the world freely. It's truly amazing and you should be really proud of yourselves.
I'm developing a personal content manager as a pet project and TVDB has been my main metadata provider. Everything was working perfectly until the update to V3. As part of show details, my app also lists the posters for each individual season, similar to what the TvDb site does. In the past, the link between the posters and their corresponding season was the subKey property of an image query whose value was the season number. But now, the subkey is constant and will always have the value 'graphical'. Was this change intentional? And if so is there another way to link posters to seasons?

Here is a sample of the request that I'm making :

Request

Code: Select all

https://api.thetvdb.com/series/307868/images/query?keyType=season
Response

Code: Select all

{
  "data": [
    {
      "id": 61825422,
      "keyType": "season",
      "subKey": "graphical"
      "fileName": "seasons/5c1f8a2ebd521.jpg",
      "languageId": 7,
      "language": "en",
      "resolution": "680x1000",
      "ratingsInfo": {
        "average": 0,
        "count": 0
      },
      "thumbnail": "_cache/seasons/5c1f8a2ebd521.jpg"
    },
    {
      "id": 61825423,
      "keyType": "season",
      "subKey": "graphical"
      "fileName": "seasons/307868-1.jpg",
      "languageId": 7,
      "language": "en",
      "resolution": "680x1000",
      "ratingsInfo": {
        "average": 0,
        "count": 0
      },
      "thumbnail": "_cache/seasons/307868-1.jpg"
    }
  ]
}
The property "subKey": "graphical", used to be the season number in the past.
Any help is much appreciated,
Thank you
Post Reply