用于查询已注册的服务人员ID等信息。

注意：

个人微信商家

1. 传入门店ID，查询该门店下的所有已注册服务人员的信息（每次查询不可超过10条）
2. 传入服务人员的工号（服务人员注册时填写）或手机号，查询单个服务人员的信息。

企业微信商家

1. 传入门店ID，查询该门店下的所有已注册服务人员的信息（每次查询不可超过10条）
2. 传入服务人员的企业微信员工ID或手机号，查询单个服务人员的信息。

服务人员注册API和查询API请求URL相同，区别主要是在body和query，请注意区分。

接口说明

支持商户：

【普通商户】

请求方式：

【GET】/v3/smartguide/guides

请求域名：

【主域名】

https://api.mch.weixin.qq.com

使用该域名将访问就近的接入点

【备域名】

https://api2.mch.weixin.qq.com

使用该域名将访问异地的接入点 ，指引点击查看

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json
Wechatpay-Serial 必填 string
【微信支付平台证书序列号】 请求参数中的敏感字段，需要使用微信支付平台证书公钥加密。请设置为该证书的证书序列号。详见敏感信息加解密

Query 查询参数
store_id 必填 integer
【门店ID】 门店在微信支付商户平台的唯一标识
userid 选填 string(64)
【企业微信的员工ID】 员工在商户企业微信通讯录使用的唯一标识，企业微信商家可传入
mobile 选填 string
【手机号码】 服务人员通过小程序注册时填写的手机号码，该字段需进行加密处理，加密方法详见敏感信息加密说明
work_id 选填 string
【工号】 服务人员通过小程序注册时填写的工号，个人微信商家可传入
limit 选填 integer
【最大资源条数】 该次请求可返回的最大资源条数，不大于10
offset 选填 integer
【请求资源起始位置】 该次请求资源的起始位置，默认值为0

请求示例

GET

应答参数

200OK
data 选填 array[Guide]
【服务人员列表】
• 属性
total_count 选填 integer
【服务人员数量】 符合条件筛选的服务人员数量
limit 选填 integer
【最大资源条数】 该次请求可返回的最大资源条数，不大于10
offset 选填 integer
【请求资源起始位置】 该次请求资源的起始位置，默认值为0

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅 接口规则
401	SIGN_ERROR	验证不通过	请参阅 签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	子商户未授权	子商户未授权,请联系子商户授权
400	INVALID_REQUEST	子商户产品权限未开通	子商户产品权限未开通,请联系子商户开通
400	INVALID_REQUEST	子商户产品配置未完成	子商户产品配置未完成,请确认子商户完成产品配置后重试
400	MCH_NOT_EXISTS	子商户不存在	请确认商户号是否有误
400	MCH_NOT_EXISTS	商户号格式错误	请确认商户号是否有误
400	MCH_NOT_EXISTS	子商户号格式错误	请确认商户号是否有误
400	MCH_NOT_EXISTS	子商户号为空	请填写子商户号
400	PARAM_ERROR	必填参数为空	根据错误提示，传入正确参数
400	PARAM_ERROR	门店ID格式错误	根据错误提示，传入正确参数
400	PARAM_ERROR	userid格式错误	根据错误提示，传入正确参数
400	PARAM_ERROR	手机号码格式错误	根据错误提示，传入正确参数
400	PARAM_ERROR	门店ID为空	请填写门店ID
400	PARAM_ERROR	个人微信商家不应填写企业微信ID	根据错误提示，传入正确参数
400	PARAM_ERROR	企业微信商家不应填写工号	根据错误提示，传入正确参数
400	PARAM_ERROR	最大资源条数大于10	根据错误提示，传入正确参数
500	SYSTEM_ERROR	系统错误	请使用相同参数稍后重新调用
500	SYSTEM_ERROR	扩展父子商户票据错误	请使用相同参数稍后重新调用
500	SYSTEM_ERROR	调用云函数错误	请使用相同参数稍后重新调用