最新更新時間:2020.9.15 版本說明
用于服務商開發(fā)者查詢已注冊的服務人員ID等信息。
個人微信商家
? 1.傳入門店ID,查詢該門店下的所有已注冊服務人員的信息(每次查詢不可超過10條)
? 2.傳入服務人員的工號(服務人員注冊時填寫)或手機號,查詢單個服務人員的信息。
企業(yè)微信商家
? 1.傳入門店ID,查詢該門店下的所有已注冊服務人員的信息(每次查詢不可超過10條)
? 2.傳入服務人員的企業(yè)微信員工ID或手機號,查詢單個服務人員的信息。
服務人員注冊API和查詢API請求URL相同,區(qū)別主要是在body和query,請注意區(qū)分。
適用對象:服務商
請求URL:https://api.mch.weixin.qq.com/v3/smartguide/guides
請求方式:GET
path 指該參數(shù)路徑參數(shù)
query 指該參數(shù)需在請求URL傳參
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
子商戶ID | sub_mchid | string[1,64] | 否 | query服務人員所屬商戶的商戶ID 示例值:1234567890 |
門店ID | store_id | int | 是 | query門店在微信支付商戶平臺的唯一標識 示例值:1234 |
企業(yè)微信的員工ID | userid | string[1,64] | 否 | query員工在商戶企業(yè)微信通訊錄使用的唯一標識,企業(yè)微信商家可傳入該字段查詢單個服務人員信息;不傳則查詢整個門店下的服務人員信息 示例值:robert |
手機號碼 | mobile | string[1,512] | 否 | query服務人員通過小程序注冊時填寫的手機號碼,企業(yè)微信/個人微信商家可傳入該字段查詢單個服務人員信息;不傳則查詢整個門店下的服務人員信息。 該字段需進行加密處理,加密方法詳見敏感信息加密說明 特殊規(guī)則:加密前字段長度限制為32個字節(jié) 示例值:str2WoWy8uUiWM7xahvNv0lV3C+nn3t4QlKNnyr+iwlk2FoMcn/lxrR6YdKKFI6NFJkC5oyvzNwc1MDzIgjLR0W6bJKiwWeOV3Fp0x+VIoRDONal1Mgb6VTYg7lvACEqdwmVkvbt4/oEWaWP62njMGGe0fMiBSAvao3LrcsOwDvN3E9kiaw5XQZMP/rUdWTFfy5THuohcQobGMrxclHKAnwAHU8CWfkziW5crUc3Z83uMVcFQu38y9EcWR12FJ3jip5nyVKiqCF4iDSN+JRXjWsWlqTZ0Y8Q+piBCS5ACusK6nz7mKQeypi9fKjAggRfvNFPf/bNxPvork4mMVgZkA== |
工號 | work_id | string[1,20] | 否 | query服務人員通過小程序注冊時填寫的工號,個人微信商家可傳入該字段查詢單個服務人員信息;不傳則查詢整個門店下的服務人員信息 示例值:robert |
最大資源條數(shù) | limit | int | 否 | query商家自定義字段,該次請求可返回的最大資源條數(shù),不大于10 示例值:5 |
請求資源起始位置 | offset | int | 否 | query商家自定義字段,該次請求資源的起始位置,默認值為0
示例值:0 |
https://api.mch.weixin.qq.com/v3/smartguide/guides?store_id=1234&sub_mchid=1234567890
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
+服務人員列表 | data | array | 是 | 服務人員列表 |
服務人員數(shù)量 | total_count | int | 是 | 符合條件篩選的服務人員數(shù)量,當服務人員列表返回為空時,服務人員數(shù)量返回0;當服務人員列表有返回值時,服務人員數(shù)量按查詢到的值返回。 示例值:10 |
最大資源條數(shù) | limit | int | 是 | 該次請求可返回的最大資源條數(shù),不大于10 示例值:5 |
請求資源起始位置 | offset | int | 是 | 該次請求資源的起始位置,默認值為0 示例值:0 |
{
"data": [
{
"guide_id": "LLA3WJ6DSZUfiaZDS79FH5Wm5m4X69TBic",
"store_id": 1234,
"name": "str2WUc3Z83uMVcFQu38y9EcWR12FJ3jip5nyVKiqCF4iDSN+JRXjWsWlqTZ0Y8Q+piBCS5ACusK6nz7mKQeypi9fKjAggRfvNFPf/bNxPvork4mMVgZkA==",
"mobile": "str2WoWyZ83uMVcFQu38y9EcWR12FJ3jip5nyVKiqCF4iDSN+JRXjWsWlqTZ0Y8Q+piBCS5ACusK6nz7mKQeypi9fKjAggRfvNFPf/bNxPvork4mMVgZkA==",
"userid": "robert"
},
{
"guide_id": "LLA3WJ6DSZUfiaZDS79FH5Wm5m4X69TBic",
"store_id": 1234,
"name": "str2WUc3Z83uMVcFQu38y9EcWR12FJ3jip5nyVKiqCF4iDSN+JRXjWsWlqTZ0Y8Q+piBCS5ACusK6nz7mKQeypi9fKjAggRfvNFPf/bNxPvork4mMVgZkA==",
"mobile": "str2WoWyZ83uMVcFQu38y9EcWR12FJ3jip5nyVKiqCF4iDSN+JRXjWsWlqTZ0Y8Q+piBCS5ACusK6nz7mKQeypi9fKjAggRfvNFPf/bNxPvork4mMVgZkA==",
"work_id": "robert"
}
],
"total_count": 10,
"limit": 5,
"offset": 0
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 必填參數(shù)為空 | 根據(jù)錯誤提示,傳入正確參數(shù) |
門店ID格式錯誤 | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
userid格式錯誤 | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
手機號碼格式錯誤 | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
門店ID為空 | 請?zhí)顚戦T店id | ||
個人微信商家不應填寫企業(yè)微信id | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
企業(yè)微信商家不應填寫工號 | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
最大資源條數(shù)大于10 | 根據(jù)錯誤提示,傳入正確參數(shù) | ||
400 | MCH_NOT_EXISTS | 子商戶不存在 | 請確認商戶號是否有誤 |
商戶號格式錯誤 | 請確認商戶號是否有誤 | ||
子商戶號格式錯誤 | 請確認商戶號是否有誤 | ||
子商戶號為空 | 請?zhí)顚懽由虘籼? | ||
400 | INVALID_REQUEST | 子商戶未授權(quán) | 子商戶未授權(quán),請聯(lián)系子商戶授權(quán) |
子商戶產(chǎn)品權(quán)限未開通 | 子商戶產(chǎn)品權(quán)限未開通,請聯(lián)系子商戶開通 | ||
子商戶產(chǎn)品配置未完成 | 子商戶產(chǎn)品配置未完成,請確認子商戶完成產(chǎn)品配置后重試 | ||
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |
擴展父子商戶票據(jù)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 | ||
調(diào)用云函數(shù)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |