998211c483
- 从服务器拉取完整代码 - 按框架规范整理项目结构 - 配置 Drone CI 测试环境部署 - 包含后端(FastAPI)、前端(Vue3)、管理端 技术栈: Vue3 + TypeScript + FastAPI + MySQL
1.7 KiB
1.7 KiB
授权认证
概述
言迹开放平台采用标准OAuth2.0客户端授权认证模式。
认证方式
Header传递：Authorization: Bearer {access_token}
获取access_token
请求信息
- 请求方式：GET（HTTPS，测试环境可使用HTTP）
- 请求地址：
/oauth/token
请求参数（Query）
| 参数 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| grant_type | 是 | string | 授权类型，固定值：client_credentials |
| client_id | 是 | string | 客户端ID（由言迹分配提供） |
| client_secret | 是 | string | 客户端密钥（由言迹分配提供） |
请求示例
curl --location --request GET 'https://open-test.yanjiai.com/oauth/token?grant_type=client_credentials&client_id=1Fld4LCWt2vpJNG5&client_secret=XE8w413qNtJBOdWc2aCezV0yMIHpUuTZ'
响应结果
{
"access_token": "c5a3ad54-4622-4588-a490-5116407f602b",
"token_type": "bearer",
"expires_in": 3600,
"scope": "read write"
}
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| access_token | string | 访问令牌 |
| token_type | string | 令牌类型，固定为"bearer" |
| expires_in | integer | 过期时间（秒） |
| scope | string | 权限范围 |
使用示例
获取token后，在后续请求中携带：
curl --location --request GET 'https://open-test.yanjiai.com/api/saas/user' \
--header 'Authorization: Bearer c5a3ad54-4622-4588-a490-5116407f602b'
注意事项
- Token缓存：access_token有效期为1小时，建议缓存复用
- 过期处理：token过期后需重新获取
- 安全存储：client_secret需要安全存储，不要暴露在前端
- 并发控制：避免频繁调用认证接口