Hello !
First, thanks for all the hard work on the documentation and API !
I'm trying to set up my auth flow for the Tmdb API, however, I'm struggling to understand the exact authorisation scope of the various tokens.
From my understanding of the documentation:
read token
) is to be used as an API key and only grant read access for v4
api_key
serves the same purpose forv3
write token
) is to be used for Account & List endpoints in v4
session_id
is to be used for Account & List endpoints in v3
Guest session_id
is only for rating shows/movies/episodes in v3
However, it seems that:
read-only token
for v4
grants access to all accounts & lists endpoints in v3
or v4
regardless (for GET at least, not POST/DELETE it seems)session_id + api_key
works on v4
endpoints (without v4 read or write token)account_id
query parameters for those endpoints are ignored in favour of the token
or session id
holderSo in the end I'm confused about which token I should use.
v4 access token
or session_id+api_key
interchangeably for all endpoints? Same for api_key
and read-only token
?read-only tokens
? If so doesn't that mean I leak
the api_key
account's holder information if I bundle my app with a read-only token
instead of api_key
?object_account_id
(v4) and account_id
(v3) if the return is based on the auth token holder
?Thanks for any insight you can provide :)
Не вдалося знайти фільм або серіал? Увійдіть, щоб додати.
Хочете оцінити чи додати до списку?
Немає облікового запису?
Відповідь від Travis Bell
12 лютого 2024, 11:20
Hi @dvcol,
The v3 API key and v4 access token can be treated as one and the same. They provide access to any of the public read methods. For example, unless a list is marked as private, either way of authenticating can be used to get a list. Lists are public by default so this would be the case for the vast majority of lists.
A session ID, or user authorized access token is required to do any user specific actions like rate a movie, or access private lists.
Відповідь від younes60
7 липня 2024, 17:29
but im able to mark a movie as favorite on any account without session_id or access_token but only with api key