用于為商戶更新門店服務(wù)人員的姓名、頭像等信息。
注意:
個(gè)人微信商家、企業(yè)微信商家均支持服務(wù)人員信息更新
# 接口說明
支持商戶:
【普通商戶】
請(qǐng)求方式:
【PATCH】/v3/smartguide/guides/{guide_id}
請(qǐng)求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點(diǎn)【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點(diǎn) ,指引點(diǎn)擊查看
# 請(qǐng)求參數(shù)
- Authorization 必填 string請(qǐng)參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請(qǐng)?jiān)O(shè)置為
application/json
- Content-Type 必填 string請(qǐng)?jiān)O(shè)置為
application/json
- Wechatpay-Serial 必填 string【微信支付平臺(tái)證書序列號(hào)】 請(qǐng)求參數(shù)中的敏感字段,需要使用微信支付平臺(tái)證書公鑰加密。請(qǐng)?jiān)O(shè)置為該證書的證書序列號(hào)。詳見敏感信息加解密
Header HTTP頭參數(shù)
- guide_id 必填 string(64)【服務(wù)人員ID】 服務(wù)人員在支付即服務(wù)系統(tǒng)中的唯一標(biāo)識(shí)
Path 路徑參數(shù)
- name 選填 string【服務(wù)人員姓名】 需更新的服務(wù)人員姓名,不更新不需傳入,需使用微信支付平臺(tái)公鑰加密
- mobile 選填 string【服務(wù)人員手機(jī)號(hào)碼】 需更新的服務(wù)人員手機(jī)號(hào)碼,不更新不需傳入,需使用微信支付平臺(tái)公鑰加密
- qr_code 選填 string(1024)【服務(wù)人員二維碼URL】 需更新的服務(wù)人員二維碼,不更新不需傳入 企業(yè)微信商家適用,個(gè)人微信商家不可用
- avatar 選填 string(1024)【服務(wù)人員頭像URL】 需更新的服務(wù)人員頭像URL,不更新不需傳入
- group_qrcode 選填 string(1024)【群二維碼URL】 需更新的服務(wù)人員所在的企業(yè)微信群的“群活碼”二維碼串
Body 包體參數(shù)
請(qǐng)求示例
PATCH
# 應(yīng)答參數(shù)
無應(yīng)答包體
應(yīng)答示例
204 No Content
# 錯(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 | MCH_NOT_EXISTS | 商戶號(hào)格式錯(cuò)誤 | 請(qǐng)確認(rèn)商戶號(hào)是否有誤 |
400 | PARAM_ERROR | 必填參數(shù)為空 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
400 | PARAM_ERROR | 服務(wù)人員ID為空 | 請(qǐng)?zhí)顚懛?wù)人員ID |
400 | PARAM_ERROR | 服務(wù)人員ID格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
400 | PARAM_ERROR | 員工姓名格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
400 | PARAM_ERROR | 員工姓名過長 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
400 | PARAM_ERROR | 手機(jī)號(hào)碼格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
400 | PARAM_ERROR | 二維碼串格式錯(cuò)誤 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
400 | PARAM_ERROR | 頭像URL不是合法鏈接 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
400 | PARAM_ERROR | 非企業(yè)微信提供的頭像URL | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
400 | PARAM_ERROR | 個(gè)人微信商家不能改二維碼 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
400 | PARAM_ERROR | 所有可更新的參數(shù)都沒有填 | 根據(jù)錯(cuò)誤提示,傳入正確參數(shù) |
400 | PARAM_ERROR | 群二維碼URL格式錯(cuò)誤 | 根據(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)用 |