QiWX开放平台
个人微信
个人微信
  1. 联系人模块
  • 开发前必读
  • 回调结构说明
  • 客户端用例
  • 登录模块
    • 创建设备(步骤1)
      POST
    • 二维码-获取(步骤2)
      POST
    • 二维码状态-检测(步骤3)
      POST
    • 二维码-code验证(步骤4)
      POST
    • 恢复设备
      POST
    • 用户登录(免扫码登录)
      POST
    • 用户状态
      POST
    • 停用设备
      POST
  • 回调模块
    • 设置回调URL
      POST
  • 联系人模块
    • 联系人详情-批量
      POST
    • 联系人详情-By二维码
      POST
    • 外部联系人分页
      POST
    • 内部联系人分页
      POST
    • 联系人搜索
      POST
    • 添加个微
      POST
    • 添加企微
      POST
    • 添加群成员好友
      POST
    • 添加企微名片
      POST
    • 添加删除联系人
      POST
    • 同意申请
      POST
    • 外部联系人信息-更新
      POST
    • 内部联系人信息-更新
      POST
    • 删除联系人
      POST
    • Userid转Openid
      POST
    • Openid转Userid
      POST
  • 群模块
    • 群分页
    • 群详情-批量
    • 群成员变动查询
    • 创建群
    • 修改群名称
    • 修改群备注
    • 修改群内昵称
    • 邀请/添加成员
    • 禁止群成员互相添加
    • 移除成员
    • 群二维码
    • 修改群公告
    • 添加群管理员
    • 取消群管理员
    • 退群
    • 转让群主
    • 群解散
    • 开启群改名
    • 开启群邀请确认
    • 接受群邀请-By链接
    • Roomid转OpenID
    • OpenID转Roomid
  • 消息模块
    • 引用消息发送说明
    • 发送纯文本消息
    • 发送混合文本消息
    • 发送图片消息
    • 发送GIF表情消息
    • 发送视频消息
    • 发送文件消息
    • 发送语音消息
    • 发送链接消息
    • 发送小程序消息
    • 发送名片消息
    • 发送视频号消息
    • 发送位置消息
    • 撤回已发消息
    • 语音转文字-任务申请
    • 语音转文字-任务查询
    • 修改消息状态
    • 群消息置顶-列表
    • 群消息置顶-添加
    • 群消息置顶-移除
    • 群发助手发送
    • 群发助手-状态查询
    • 群发助手-规则查询
    • 同步历史消息分页
  • 会话模块
    • 会话分页
    • 会话组-编辑
    • 会话组-查询
  • 多媒体资源(上传/下载)
    • 本地文件上传
    • 企微文件异步上传
    • 企微大文件异步上传
    • 企微文件异步下载
    • 企微大文件异步下载
    • 个微文件异步下载
    • 文件上传-SDK云存储(参考:本地文件上传)
    • 文件CDN转URL
    • 个微文件下载
    • 企微文件下载
    • 文件上传-URL
  • 朋友圈模块
    • POST 朋友圈文件上传
    • 朋友圈列表分页
    • 获取详情-批量
    • 发送朋友圈
    • 删除朋友圈
    • 点赞/取消赞
    • 评论/追评
    • 评论删除
  • 个人模块
    • 生成二维码
    • 获取个人信息
    • 更新个人信息
    • 查询企业信息
    • 账号退出
    • 个人收藏-分页
    • 个人收藏-添加GIF表情
  • 标签模块
    • 列表分页
    • 个人标签-增删改
    • 客户标签-增删
  1. 联系人模块

联系人详情-By二维码

POST
/work-weixin/api/doApi

联系人详情-By二维码#

• 调用方需要将个微、企V名片二维码中的url提取出来

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "method": "string",
    "params": {
        "guid": "string",
        "qrUrl": "string"
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/work-weixin/api/doApi' \
--header 'X-QIWEI-TOKEN;' \
--header 'Content-Type: application/json' \
--data '{
    "method": "string",
    "params": {
        "guid": "string",
        "qrUrl": "string"
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "data": {
        "recommendContact": {
            "type": 2,
            "userInfo": {
                "userId": 16800000008,
                "name": "222nickname",
                "otherEmail": "",
                "birthday": "",
                "mobile": "",
                "tel": "",
                "department": "",
                "job": "",
                "number": "",
                "gender": 1,
                "avatarUrl": "https://wework.qpic.cn/wwpic3az/63zgl_177724/0",
                "level": 0,
                "corpId": 1970000000004,
                "hash": 0,
                "departmentId": 0,
                "attr": 8719168,
                "email": "",
                "displayOrder": 0,
                "permissionParty": null,
                "bizUin": 0,
                "position": "",
                "englishName": "222alias",
                "mainPartyId": 168800000009946,
                "groupId": 2251800000000116,
                "isNameVerified": true,
                "internationCode": "",
                "bindEmail": "",
                "partyMemberOrder": 0,
                "qqMailUin": 0,
                "accountId": "st",
                "nameStatus": 1,
                "vCreateMail": "",
                "realName": "张三",
                "underVerifyName": "",
                "vCorpNameShort": "",
                "vCorpNameFull": "",
                "vCorpUseStatus": 0,
                "vIsInitModer": false,
                "vHosterVid": 0,
                "address": "",
                "externalJobTitle": "",
                "unionid": "ozynqsqh800000000MIWt9ylVU",
                "externalCorpInfo": "",
                "pstnExtensionNumberNew": "",
                "externalPb": "",
                "vCode": "vcf42800000000594",
                "authName": "222alias",
                "corpName": "CorpName",
                "corpEmail": ""
            },
            "corpBriefInfo": {
                "corpId": 1970000000004,
                "vid": 16800000008,
                "corpName": "CorpName",
                "corpCreateTime": 1763529521,
                "corpOwnerName": "222nickname",
                "staffNum": 0,
                "isTrust": true,
                "corpLogo": "https://wework.qpic.cn/wwpic3az/511/0",
                "corpDesc": "",
                "staffInfo": {
                    "name": "222nickname",
                    "corpRank": "",
                    "corpPosition": "",
                    "phone": "180000000",
                    "mail": "",
                    "headImage": "https://wework.qpic.cn/wwpi64/0",
                    "corpMail": "",
                    "internationCode": "86",
                    "realName": "",
                    "englishName": "222alias",
                    "pstnExtensionNumber": "",
                    "attr": 0,
                    "corpMailActive": false,
                    "customCheckStatus": 0
                },
                "unreadNum": 0,
                "corpAdminId": 16800000008,
                "memAppliTime": 0,
                "memCreateTime": 0,
                "isAccepted": true,
                "corpStat": 0,
                "mobileNeedAuth": "",
                "emailNeedAuth": "",
                "internationCode": "",
                "qyhInfo": "",
                "mail": "",
                "corpFullName": "",
                "modUserInfo": {
                    "userId": 0,
                    "name": ""
                },
                "isInitModUser": false,
                "workCardFaceUrl": "",
                "workCardBackUrl": "",
                "corpUseStatus": 0,
                "virtualCorpClaimingName": "",
                "virtualCanChangeFullName": false,
                "virtualCorpShortNameList": null,
                "authTime": 0,
                "verifySubmitTime": 0,
                "corpSourceInfo": "",
                "verifyMsg": "",
                "virtualCorpFullNameList": null,
                "bHasInfoCorp": false,
                "vInitDomainName": "",
                "language": 1,
                "cardUrl": "https://work.weixin.qq.com/wework_admin/user/h5/corp?",
                "authedDomain": "",
                "vSuperAdminVid": 0,
                "vSuperAdminName": "",
                "bAuthedLicence": false,
                "joinNeedVerify": false,
                "customCheckUrl": "",
                "pstnMainNumber": "",
                "pstnOfficePhoneState": 0,
                "bNeedUpdateName": false,
                "bHasToken": false,
                "scorpId": "wwa58000000000a67",
                "isCorpVerify": false,
                "bNeedNotVerify": false,
                "personalWorkInfo": "",
                "personalWorkType": 0,
                "isOverseasCorp": false,
                "bInternetIndustry": false
            },
            "wechatSex": 0,
            "ticket": "A48A6B075010D9B60EA80000000039581716A712F800000000FF80737BA34C1729",
            "recommendReason": 0,
            "checkInfoKey": "CKK800000000m+g=="
        },
        "wxInfo": {
            "nickname": "巴脑",
            "imageUrl": "http://wx.qlogo.cn/mK9g/0",
            "gender": 1,
            "status": 0,
            "openId": "o9cqJaw@im.wechat",
            "unionId": "",
            "addContactCookie": "v1_40655e5aaf2a4ceb769ae774f9dc800000000f20e645c4b253e5",
            "xId": 7881800000000450,
            "applyContent": ""
        }
    },
    "msg": "成功"
}
修改于 2026-07-18 05:03:27
上一页
联系人详情-批量
下一页
外部联系人分页
Built with