access_token登录凭证

功能介绍

---

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

使用方法

---

开发者需要通过HTTP GET请求获取access_token，提供API Key（api_key）或企业ID（corp_id），以及用户ID（user_id）。两种认证方式至少传一个，若同时传入则优先使用api_key。获取到的access_token有效期为两天（172800秒），开发者需要在过期前重新获取，以确保API调用的连续性。建议实现access_token的缓存和自动刷新机制，避免频繁请求影响性能。

---

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

调用接口

请求方式： GET（HTTPS）
用api_key和user_id请求access_token地址： https://ms-ai.chongzhiling.com/token/accessToken?api_key=[API_KEY]&user_id=[USER_ID]

用corp_id和user_id请求access_token地址： https://ms-ai.chongzhiling.com/token/accessToken?corp_id=[corp_id]&user_id=[USER_ID]

参数列表：

参数	含义
corp_id	企业ID（兼容旧版）: 每个企业都拥有唯一的corp_id，获取此信息可在管理后台查看。与api_key二选一。
user_id	用户ID: 接入方系统的用户唯一标识，用于在SaaS平台中唯一标识和关联用户数据。该ID由接入方系统提供，作为用户数据在SaaS平台中的主键标识。若不考虑多用户场景，接入方可使用任意唯一标识符。
api_key	在开放平台的API KEY管理中生成自己的apikey。

返回结果：

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

返回参数说明：

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

接口调试

---