请求地址
POST https://api.qingluanbot.com/qingluan/api/personal/updateInfo
请求示例
curl -X POST 'https://api.qingluanbot.com/qingluan/api/personal/updateInfo' \
-H 'QL-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"appid": "we_xxxxxxxxxxxxxxx",
"alias": "示例别名",
"gender": 1,
"name": "示例昵称"
}'
请求参数
| 字段 | 类型 | 要求 | 说明 |
|---|
appid | string | 必填 | 青鸾实例 ID，形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。 |
gender | integer | 必填 | 性别枚举：0 未知，1 男，2 女。 |
name | string | 必填 | 名称/昵称 注意：4 个字段全必填，等于每次都要整体提交一份完整资料。传原值无副作用；gender 同理（传原值 1 未产生变化）。 |
alias | string | 必填 | 别名。传空串可清除 注意：契约「传空串可清除」已确认 —— 就是这样把账号上已有的别名清掉的。补充语义：本接口是整体覆盖，不想动 alias 时必须回填 getInfo 读到的当前值，不能省略也不能传空。 |
phone | string | 可选 | 手机号。 |
email | string | 可选 | 邮箱。 |
xcxCorpAddress | string | 可选 | 企业地址。 |
响应判断
能力层接口返回包含 code、message、time 与 data 等字段；请以 code=0 判断业务成功。HTTP 200 只表示网关已返回响应，不能替代业务状态判断。
可能的响应状态
| HTTP 状态 | 公开契约说明 |
|---|
200 | 原样返回（code = 0 即成功） |
403 | 受控接口，需通过控制台配置 |
404 | appid 不存在或无权访问 |
200 响应示例
{
"code": 0,
"data": {}
}
接入步骤
- 在青鸾开发者控制台创建或查看 API Key。
- 在「实例与回调」接入企业微信账号，取得
appid。 - 请求头携带
QL-Key，按当前契约提交 JSON 请求。 - 读取响应中的
code；仅当 code=0 时按成功流程处理。