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