用于查詢已注冊的服務人員ID等信息。
注意:
個人微信商家
- 傳入門店ID,查詢該門店下的所有已注冊服務人員的信息(每次查詢不可超過10條)
- 傳入服務人員的工號(服務人員注冊時填寫)或手機號,查詢單個服務人員的信息。
企業(yè)微信商家
- 傳入門店ID,查詢該門店下的所有已注冊服務人員的信息(每次查詢不可超過10條)
- 傳入服務人員的企業(yè)微信員工ID或手機號,查詢單個服務人員的信息。
服務人員注冊API和查詢API請求URL相同,區(qū)別主要是在body和query,請注意區(qū)分。
# 接口說明
支持商戶:
【普通服務商】
請求方式:
【GET】/v3/smartguide/guides
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數
Header HTTP頭參數
- sub_mchid 選填 string(64)【子商戶ID】 導購所屬商戶的商戶ID
- store_id 必填 integer【門店ID】 門店在微信支付商戶平臺的唯一標識
- userid 選填 string(64)【企業(yè)微信的員工ID】 員工在商戶企業(yè)微信通訊錄使用的唯一標識,企業(yè)微信商家可傳入
- mobile 選填 string【手機號碼】 服務人員通過小程序注冊時填寫的手機號碼,該字段需進行加密處理,加密方法詳見敏感信息加密說明
- work_id 選填 string【工號】 服務人員通過小程序注冊時填寫的工號,個人微信商家可傳入
- limit 選填 integer【最大資源條數】 該次請求可返回的最大資源條數,不大于10
- offset 選填 integer【請求資源起始位置】 該次請求資源的起始位置,默認值為0
Query 查詢參數
請求示例
GET
# 應答參數
- data 選填 array[Guide]【服務人員列表】
- 屬性
- total_count 選填 integer【服務人員數量】 符合條件篩選的服務人員數量
- limit 選填 integer【最大資源條數】 該次請求可返回的最大資源條數,不大于10
- offset 選填 integer【請求資源起始位置】 該次請求資源的起始位置,默認值為0
200OK
應答示例
200 OK
# 錯誤碼
# 公共錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數錯誤 | 請根據錯誤提示正確傳入參數 |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 子商戶未授權 | 子商戶未授權,請聯(lián)系子商戶授權 |
400 | INVALID_REQUEST | 子商戶產品權限未開通 | 子商戶產品權限未開通,請聯(lián)系子商戶開通 |
400 | INVALID_REQUEST | 子商戶產品配置未完成 | 子商戶產品配置未完成,請確認子商戶完成產品配置后重試 |
400 | MCH_NOT_EXISTS | 子商戶不存在 | 請確認商戶號是否有誤 |
400 | MCH_NOT_EXISTS | 商戶號格式錯誤 | 請確認商戶號是否有誤 |
400 | MCH_NOT_EXISTS | 子商戶號格式錯誤 | 請確認商戶號是否有誤 |
400 | MCH_NOT_EXISTS | 子商戶號為空 | 請?zhí)顚懽由虘籼?/td> |
400 | PARAM_ERROR | 必填參數為空 | 根據錯誤提示,傳入正確參數 |
400 | PARAM_ERROR | 門店ID格式錯誤 | 根據錯誤提示,傳入正確參數 |
400 | PARAM_ERROR | userid格式錯誤 | 根據錯誤提示,傳入正確參數 |
400 | PARAM_ERROR | 手機號碼格式錯誤 | 根據錯誤提示,傳入正確參數 |
400 | PARAM_ERROR | 門店ID為空 | 請?zhí)顚戦T店ID |
400 | PARAM_ERROR | 個人微信商家不應填寫企業(yè)微信ID | 根據錯誤提示,傳入正確參數 |
400 | PARAM_ERROR | 企業(yè)微信商家不應填寫工號 | 根據錯誤提示,傳入正確參數 |
400 | PARAM_ERROR | 最大資源條數大于10 | 根據錯誤提示,傳入正確參數 |
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 請使用相同參數稍后重新調用 |
500 | SYSTEM_ERROR | 擴展父子商戶票據錯誤 | 請使用相同參數稍后重新調用 |
500 | SYSTEM_ERROR | 調用云函數錯誤 | 請使用相同參數稍后重新調用 |