Hi OrTracon,

The API key is just another HTTP parameter like session_id or language. There's a working example under the "Required Parameters" header of the API documentation.

P.S. a couple things…

1. The session based authentication workflow is explained here. Once Apiary gets some improved documentation pages, that document will be moved over.

2. Your favourite movie call is not correct. A valid request (once you have an approved session id, and {id} being your account id) looks like:

   http://api.themoviedb.org/3/account/{id}/favorite_movies?api_key=###&session_id=###

3. Remember Apiary should only be used for development and helping to troubleshoot requests.

Hope that helps.

Thanks for the brief overview, travisbell. The documation for v3 is not as clear-cut as that of v2.1 so bear with me as I stumble through it.

I was successful in getting a request_token using my api_key. However, when I tried to obtain a session_id, I am given the following error: {"status_code":17,"status_message":"Session denied"} The uri I am using to obtain a session_id is: http://api.themoviedb.org/3/authentication/session/new?api_key=###&request_token=### I have made this attempt using curl, wget, and web browser (both logged in and not logged in). In reading the User Auth doc, step two mentions something about "your application needs to open a web browser and send them (request_token) to TMDb". However it does not tell me where to send my newly obtained request_token. The api docs does not mention nor gives any references to sending my request_token to TMDb.

Is there a missing step between the token/new method and the session/new method? What is error code 17 (session denied)? I assume it means I cannot request a new session_id until have obtained "authorization from the user" (step 2 of the user auth guide).

Or You download the jar file directly call your api_key will ease you a lot

Between requesting the request token and generating a valid session id, you need to authorize the token. Step 2 in the docs I linked to above. Did you do step 2?

I can't see how to authorize the token in the documentation

Hi charlieperry,

It's outlined here: http://help.themoviedb.org/kb/api/user-authentication

Could you elaborate about what's not clear?

Thanks. I didn't know about the help area. I'll make sure to check there in future.

The docs will be getting folded into Apiary as soon as they support extra pages. In the meantime, I've linked to it on the authentication methods.

Thanks.

The link provided about the user-authentication doesn't work anymore. Could somebody give me the new url?

Hey yannickvangodtsenhoven,

I've just added it to the API docs section: https://www.themoviedb.org/documentation/api/sessions

Cheers.