1.1 获取 Token

获取 Token

调用地址

POST /api/token.php

请求参数(注意使用form表单提交)

名称	类型	必需	说明
grant_type	varchar	是	验签类型，固定值：`client_credentials`

Header 头参数

基于 BasicAuth 方式，需添加：

Authorization: Basic xxxxxx

说明：xxxxxx 为 SecretID:Secret 进行 Base64 编码后的字符串

调用者权限

所有客服

调用示例

注意：xxxxxx 需根据实际情况替换，参考上述 Header 头参数说明

返回值参数

名称	类型	说明
access_token	varchar	Token 令牌
expires_in	int	有效期：3600 秒
token_type	varchar	Token 类型
scope	varchar	权限范围

返回值示例

成功响应

{
    "access_token": "d560fbabcabffdba6e1c50767312d331ffbed879",
    "expires_in": 3600,
    "token_type": "Bearer",
    "scope": null
}

密钥错误

{
    "error": "invalid_client",
    "error_description": "The client credentials are invalid"
}

请求方式错误

{
    "error": "invalid_request",
    "error_description": "The request method must be POST when requesting an access token",
    "error_uri": "http://tools.ietf.org/html/rfc6749#section-3.2"
}

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

获取 Token#

调用地址#

请求参数(注意使用form表单提交)#

Header 头参数#

调用者权限#

调用示例#

返回值参数#

返回值示例#

成功响应#

密钥错误#

请求方式错误#

请求参数