appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"取当前登录账号资料。
/qingluan/api/personal/getInfo取当前登录账号资料。
:::check ✅ 成功判定:HTTP 200 且响应体 code = 0。业务失败请查看 message 与 detail。 :::
请求体必填。通过 QL-Key 请求头携带 APIKey。
Content-Type:application/json
请求参数。字段名区分大小写,请按文档原样传递。
appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"本接口为能力层原样返回,不统一增加青鸾外层信封。code = 0 仅表示请求被接受,不保证副作用已完成。
请结合业务数据与本页说明判断实际状态,不要仅凭响应码推断操作效果。
能力层原样返回;code = 0 仅表示请求已受理,业务结果须按接口说明确认。
application/json
接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断:HTTP 200 只表示请求已送达,成功以 code = 0 为准。
codeinteger必填业务状态码
业务状态码:0 表示成功,-1 表示失败;失败原因见 message。
0dataobject可选业务数据
业务返回数据;字段结构见下方定义。
uinint64可选用户 UIN
用户唯一数字 ID。外部联系人可从同步结果的 userInfo.uin 获取。
注意:等于本账号 vid,与消息发送返回体 / 回调里的 fromUserId 是同一个值,可直接用来识别「自己发的消息」。前缀 1688 对应内部同事身份(外部联系人是 7881)。
namestring可选名称
名称/昵称
emailAddrstring可选邮箱
注意:为空串;该账号唯一有值的邮箱在 bizMail(企业邮箱)。要邮箱请优先读 bizMail,emailAddr/phone 都是空的。
birthdaystring可选生日
注意:是带时分的字符串(采集打码后尾部残留 0:00),不是 yyyy-MM-dd 纯日期。确切格式因打码未确认,解析前请先做一次真机取样。
mobilestring可选手机号
phonestring可选手机号
手机号(11 位)
jobstring可选职位信息。
numberstring可选工号
genderint64可选性别枚举:0 未知,1 男,2 女。
[0, 1, 2]iconUrlstring可选头像 URL
注意:是一条长度 67 的 URL,采集按 *url 规则整体打码,因此「是否带签名、是否会过期」未确认 —— 在验证前不要长期缓存这个地址。
corpIdint64可选企业 ID
企业 ID。
attrint64可选属性位
dispOrderint64可选显示排序
bizUinint64可选企业侧 uin
注意:契约写「企业侧 uin」,但恒为 1,显然不是一个 uin。企业标识请用 corpId。真实含义未确认。
positionstring可选职位或位置说明。
aliasstring可选别名。传空串可清除
mainPartyIdint64可选主部门 ID
gidint64可选分组 ID
isNameVerifiedboolean可选是否已实名
注意:true,同时 nameVerifyStatus=1、realName 有值。只有一个样本,「nameVerifyStatus=1 是否就等于已实名」未确认。
internationCodestring可选国际区号。
bindEmailStatusint64可选邮箱绑定状态
englishNamestring可选英文名
customInfoobject可选自定义信息
注意:为 {};tencentInfo 同样为 {}。两者的内部结构都没拿到样本,不要按猜测写解析。
nameVerifyStatusint64可选实名校验状态
realNamestring可选真实姓名。
vCorpUseStatusint64可选虚拟企业使用状态
inviteVidint64可选邀请人 vid
holidayInfoobject可选休假信息
holidayStatusint64可选休假状态
holidayDescstring可选休假说明
oldHolidayIconIndexint64可选旧休假图标序号
createTimeint64可选创建时间戳(秒)
holidayInfoIdint64可选休假信息 ID
holidayIconIndexint64可选休假图标序号
holidayGenerateSrcint64可选休假来源
holidayStatusNewint64可选新版休假状态
vacationSyncTypeint64可选休假同步类型
xcxStyleint64可选小程序样式配置
attr2int64可选属性位 2
注意:随 alias 被清空而减少 512(bit9)。位含义未确认,仅记录该现象;attr(142606656) 与 attr3(0) 三次读取全程未变。
tencentInfoobject可选腾讯侧扩展信息
isSyncInnerPositionboolean可选是否同步内部职位
unionIdstring可选微信生态下的 unionid。
vCodestring可选校验码
注意:两次读取值不同,且中间没有任何写操作 —— 会自行变化,不能当稳定标识。同时它是校验码性质的值,不要外发、不要落明文库。
personalWorkTypeint64可选个人工作类型
superiorsobject[]可选直属上级成员列表。
注意:契约写「直属上级成员列表」。返回 [{}] —— 数组里是一个空对象,元素结构没取到样本。不要假定里面有 vid/name,取值前必须判空。
数组元素 · object
未声明对象内部字段,具体结构以接口说明与示例为准。
bizMailstring可选企业邮箱
attr3int64可选属性位 3
collegeIdentityint64可选校园身份枚举值,由平台定义。
mobileAreaCodeint64可选手机号国家码,如 86
注意:契约写「手机号国家码,如 86」,该账号返回 0;同一份返回里真正带区号的是 internationCode(字符串 "86")。取区号请用 internationCode。
detailstring可选错误详情
错误详情;无补充信息时通常为空字符串。
messagestring必填响应消息
业务结果消息。成功通常为 ok;企微错误通常为 错误码|错误信息。
"ok"timestring必填服务端时间
服务端时间,格式为 YYYY-MM-DD HH:mm:ss。
"2026-07-21 07:33:17"受控接口,需通过控制台配置
appid 不存在或无权访问