[RESTful Web-service Documentation]
go top

request-token

returns a new authentication token with the URL where the User can authorize the token in the next couple of minutes

Parameter

Parameter (*=required)
Possible values
Default value
Description
token_secret * [string]
password - generated by your App (should be unique per token-request / App-User)
app_name *
[string]
character string - shown to the User in the authorization flow and his profile, here you can place also additional device informationens
app_logo [string]
image/logo (28 x 28 px) URL (https is required for the URL) - shown to the User in the authorization flow and in the PM-Account => API => Allowed Apps
app_callback [string]
redirect URL - used to redirect the User back to the App after the authorization process. If the parameter is not passed, the user will get a notice like this: "Authorized, please close this Window to return back to the App"
lang
[string] single value
  • da
  • de
  • en
  • es
  • it
  • pl
  • pt
en
language

see also get-user-content-langs for getting all language values dynamically
ftp_access
[string, single value]
  • yes
  • no
no
if the App require to access the user FTP directory via the token and the token secret (no real Username and Password required for security reasons)

Host: ftp.panthermedia.net

User-Authentication

not required

Endpoint

https://rest.panthermedia.net/request-token

(SSL is required)

Sample Request

POST https://rest.panthermedia.net/request-token
Accept-Version: 1.0
Content-Type: application/x-www-form-urlencoded
api_key=a5e770dadd779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1f&access_key=96c35a3d110cf36709968972e38fb8e9879d656f&timestamp=Thu,%2026Jul%202012%2014:53:44%20UTC&nonce=Im%20ar%20andomS%20tring&algo=sha1&token_secret=mysecret&app_name=MyApp&app_logo=http://mydomian/logo/myapplogo.jpeg&app_callback=http://mydomian/profile

Sample Answer

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rsp stat="ok">
    <token>2eb7223d78bdb14e5ef331adf6c12175681d47ed2b6e32b77bd1eaad04dff9c0</token>
    <auth_url>
       <![CDATA[https://rest.panthermedia.net/auth?hl=en&auth_token=2eb7223d78bdb14e5ef331adf6c12175681d47ed2b6e32b77bd1eaad04dff9c0&app_name=MyApp&api_key=a5e7b0dada779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1f&app_logo=http://mydomian/logo/myapplogo.jpeg&app_callback=http://mydomian/profile]]>
    </auth_url>
    <valid_until>Mon, 30 Jul 2012 10:39:31 UTC</valid_until>
</rsp>