获取token

POST

/robotapi/client/auth

获取token是调用Work-bot API接口的第一步，相当于创建了一个登录凭证，其它的业务API接口，都需要依赖于token来鉴权调用者身份。
因此开发者，在使用业务接口前，要明确token的颁发来源，使用正确的token。

获取token需要用到的accessKey和accessSecret即为Work-bot SCRM平台的登录账号和密码，联系销售客服申请试用账号。

token有效期

token的有效期通过返回的expireMinutes来传达，正常情况下为1440分钟（24小时）。

刷新token

在token有效期内再次调用该接口，将重置token的有效期为1440分钟

在使用Work-bot提供的在线调式功能时，使用正确的accessKey和accessSecret运行调式本接口时获取到的accessToken，会自动填充到在线调式工具的系统变量中，在调式其它接口时会默认选用该接口获取到的accessToken。

请求参数

Authorization

Body 参数application/json

示例

{
    "accessKey": "user1",
    "accessSecret": "password"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.example.com/robotapi/client/auth' \
--header 'Content-Type: application/json' \
--data '{
    "accessKey": "user1",
    "accessSecret": "password"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "msg": "string",
    "code": "string",
    "data": {
        "createTime": 1530537138000,
        "expireMinutes": 1451,
        "accessToken": "eaa9c935b5b27c231a8b0c323feb1361",
        "username": "user1"
    }
}

修改于 2026-05-09 08:39:47

试用与支持

获取表情包【matebot、probot、autobot】