青鸾QINGLUAN
控制台

获取账号资料

取当前登录账号资料。

POST/qingluan/api/personal/getInfo

接口说明

取当前登录账号资料。

:::check ✅ 成功判定:HTTP 200 且响应体 code = 0。业务失败请查看 messagedetail。 :::

请求参数

请求体必填。通过 QL-Key 请求头携带 APIKey。

Content-Type:application/json

请求参数。字段名区分大小写,请按文档原样传递。

appidstring必填

青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。

字段示例:"we_xxxxxxxxxxxxxxx"

响应与结果确认

本接口为能力层原样返回,不统一增加青鸾外层信封。code = 0 仅表示请求被接受,不保证副作用已完成。

请结合业务数据与本页说明判断实际状态,不要仅凭响应码推断操作效果。

响应字段与 HTTP 状态

HTTP 200

能力层原样返回;code = 0 仅表示请求已受理,业务结果须按接口说明确认。

application/json

查看响应字段定义

接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断:HTTP 200 只表示请求已送达,成功以 code = 0 为准。

codeinteger必填

业务状态码

业务状态码:0 表示成功,-1 表示失败;失败原因见 message

字段示例:0
dataobject可选

业务数据

业务返回数据;字段结构见下方定义。

uinint64可选

用户 UIN

用户唯一数字 ID。外部联系人可从同步结果的 userInfo.uin 获取。

注意:等于本账号 vid,与消息发送返回体 / 回调里的 fromUserId同一个值,可直接用来识别「自己发的消息」。前缀 1688 对应内部同事身份(外部联系人是 7881)。

namestring可选

名称

名称/昵称

emailAddrstring可选

邮箱

注意:为空串;该账号唯一有值的邮箱在 bizMail(企业邮箱)。要邮箱请优先读 bizMailemailAddr/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=1realName 有值。只有一个样本,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"

HTTP 403

受控接口,需通过控制台配置

HTTP 404

appid 不存在或无权访问

搜索接口

输入关键词查找接口。最多显示 20 项。