In my current grails project, i needed to integrate Tumblr with the application using Tumblr API. I searched a lot about it and find the Java wrapper of Tumblr to use it with my grails application and thought it worth sharing.
\nTumblr uses OAuth1.0 protocol for authorization when our application tries to access the data.<\/p>\n
The steps involved in using Tumblr API in our grails application are as:-<\/p>\n
#1.Register Application :<\/strong><\/p>\n Register an application on Tumblr here<\/a> and get an API\/OAuth_Consumer key. #2.Get Access Token :<\/strong><\/p>\n With the help of API key and API secret generated in the above step, we need to get access token for calls. Steps involved in getting access token. Code to get verification_code is as : String apiKey = API_KEY obtained from registered Tumblr Application OAuthService service = new ServiceBuilder().provider(TumblrApi.class).apiKey(apiKey).apiSecret(apiSecret) Token requestToken = service.getRequestToken() session[‘REQUEST_TOKEN’] = requestToken redirect(url: authUrl) This will redirect user to Tumblr server to grant permissions for this application and provides an verification code to obtain access token.<\/p>\n As the user grants permission, the Tumblr will redirect it back to the application with verification code, which is used to retrieve access token.<\/p>\n Code to handle callback, where Tumblr sends verification code:<\/p>\n [java]<\/p>\n def tumBlrCallBack() {<\/p>\n Token requestToken =(Token)session[‘REQUEST_TOKEN’] Verifier verifier = new Verifier(request.getParameter("oauth_verifier")) JumblrClient client = new JumblrClient(apiKey,apiSecret) com.tumblr.jumblr.types.User user = client.user() This worked for me. Useful Links:<\/p>\n
\nThis process will generate application and provide API\/OAuth_Consumer Key<\/strong> & Secret Key<\/strong> for getting access token for API calls.<\/p>\n
\nThe Java wrapper which i used can be downloaded from here<\/a><\/p>\n
\n#.<\/strong>A request token is sent to the server to get a URL for the user to give back a verification code.
\n#.<\/strong>The verification code and the request token are used in another request to get an access token.
\nOnce we have that access token we can then use it to get data from the Tumblr.<\/p>\n
\n[java]
\ndef registerOnTumBlr() {<\/p>\n
\nString apiSecret = API_SECRET obtained from registered Tumblr Application
\nString callbackurl = http:\/\/www.example.com\/myapp\/tumBlrCallBack
\n\/\/ callback URL to get the access token<\/p>\n
\n.callback(callbackurl).build()<\/p>\n
\nString authUrl = service.getAuthorizationUrl(token)<\/p>\n
\n\/\/ set Tumblr Request token in session, as we will be requiring it to get access token<\/p>\n
\n}
\n[\/java]<\/p>\n
\nOAuthService service = new ServiceBuilder().provider(TumblrApi.class).apiKey(apiKey).apiSecret(apiSecret)
\n.callback(callbackurl).build()<\/p>\n
\nToken accessToken = service.getAccessToken(requestToken, verifier)
\n\/\/ required access token for API calls.<\/p>\n
\nclient.setToken(accessToken.getToken(), accessToken.getSecret())<\/p>\n
\n\/\/user object for accessing data.
\n}
\n[\/java]<\/p>\n
\nHope it helps.<\/p>\n
\nhttp:\/\/www.tumblr.com\/docs\/en\/api\/v2<\/a>
\nhttps:\/\/github.com\/tumblr\/jumblr<\/a><\/p>\n