search

thetvdb / v4-api

Founded in 2006, TheTVDB is one of the longest-running community-driven TV and Movie databases. With content metadata across hundreds of thousands of TV series and movies, TheTVDB powers many of the largest media centers in the market. Developers across the world build and rely upon TheTVDB's APIs to power their apps, utilities, and projects, generating millions of API calls per day. In our GitHub repository you will find all of the necessary support and v4 API documentation to make use of TheTVDB's metadata. Come and join us!
134 stars 13 forks source link

Artwork #194

Open danhi opened 2 years ago

danhi commented 2 years ago

if there is more documentation on this somewhere, if you could just point me to it, I'd research it there. But ...

In trying to get the artwork for a tv series, before I was looking in the episodes//extended endpoint and going through the seasons to find the correct season, and in that element there was an image element that had the URL. But for some shows (The Next Girl) there aren't elements for image. So I thought I'd just use the artwork element in the main record, but it's not clear to me what all the elements in this element are. For example, there is a type element. What is this? Some of the entries have a language entry, does this mean that the image has text?

I tried looking at the documentation I could find, but didn't find answers. Any help would be greatly appreciated.

samwhipmedia commented 2 years ago

@danhi If you are looking up artworks using the endpoint /series/:id/artworks. It will return all artworks for that series in data.artworks. artworks.type indicates if the artwork is a poster, banner, etc.. All the artwork types can be found in this endpoint /artwork/types. For example:

1 = Banner
2 = Poster
3 = Background
danhi commented 2 years ago

Where would I go to find this documented?

antheaezzell commented 2 years ago

My apologies @danhi this is not properly documented in our current documentation. I've added a ticket for our developers to do so. Is @samwhipmedia above description enough for you to go off of for now until it can be properly added? Or do you have further questions for the developers in the interim.

Ticket for our internal reference - https://mediamorph.atlassian.net/browse/TVD-2856

danhi commented 2 years ago

That is all the info I needed. I just wanted to make sure I wasn't missing my documentation I should read before I ask here.

antheaezzell commented 2 years ago

No you are right. It needs to be added. Thank you for bringing it to our attention.

danhi commented 1 year ago

In the episode record, there in a field, imagetype, which has a value of 11. Is there a separate definition for this field?

From: samwhipmedia @.> Sent: Tuesday, February 22, 2022 11:20 PM To: thetvdb/v4-api @.> Cc: Dan Hinsley @.>; Mention @.> Subject: Re: [thetvdb/v4-api] Artwork (Issue #194)

@danhi https://github.com/danhi If you are looking up artworks using the endpoint /series/:id/artworks. It will return all artworks for that series in data.artworks. artworks.type indicates if the artwork is a poster, banner, etc.. All the artwork types can be found in this endpoint /artwork/types. For example:

1 = Banner 2 = Poster 3 = Background

— Reply to this email directly, view it on GitHub https://github.com/thetvdb/v4-api/issues/194#issuecomment-1048479484 , or unsubscribe https://github.com/notifications/unsubscribe-auth/AAZT5NNGJIKCKGKCVWYMOW3U4R4CPANCNFSM5OB3HNUA . Triage notifications on the go with GitHub Mobile for iOS https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675 or Android https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub . You are receiving this because you were mentioned. https://github.com/notifications/beacon/AAZT5NOR5TAVKI45KPTHS5LU4R4CPA5CNFSM5OB3HNUKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOHZ7IN7A.gif Message ID: @. @.> >

antheaezzell commented 1 year ago

Hi @danhi I believe what you are asking about is the episode field called imageType. Is that correct? If that's the case the field describes the image type for the episode image field, which is a link to the image for that record, in this case a 16:9 episode image.