调用凭证

本页说明调用凭证从哪里领取、请求头怎么填，以及如何安全保存。第一次使用，先按快速开始在控制台给自己发出第一条消息；接入代码需要的接口地址、调用凭证和 wId，见快速开始 · 调用接口。

调用凭证从哪里取得

调用凭证放在请求头 Authorization: Bearer 后面，有两种取得方式：

• 在控制台领取（推荐）：以 eyk_ 开头。在「应用凭证」页点「领取调用凭证」，完整凭证只显示这一次，请当场保存；之后页面只显示掩码，掩码不能用来调用。
• 用开发者账号密码换取：调用开发者账号鉴权，从响应的 data.Authorization 取得，以 eyJ 开头。只有要在自己的后台用账号密码登录时才需要。

两种方式取到的不是同一个值，用哪种取到的就填哪个。不要填文档里的示例值，也不要从浏览器里复制控制台的登录令牌来代替。

方式一：在控制台扫码

1. 按快速开始领取调用凭证、接入微信，确认手机收信并配好回调地址。
2. 调用时用第 1 步保存的完整调用凭证。确实遗失时，在应用凭证页点调用凭证旁的「重置…」，旧凭证立即失效，用到它的服务都要换成新的。
3. 在实例详情里复制在线账号的 wId，接入自己的后端。

这种方式不需要再调用 /member/login。

方式二：把扫码登录集成到自己的系统

已有调用凭证时，用它依次调用获取登录二维码和执行微信登录，登录成功后保存 wId。

如果采用开发者账号密码鉴权，先调用开发者账号鉴权取得 data.Authorization，再继续上述扫码流程。调用失败时按实际响应排查，不要仅根据凭证前缀判断权限或有效期。

短信登录用户先设置开发者密码

/member/login 使用的是 Eyun 开发者账号密码，不是微信密码。如果一直使用短信验证码登录控制台，请先在「账户设置 → 登录与安全 → 设置密码」完成设置。只用控制台领取的调用凭证时不需要这一步。

请求怎么填

把实际取得的调用凭证放入请求头，wId 按具体接口要求放入请求体：

Authorization: Bearer <你的调用凭证>
Content-Type: application/json

服务端保存

调用凭证只应保存在服务端。不要写入网页源码、客户端安装包、公开仓库、截图或可被普通用户读取的日志。