access_token登录凭证

功能介绍

---

本文档介绍了如何获取和使用宠智灵API的登录凭证（access_token）。access_token是调用宠智灵所有API接口和嵌入式H5页面的必要凭证，用于验证开发者的身份和权限。通过本文档提供的接口，开发者可以获取有效的access_token，并在后续的API调用中使用。

使用方法

---

开发者需要通过HTTP GET请求获取access_token，请求时需要提供企业ID（corp_id）和用户ID（user_id）两个参数。获取到的access_token有效期为两天（172800秒），开发者需要在过期前重新获取，以确保API调用的连续性。建议实现access_token的缓存和自动刷新机制，避免频繁请求影响性能。

适用场景

---

• API接口调用：所有宠智灵API接口调用都需要使用access_token进行身份验证
• H5页面嵌入：在APP、Web或小程序中嵌入宠智灵H5页面时需要提供access_token
• 第三方应用集成：第三方应用与宠智灵平台集成时的身份认证
• 企业应用开发：企业内部应用开发时的用户身份验证和权限管理

---

access_token是宠智灵API的唯一凭证，用于验证调用者的身份。无论是调用API接口还是嵌入式H5页面，都需要使用access_token。因此，开发者需要妥善保存这个凭证，并定期更新，以防止它失效。

调用接口

请求方式： GET（HTTPS）
请求地址： https://ms-ai.chongzhiling.com/auth/token/accessToken?corp_id=[CORP_ID]&user_id=[USER_ID]

参数列表：

参数	含义
corp_id	企业ID: 每个企业都拥有唯一的corpid，获取此信息可在管理后台查看
user_id	用户ID: 接入方系统的用户唯一标识，用于在SaaS平台中唯一标识和关联用户数据。该ID由接入方系统提供，作为用户数据在SaaS平台中的主键标识。若不考虑多用户场景，接入方可使用任意唯一标识符。

返回结果：

{
    "code": 200, // 200表示成功，其他值表示失败
    "message": "success",
    "data": {
        "access_token": "string",
        "expires_in": 172800
    }
}

返回参数说明：

参数	类型	含义
access_token	string	获取到的凭证
expires_in	number	凭证的有效时间（秒）

接口调试

---