:::warning
⚠️ 注意事项：语雀开放 API 仅用于对语雀内容的正常读写，请合理使用语雀开放 API。系统识别异常行为后会进行屏蔽处理，可能会导致用户不可用等情形。
:::

# 身份认证
:::info
语雀所有的开放 API 都需要 Token 验证之后才能访问。
:::
在请求的 HTTP Headers 传入 `X-Auth-Token` 带入您的身份 Token 信息，用于完成认证。

## 个人用户认证 超级会员专享权益
获取 Token 可通过点击语雀的个人头像，并进入 [个人设置](/settings/tokens) 页面拿到，如下图：
![image.png](https://cdn.nlark.com/yuque/0/2023/png/84151/1680345283904-509c590e-b0b3-45a6-a9ff-aedde629b0c9.png#averageHue=%23fcfcfc&clientId=u1fc313b9-a9c1-4&from=paste&height=586&id=ued5cbc22&originHeight=1272&originWidth=2320&originalType=binary&ratio=2&rotation=0&showTitle=false&size=118296&status=done&style=shadow&taskId=u5e65e0c5-8121-4d7f-9add-5500bcbd768&title=&width=1068)

`X-Auth-Token` 依据用户有的权限，决定了能获取到的数据，例如，假如 “小明” 这个账号是 “[语雀/帮助](/yuque/help)” 这个文档仓库的 `Owner`，那么通过他的 Token 可以获取到这个仓库的所有信息。

其他情况由具体的功能权限设定来决定能获取到什么样的数据，以及那些数据有修改权限。

## 企业团队身份认证 旗舰版空间专享权益
空间内的团队，可进入团队设置页面进行获取（仅[旗舰版空间](https://www.yuque.com/about/price)可使用）。
![image.png](https://cdn.nlark.com/yuque/0/2023/png/84151/1680345436472-0dce9c77-252c-4154-b562-522f43e845b8.png#averageHue=%23fcfcfc&clientId=u1fc313b9-a9c1-4&from=paste&height=551&id=uc43973f9&originHeight=1206&originWidth=2338&originalType=binary&ratio=2&rotation=0&showTitle=false&size=109287&status=done&style=shadow&taskId=u26c0e0e8-8d39-4a1a-b0df-3e7ee31ea70&title=&width=1068)

通过 `X-Auth-Token` ，语雀能够识别到当前访问的是哪个团队，可获取到该团队内的知识库、文档、以及成员等相关的数据。


# API 列表
[接口列表 · 语雀](https://www.yuque.com/yuque/developer/fadm9di79hgo6ggw?view=doc_embed)