# 联系人详情-By二维码
## OpenAPI Specification
```yaml
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/api/qw/doApi:
post:
summary: 联系人详情-By二维码
deprecated: false
description: >-
联系人详情-By二维码
调用方需要将个微、企V名片二维码中的url提取出来
tags:
- API参考/客户管理/联系人模块
parameters:
- name: Content-Type
in: header
description: ''
required: true
example: application/json
schema:
type: string
- name: X-QIWEI-TOKEN
in: header
description: >-
进入 应用凭证，复制
TokenId。
required: true
example: '{{tokenId}}'
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
method:
type: string
description: >-
/contact/searchContact
title: 执行方法
params:
type: object
properties:
guid:
type: string
title: 设备 ID
description: >-
设备唯一标识 guid，由「创建设备」接口返回，业务接口必传。
qrUrl:
type: string
description: >-
二维码中的url
title: Qr链接
required:
- guid
- qrUrl
x-apifox-orders:
- guid
- qrUrl
title: 请求参数
required:
- method
- params
x-apifox-orders:
- method
- params
example:
method: /contact/searchContact
params:
guid: '{{guid}}'
qrUrl: >-
https://work.weixin.qq.com/u/vcf7cb594?v=5.0.7.213815&bb=ccdf71f
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties:
code:
type: integer
title: 状态码
description: >-
状态码，0 成功。
data:
type: object
properties:
recommendContact:
type: object
properties:
type:
type: integer
title: 类型
description: ''
userInfo:
type: object
properties:
userId:
type: integer
title: 成员 ID
description: >-
成员 userId，可通过联系人相关接口获取
name:
type: string
title: 名称
description: ''
otherEmail:
type: string
title: 其他邮箱
description: ''
birthday:
type: string
title: 生日
description: ''
mobile:
type: string
title: 手机号
description: ''
tel:
type: string
title: 电话
description: ''
department:
type: string
title: 部门
description: ''
job:
type: string
title: 职位
description: ''
number:
type: string
title: 号码
description: ''
gender:
type: integer
title: 性别
description: ''
avatarUrl:
type: string
title: 头像链接
description: ''
level:
type: integer
title: 级别
description: ''
corpId:
type: integer
title: 企业 ID
description: ''
hash:
type: integer
title: Hash 值
description: ''
departmentId:
type: integer
title: 部门 ID
description: ''
attr:
type: integer
title: 属性
description: ''
email:
type: string
title: 邮箱
description: ''
displayOrder:
type: integer
title: 显示顺序
description: ''
permissionParty:
type: 'null'
title: 权限部门
description: ''
bizUin:
type: integer
title: 业务Uin
description: ''
position:
type: string
title: 职位
description: ''
englishName:
type: string
title: English名称
description: ''
mainPartyId:
type: integer
title: 主部门 ID
description: ''
groupId:
type: integer
title: 分组Id
description: ''
isNameVerified:
type: boolean
title: 是否名称Verified
description: ''
internationCode:
type: string
title: 国际码
description: ''
bindEmail:
type: string
title: Bind邮箱
description: ''
partyMemberOrder:
type: integer
title: Party成员Order
description: ''
qqMailUin:
type: integer
title: QQ 邮箱 UIN
description: ''
accountId:
type: string
title: 账号 ID
description: ''
nameStatus:
type: integer
title: 名称状态
description: ''
vCreateMail:
type: string
title: V创建Mail
description: ''
realName:
type: string
title: Real名称
description: ''
underVerifyName:
type: string
title: Under验证名称
description: ''
vCorpNameShort:
type: string
title: V企业名称Short
description: ''
vCorpNameFull:
type: string
title: V企业名称Full
description: ''
vCorpUseStatus:
type: integer
title: V企业使用状态
description: ''
vIsInitModer:
type: boolean
title: V是否InitModer
description: ''
vHosterVid:
type: integer
title: VHoster 标识
description: ''
address:
type: string
title: 地址
description: ''
externalJobTitle:
type: string
title: 外部职位
description: ''
unionid:
type: string
title: Union 标识
description: ''
externalCorpInfo:
type: string
title: External企业信息
description: ''
pstnExtensionNumberNew:
type: string
title: PstnExtensionNumber新
description: ''
externalPb:
type: string
title: 外部 Pb
description: ''
vCode:
type: string
title: V码
description: ''
authName:
type: string
title: 鉴权名称
description: ''
corpName:
type: string
title: 企业名称
description: ''
corpEmail:
type: string
title: 企业邮箱
description: ''
required:
- userId
- name
- otherEmail
- birthday
- mobile
- tel
- department
- job
- number
- gender
- avatarUrl
- level
- corpId
- hash
- departmentId
- attr
- email
- displayOrder
- permissionParty
- bizUin
- position
- englishName
- mainPartyId
- groupId
- isNameVerified
- internationCode
- bindEmail
- partyMemberOrder
- qqMailUin
- accountId
- nameStatus
- vCreateMail
- realName
- underVerifyName
- vCorpNameShort
- vCorpNameFull
- vCorpUseStatus
- vIsInitModer
- vHosterVid
- address
- externalJobTitle
- unionid
- externalCorpInfo
- pstnExtensionNumberNew
- externalPb
- vCode
- authName
- corpName
- corpEmail
x-apifox-orders:
- userId
- name
- otherEmail
- birthday
- mobile
- tel
- department
- job
- number
- gender
- avatarUrl
- level
- corpId
- hash
- departmentId
- attr
- email
- displayOrder
- permissionParty
- bizUin
- position
- englishName
- mainPartyId
- groupId
- isNameVerified
- internationCode
- bindEmail
- partyMemberOrder
- qqMailUin
- accountId
- nameStatus
- vCreateMail
- realName
- underVerifyName
- vCorpNameShort
- vCorpNameFull
- vCorpUseStatus
- vIsInitModer
- vHosterVid
- address
- externalJobTitle
- unionid
- externalCorpInfo
- pstnExtensionNumberNew
- externalPb
- vCode
- authName
- corpName
- corpEmail
title: 用户信息
description: ''
corpBriefInfo:
type: object
properties:
corpId:
type: integer
title: 企业 ID
description: ''
vid:
type: integer
title: Vid 标识
description: ''
corpName:
type: string
title: 企业名称
description: ''
corpCreateTime:
type: integer
title: 企业创建时间
description: ''
corpOwnerName:
type: string
title: 企业负责人名称
description: ''
staffNum:
type: integer
title: 员工编号
description: ''
isTrust:
type: boolean
title: 是否Trust
description: ''
corpLogo:
type: string
title: 企业Logo
description: ''
corpDesc:
type: string
title: 企业描述
description: ''
staffInfo:
type: object
properties:
name:
type: string
title: 名称
description: ''
corpRank:
type: string
title: 企业Rank
description: ''
corpPosition:
type: string
title: 企业Position
description: ''
phone:
type: string
title: 电话
description: ''
mail:
type: string
title: 邮箱
description: ''
headImage:
type: string
title: 头像图片
description: ''
corpMail:
type: string
title: 企业Mail
description: ''
internationCode:
type: string
title: 国际码
description: ''
realName:
type: string
title: Real名称
description: ''
englishName:
type: string
title: English名称
description: ''
pstnExtensionNumber:
type: string
title: 分机号
description: ''
attr:
type: integer
title: 属性
description: ''
corpMailActive:
type: boolean
title: 企业Mail活跃
description: ''
customCheckStatus:
type: integer
title: CustomCheck状态
description: ''
required:
- name
- corpRank
- corpPosition
- phone
- mail
- headImage
- corpMail
- internationCode
- realName
- englishName
- pstnExtensionNumber
- attr
- corpMailActive
- customCheckStatus
x-apifox-orders:
- name
- corpRank
- corpPosition
- phone
- mail
- headImage
- corpMail
- internationCode
- realName
- englishName
- pstnExtensionNumber
- attr
- corpMailActive
- customCheckStatus
title: Staff信息
description: ''
unreadNum:
type: integer
title: 未读数
description: ''
corpAdminId:
type: integer
title: 企业管理员Id
description: ''
memAppliTime:
type: integer
title: MemAppli时间
description: ''
memCreateTime:
type: integer
title: Mem创建时间
description: ''
isAccepted:
type: boolean
title: 是否Accepted
description: ''
corpStat:
type: integer
title: 企业Stat
description: ''
mobileNeedAuth:
type: string
title: 手机号Need鉴权
description: ''
emailNeedAuth:
type: string
title: 邮箱Need鉴权
description: ''
internationCode:
type: string
title: 国际码
description: ''
qyhInfo:
type: string
title: Qyh信息
description: ''
mail:
type: string
title: 邮箱
description: ''
corpFullName:
type: string
title: 企业Full名称
description: ''
modUserInfo:
type: object
properties:
userId:
type: integer
title: 成员 ID
description: >-
成员
userId，可通过联系人相关接口获取
name:
type: string
title: 名称
description: ''
required:
- userId
- name
x-apifox-orders:
- userId
- name
title: Mod用户信息
description: ''
isInitModUser:
type: boolean
title: 是否InitMod用户
description: ''
workCardFaceUrl:
type: string
title: WorkCardFace链接
description: ''
workCardBackUrl:
type: string
title: WorkCardBack链接
description: ''
corpUseStatus:
type: integer
title: 企业使用状态
description: ''
virtualCorpClaimingName:
type: string
title: Virtual企业Claiming名称
description: ''
virtualCanChangeFullName:
type: boolean
title: VirtualCanChangeFull名称
description: ''
virtualCorpShortNameList:
type: 'null'
title: Virtual企业Short名称列表
description: ''
authTime:
type: integer
title: 鉴权时间
description: ''
verifySubmitTime:
type: integer
title: 验证Submit时间
description: ''
corpSourceInfo:
type: string
title: 企业Source信息
description: ''
verifyMsg:
type: string
title: 验证消息
description: ''
virtualCorpFullNameList:
type: 'null'
title: Virtual企业Full名称列表
description: ''
bHasInfoCorp:
type: boolean
title: B含信息企业
description: ''
vInitDomainName:
type: string
title: VInitDomain名称
description: ''
language:
type: integer
title: 语言
description: ''
cardUrl:
type: string
title: Card链接
description: ''
authedDomain:
type: string
title: 授权域名
description: ''
vSuperAdminVid:
type: integer
title: VSuper管理员Vid
description: ''
vSuperAdminName:
type: string
title: VSuper管理员名称
description: ''
bAuthedLicence:
type: boolean
title: 授权许可
description: ''
joinNeedVerify:
type: boolean
title: 加入Need验证
description: ''
customCheckUrl:
type: string
title: CustomCheck链接
description: ''
pstnMainNumber:
type: string
title: 总机号
description: ''
pstnOfficePhoneState:
type: integer
title: 办公电话状态
description: ''
bNeedUpdateName:
type: boolean
title: BNeedUpdate名称
description: ''
bHasToken:
type: boolean
title: B含Token
description: ''
scorpId:
type: string
title: Scorp 标识
description: ''
isCorpVerify:
type: boolean
title: 是否企业验证
description: ''
bNeedNotVerify:
type: boolean
title: BNeedNot验证
description: ''
personalWorkInfo:
type: string
title: PersonalWork信息
description: ''
personalWorkType:
type: integer
title: PersonalWork类型
description: ''
isOverseasCorp:
type: boolean
title: 是否Overseas企业
description: ''
bInternetIndustry:
type: boolean
title: 互联网行业
description: ''
required:
- corpId
- vid
- corpName
- corpCreateTime
- corpOwnerName
- staffNum
- isTrust
- corpLogo
- corpDesc
- staffInfo
- unreadNum
- corpAdminId
- memAppliTime
- memCreateTime
- isAccepted
- corpStat
- mobileNeedAuth
- emailNeedAuth
- internationCode
- qyhInfo
- mail
- corpFullName
- modUserInfo
- isInitModUser
- workCardFaceUrl
- workCardBackUrl
- corpUseStatus
- virtualCorpClaimingName
- virtualCanChangeFullName
- virtualCorpShortNameList
- authTime
- verifySubmitTime
- corpSourceInfo
- verifyMsg
- virtualCorpFullNameList
- bHasInfoCorp
- vInitDomainName
- language
- cardUrl
- authedDomain
- vSuperAdminVid
- vSuperAdminName
- bAuthedLicence
- joinNeedVerify
- customCheckUrl
- pstnMainNumber
- pstnOfficePhoneState
- bNeedUpdateName
- bHasToken
- scorpId
- isCorpVerify
- bNeedNotVerify
- personalWorkInfo
- personalWorkType
- isOverseasCorp
- bInternetIndustry
x-apifox-orders:
- corpId
- vid
- corpName
- corpCreateTime
- corpOwnerName
- staffNum
- isTrust
- corpLogo
- corpDesc
- staffInfo
- unreadNum
- corpAdminId
- memAppliTime
- memCreateTime
- isAccepted
- corpStat
- mobileNeedAuth
- emailNeedAuth
- internationCode
- qyhInfo
- mail
- corpFullName
- modUserInfo
- isInitModUser
- workCardFaceUrl
- workCardBackUrl
- corpUseStatus
- virtualCorpClaimingName
- virtualCanChangeFullName
- virtualCorpShortNameList
- authTime
- verifySubmitTime
- corpSourceInfo
- verifyMsg
- virtualCorpFullNameList
- bHasInfoCorp
- vInitDomainName
- language
- cardUrl
- authedDomain
- vSuperAdminVid
- vSuperAdminName
- bAuthedLicence
- joinNeedVerify
- customCheckUrl
- pstnMainNumber
- pstnOfficePhoneState
- bNeedUpdateName
- bHasToken
- scorpId
- isCorpVerify
- bNeedNotVerify
- personalWorkInfo
- personalWorkType
- isOverseasCorp
- bInternetIndustry
title: 企业Brief信息
description: ''
wechatSex:
type: integer
title: 微信性别
description: ''
ticket:
type: string
title: Ticket 凭证
description: ''
recommendReason:
type: integer
title: 推荐Reason
description: ''
checkInfoKey:
type: string
title: Check信息Key
description: ''
required:
- type
- userInfo
- corpBriefInfo
- wechatSex
- ticket
- recommendReason
- checkInfoKey
x-apifox-orders:
- type
- userInfo
- corpBriefInfo
- wechatSex
- ticket
- recommendReason
- checkInfoKey
description: >-
企V账号信息
title: 推荐联系人
wxInfo:
type: object
properties:
nickname:
type: string
title: 昵称
description: ''
imageUrl:
type: string
title: 图片链接
description: ''
gender:
type: integer
title: 性别
description: ''
status:
type: integer
title: 状态码
description: ''
openId:
type: string
title: Open 标识
description: ''
unionId:
type: string
title: Union 标识
description: ''
addContactCookie:
type: string
title: Add联系人Cookie
description: ''
xId:
type: integer
title: X 标识
description: ''
applyContent:
type: string
title: 申请内容
description: ''
required:
- nickname
- imageUrl
- gender
- status
- openId
- unionId
- addContactCookie
- xId
- applyContent
x-apifox-orders:
- nickname
- imageUrl
- gender
- status
- openId
- unionId
- addContactCookie
- xId
- applyContent
description: >-
个V账号信息
title: Wx信息
required:
- recommendContact
- wxInfo
x-apifox-orders:
- recommendContact
- wxInfo
title: 响应数据
description: >-
业务数据。
msg:
type: string
title: 说明
description: >-
返回说明。
required:
- code
- data
- msg
x-apifox-orders:
- code
- data
- msg
example:
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: 成功
headers: {}
x-apifox-name: 成功
security: []
x-apifox-folder: API参考/客户管理/联系人模块
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/7051713/apis/api-344613867-run
components:
schemas: {}
securitySchemes:
apiKey:
type: apikey
in: header
name: X-WECOM-TOKEN
servers:
- url: https://new.qiweapi.com/qiwe
description: 正式环境
security: []
```