语雀AccesToken开发策略
在开发自己博客过程中,为了避免重复造轮子,使用语雀提供的文档管理可以实时的追踪到自己的数据库中。只需要自己开发好前端页面就可以获取到。
1.创建并申请Token
申请AccesToken 设置Token权限
Token asdklfjasdpoigjwejfal;skjdfoisdj
主要的权限有:
✅修改和读取你的团队✅读取你的团队
✅修改和读取你的主题✅读取你的主题
✅修改和读取你的知识库✅读取你的知识库
✅修改和读取你的文档✅读取你的文档
✅修改和读取你的画板✅读取你的画板
2.数据请求准备
基本路径
https://www.yuque.com/api/v2
所有API都以上述路径开头
HTTP方法
Verb | Description |
---|---|
GET | 用于获取数据 |
POST | 用于创建数据 |
PUT | 用于修改部分数据,例如一个文档标题,正文 |
DELETE | 用于删除数据 |
提交数据说明
当使用POST 和PUT方法时,请确保Content-type 为 application/json
User-Agent
每次请求数据必须携带User-Agent 以确保语雀了解请求用户是谁
req.Headers.Add("User-Agent", "这里可以填应用名称")
Token认证
语雀使用Token认证,需要在HTTP Headers中传入 X-Auth-Token
Token
HTTP状态码
- 200-成功
- 400-请求的参数不正确,或缺少必要信息,请对比文档
- 401-需要用户认证的接口用户信息不正确
- 403-缺少对应功能的权限
- 404-数据不存在,或未开放
- 500-服务器异常