访问令牌access_token

POST

https://api.h189.cn/oauth/token

权限说明：
在调用天浩API前，需要先调用token接口获取access_token,通过access_token来鉴权调用者身份。

注意事项：
1、access_token的有效期为7200秒（2小时）。
2、当access_token过期时，接口会返回状态码405，需要重新获取access_token。
3、通过refresh_token调用token接口续期access_token，refresh_token有效期86400秒（1天）。
4、不能频繁调用获取access_token接口，否则会受到接口调用频率拦截。

请求参数

Body 参数application/json

client_id

string

客户标识

必需

client_secret

string

客户密钥

必需

示例

{
    "client_id": "{{client_id}}",
    "client_secret": "{{client_secret}}"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.h189.cn/oauth/token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "client_id": "",
    "client_secret": ""
}'

返回响应

🟢200成功

application/json

Body

code

number

必需

返回状态码（0-正常）

msg

string

必需

返回说明（ok-正常）

data

object

必需

access_token

string

访问令牌

必需

token_type

string

令牌类型

必需

expires_in

integer

过期时间（秒）

必需

refresh_token

string

刷新令牌

必需

scope

string

权限范围

可选

示例

{
    "code": 0,
    "msg": "ok",
    "data": {
        "access_token": "2Y4OH6wQhrY2V1hXtJI4T6qNeo7WKPJ3",
        "token_type": "Bearer",
        "expires_in": 7200,
        "refresh_token": "3334OH6wQhrY2V1hXtJI4T6qNeodwwe",
        "scope": "thws"
    }
}

状态码表

刷新令牌refresh_token