获取司机信息
更新时间:2024.11.18||
接口说明
请求方式:【GET】/v3/taxi-invoice/drivers/{driver_license}
请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点
【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看
请求参数
Header HTTP头参数
Authorization 必填 string
Accept 必填 string
path 路径参数
driver_license 必填 string(128)
query 查询参数
region_id 必填 integer
请求示例
GET

1curl -X GET \
2 https://api.mch.weixin.qq.com/v3/taxi-invoice/drivers/6298416?region_id=510100 \
3 -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4 -H "Accept: application/json"
5
应答参数
折叠全部参数
driver_name 必填 string(1024)
【司机姓名】司机姓名,需要用微信支付平台证书中的公钥,对其进行加密
company_name 必填 string(64)
company_mchid 必填 string(20)
driver_license 必填 string(128)
driver_category 必填 string
可选取值:
driver_photo 选填 object
 | 属性 |
| photo_type 选填 string 可选取值:
photo_digest 选填 object  | 属性 | | hash_type 选填 string 【哈希类型】哈希类型,MD5:MD5算法,目前仅支持MD5
可选取值:
hash_value 选填 string(512) |
photo_url 选填 string(1024)
photo_data 选填 string(65000) |
region_id 必填 integer
driver_state 必填 string
可选取值:
应答示例
200 OK

1{
2 "driver_name" : "OpldWegML3fJ3/U5L6av0bU6GcIOaOhXf2UDYKD8aZByMIav4gGrxjcPPk/7rz7HJ1MOugpoI1KMG8nANKIGtyA75ZM7qM16j16CT0VUtmZMo2nV2/3x/058hpAOORYwkl2g/tOck3MgVwTj9ZTvq6s7wrWomyi+SY04APUv4dfFrUvfbktxSi9JI37tSIP5rXD0Lq35KCZLR0aIyVlBs/MqmAhdQ1klK+kKY2VvC2/DmIY0BmpV/o745eOjWwtlS0PzG7BQ3JYUqhtmz2SawsVeHk9sm1wwPUXFM1ssRN/t2DrNLxVUb77DCnz421UAD7US5TWiL5sVnQSz/wvsvQ==",
3 "company_name" : "深圳市未来有限公司",
4 "company_mchid" : "1900000109",
5 "driver_license" : "6298416",
6 "driver_category" : "MAIN",
7 "driver_photo" : {
8 "photo_type" : "PHOTO_URL",
9 "photo_digest" : {
10 "hash_type" : "MD5",
11 "hash_value" : "e10adc3949ba59abbe56e057f20f883e"
12 },
13 "photo_url" : "http://www.abc.com/driver.icon",
14 "photo_data" : "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"
15 },
16 "region_id" : 510100,
17 "driver_state" : "ACTIVE"
18}
19
错误码
公共错误码
|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
业务错误码
|
400 | PARAM_ERROR | 请检查参数格式是否符合要求 | 请使用正确的参数重新调用 |
403 | NO_AUTH | 出租车公司不属于服务商 | 请检查出租车经营主体商户号,确认是【新增出租车公司】接口返回的商户号 |
403 | NO_AUTH | 服务商无权限 | 请检查是否已经开通出租车电子发票产品相关功能权限 |
404 | NOT_FOUND | 所查询的出租车不存在 | 请检查营运资格证号和行政区划代码 |
404 | NOT_FOUND | 未找到指定的出租车经营主体信息 | 请检查出租车经营主体商户号和行政区划代码,确认公司存在且没有下线 |