第三方应用 - 获取token

获取token分为两个步骤，第一步是获取授权码，第二步才是获取token。

获取demo

获取授权码

请求格式：

GET https://ppmessage.com/ppauth/auth?state=xxxx&client_id=xxxx&redirect_id=xxxx&response_type=code

参数说明：

返回结果：

成功获取授权码后，PPMessage服务器会把用户导向PPMessage的 应用授权 页面。

在应用授权页面，用户输入他的邮箱和密码，然后点击继续按钮。如果邮箱和密码匹配，PPMessage服务器会将用户导向你指定的redirect_uri，并带上授权码和state。

最终的uri格式：

http://you-site.com?code=xxxxxx&state=xxxx

获取 Token

PPMessage服务器将用户导向你的redirect_uri后，你能从这个uri里获取到authorization code和state。

state应该和你上一步提供的state一致。

现在你可以通过authorization code来获取token。

请求:

POST https://ppmessage.com/ppauth/token

请求body参数:

返回结果：

调用API

成功获取到token之后，你可以使用token调用PPMessage API。

• headers：请求headers必须包括Content-Type和Authorization(需要用你获取的token替代xxxxxx)。

  {
      "Content-Type": "application/json",
      "Authorization": "OAuth xxxxxx"
  }

• body: 部分API需要你提供app_uuid(即kefu api_uuid和console api_uuid)，或user_uuid(在 应用授权 界面输入邮箱和密码的用户)。此时body应包括相应参数。

  {
      "app_uuid": "xxxx",
      "user_uuid": "xxxx",
      ...
  }

• uri: 请求uri格式

  POST https://ppmessage.com/api/xxxx

• response: 返回结果（例子）

  {
      "list": [],
      "error_code": "0",
      "error_string": "success",
      "uri": "/PP_GET_APP_SERVICE_USER_LIST"
  }

  要获取所有API的调用方法，请查看 API列表。