通过二维码查询联系人

POST

https://console.wecomapi.com/wecom/finder/api

接口提示

通过联系人二维码链接查询联系人信息，适合从名片二维码进入添加或识别流程。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://console.wecomapi.com/wecom/finder/api' \
--header 'WECOM-TOKEN: ' \
--header 'Content-Type: application/json' \
--data '{
  "method": "/contact/searchContact",
  "params": {
    "guid": "",
    "qrUrl": "https://work.weixin.qq.com/u/xxxx"
  }
}'

响应示例

结构示例，字段值仅作展示；非本次实际请求结果。

{
  "code": 0,
  "msg": "成功",
  "data": {
    "recommendContact": {
      "type": 0,
      "userInfo": {
        "userId": 0,
        "name": "",
        "otherEmail": "",
        "birthday": "",
        "mobile": "",
        "tel": "",
        "department": "",
        "job": "",
        "number": "",
        "gender": 0,
        "avatarUrl": "",
        "level": 0,
        "corpId": 0,
        "hash": 0,
        "departmentId": 0,
        "attr": 0,
        "email": "",
        "displayOrder": 0,
        "permissionParty": null,
        "bizUin": 0,
        "position": "",
        "englishName": "",
        "mainPartyId": 0,
        "groupId": 0,
        "isNameVerified": false,
        "internationCode": "",
        "bindEmail": "",
        "partyMemberOrder": 0,
        "qqMailUin": 0,
        "accountId": "",
        "nameStatus": 0,
        "vCreateMail": "",
        "realName": "",
        "underVerifyName": "",
        "vCorpNameShort": "",
        "vCorpNameFull": "",
        "vCorpUseStatus": 0,
        "vIsInitModer": false,
        "vHosterVid": 0,
        "address": "",
        "externalJobTitle": "",
        "unionid": "",
        "externalCorpInfo": "",
        "pstnExtensionNumberNew": "",
        "externalPb": "",
        "vCode": "",
        "authName": "",
        "corpName": "",
        "corpEmail": ""
      },
      "corpBriefInfo": {
        "corpId": 0,
        "vid": 0,
        "corpName": "",
        "corpCreateTime": 0,
        "corpOwnerName": "",
        "staffNum": 0,
        "isTrust": false,
        "corpLogo": "",
        "corpDesc": "",
        "staffInfo": {
          "name": "",
          "corpRank": "",
          "corpPosition": "",
          "phone": "",
          "mail": "",
          "headImage": "",
          "corpMail": "",
          "internationCode": "",
          "realName": "",
          "englishName": "",
          "pstnExtensionNumber": "",
          "attr": 0,
          "corpMailActive": false,
          "customCheckStatus": 0
        },
        "unreadNum": 0,
        "corpAdminId": 0,
        "memAppliTime": 0,
        "memCreateTime": 0,
        "isAccepted": false,
        "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": 0,
        "cardUrl": "",
        "authedDomain": "",
        "vSuperAdminVid": 0,
        "vSuperAdminName": "",
        "bAuthedLicence": false,
        "joinNeedVerify": false,
        "customCheckUrl": "",
        "pstnMainNumber": "",
        "pstnOfficePhoneState": 0,
        "bNeedUpdateName": false,
        "bHasToken": false,
        "scorpId": "",
        "isCorpVerify": false,
        "bNeedNotVerify": false,
        "personalWorkInfo": "",
        "personalWorkType": 0,
        "isOverseasCorp": false,
        "bInternetIndustry": false
      },
      "wechatSex": 0,
      "ticket": "",
      "recommendReason": 0,
      "checkInfoKey": ""
    },
    "wxInfo": {
      "nickname": "",
      "imageUrl": "",
      "gender": 0,
      "status": 0,
      "openId": "",
      "unionId": "",
      "addContactCookie": "",
      "xId": 0,
      "applyContent": ""
    }
  }
}

搜索联系人

添加个微联系人