[关闭]
@Brave 2016-03-26T04:39:36.000000Z 字数 86010 阅读 7075

微配2.1版本API接口文档

@(车护宝)

接口索引

参考接口文档

1.接口身份认证

接口说明：访问接口需要提供指定的账号与密码，用于验证使用者身份信息。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
code code码 客户端申请的CODE码 string 是 无
api_key API KEY 客户端申请的API KEY string 是 无

请求实例：

  1. POST /v1/token HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "code":"third_party",
  7.     "api_key":"third_party_api_key"
  8. }

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "token": "6292abd23cabc078391c5a7be72f30b25fc5526d",
  6.     "exipiry_time": 1431938772
  7. }
返回参数 含义 参数类型 长度
token 身份令牌 string 32
exipiry_time 过期时间，时间戳 integer 10

2.发送手机验证码

接口说明：客户端提交手机号码到服务器, 服务器则向该手机号码发送一条带4位数字的手机验证码，有效期为10分钟。10分钟内不断请求接口，都只会返回一个相同的手机验证码。请限制1分钟内只允许发送一次手机验证码。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
mobile 手机号码 用户注册的可用手机号码 string(11) 是 无

请求实例：

  1. POST /v1/mobile_verification_code HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "mobile":"18615788190"
  7. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "verification_code":1245
  6. }
返回参数 含义 参数类型 长度
verification_code 验证码 integer 4

3.验证手机验证码

接口说明：客户端提交手机号码与短信验证码到服务器。验证手机号码是否有效。该接口主要是在用户未注册的情况下提交订单时使用。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
verification_code 验证码 手机短信验证码 integer(4) 是 无
mobile 手机号码 用户注册的可用手机号码 string(11) 是 无

请求实例：

  1. PUT /v1/verification HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "verification_code":"58971",
  7.     "mobile":"18615788190"
  8. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1
  5. }

4.手机号码注册

接口说明：手机号码注册接口，客户端填写手机号码、密码等基本信息，如果注册成功，则返回账号的基本信息。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
mobile 手机号码 用户注册的可用手机号码 integer(11) 是 无
password 密码 密码长度至少6位以上 string(6~12) 是 无
verification_code 验证码 手机短信验证码 integer(4) 是 无
realname 真实用户名 真实用户名 integer(4) 否 无
file_key:avatar 头像文件 头像文件文件名称是avatar string(-) 否 无

请求实例：

  1. POST /v1/account HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. Content-Disposition: form-data; name="mobile"
  7. 18615788190
  9. Content-Disposition: form-data; name="password"
  11. password
  13. Content-Disposition: form-data; name="verification_code"
  15. verification_code
  17. Content-Disposition: form-data; name="realname"
  19. realname
  21. Content-Disposition: form-data; name="avatar"; filename="IMG_1544.JPG"

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "username":"demo",
  6.     "mobile":"15898784512",
  7.     "realname":"demo@chehubao.com",
  8.     "avatar":"http://www.weipei.cc/avatar/demo.png",
  9.     "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e"
  10. }
返回参数 含义 参数类型 长度
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32

5.上传用户头像

接口说明：修改用户头像时，使用该接口

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
file_key:avatar 头像文件 头像文件文件名称是avatar string(200) 是 无

请求实例：

  1. POST /v1/avatar HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. Content-Disposition: form-data; name="access_token"
  7. 3e16cdaa0061ee89106b9112890a419397b46f32
  9. Content-Disposition: form-data; name="avatar"; filename="IMG_1544.JPG"

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "username":"demo",
  6.     "mobile":"15898784512",
  7.     "realname":"demo@chehubao.com",
  8.     "avatar":"http://www.weipei.cc/avatar/demo.png",
  9.     "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e"
  10. }
返回参数 含义 参数类型 长度
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32

6.检查更新

接口说明：APP升级检查接口，用户点击检查更新按钮，调用该接口检测该APP是否有升级信息。如果发现更新资源，系统会返回该APP的下载地址。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
client_version 版本号 客户端APP已有的版本号，默认版本号是1 integer(1) 是 1
model 手机类型 手机设备类型: 0-andriod 1-ios integer(1) 是 0

请求实例：

  1. POST /v1/upgrade HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "client_version":1,
  7.     "model":0
  8. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "latest":2,
  6.     "upgrade_log":"增加第三方登陆",
  7.     "download_url":"http://www.weipei.cc/statics/v2.0.apk",
  8.     "upgrade":1
  9. }
返回参数 含义 参数类型 长度
latest 最新版ID integer -
upgrade_log 升级日志 string -
download_url 下载地址 string -
upgrade 升级状态 1-升级 2 - 强制升级 1

7.找回密码

接口说明：用户在未登陆时，如果忘记密码，可以通过该接口进行密码找回。

处理流程：
1. APP调用24.检查用户是否存在
2. 调用2.发送手机验证码
2. 如果验证通过，调用7.找回密码
3. 完成密码重置

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
mobile 手机号码 手机号码 string(11) 是 无
verification_code 手机验证码 手机验证码 integer(4) 是 无
password 密码字符 重置的密码 string(6-30) 是 无

请求实例：

  1. PUT /v1/password HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "mobile":"18715789343",
  7.     "verification_code":1234,
  8.     "password":"password"
  9. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5. }

8.账户信息

接口说明：客户端提交手机号码/用户名到服务器。服务器返回该账号的基础信息。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 身份令牌 配件商/修理厂的身份信息 string(32) 是 无

请求实例：

  1. GET /v1/account_information?access_token=555b2fd1fd99a5fa70ff1c203c673d68e040894b HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "account_id": 5,
  6.   "username": "186****8190",
  7.   "mobile": "18615788190",
  8.   "realname": "程会勇，维修厂",
  9.   "avatar": "http://i.weipei.cc/Uploads/pictures/avatar/3f9a3755c8fb5.jpg",
  10.   "uuid": "0f8a3d218ac46a64641805fa8ea4d2eb",
  11.   "account_extra": {
  12.     "account_role": 2,
  13.     "name": "车护宝",
  14.     "contact": "程会勇",
  15.     "contact_number": "18615788190",
  16.     "contact_mobile": "18615788190",
  17.     "address": "成都市高新区环球中心",
  18.     "image": "http://i.weipei.cc//Uploads/avatar/20150602/556dd1764dd96.jpg",
  19.     "province": 23,
  20.     "city": 385,
  21.     "district": 0,
  22.     "district_name": "未知",
  23.     "province_name": "四川省",
  24.     "city_name": "成都市"
  25.   }
  26. }
返回参数 含义 参数类型 长度
account_id 用户编号 integer -
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32
account_extra 账号附加信息 - -
account_role 账号角色,1-配件商 2-修理厂 integer -
name 修理厂或者配件商名称 string -
contact 修理厂或者配件商联系人 string -
contact_number 修理厂或者配件商联系电话 string -
mobile 修理厂或者配件商手机号 string -
address 修理厂或者配件商详细地址 string -
image 修理厂或者配件商图片 string -
province 省份编号 integer -
city 城市编号 integer -
district 地区编号 integer -
district_name 地区名称 string -
province_name 省份编号 string -
city_name 城市编号 string -

9.修改密码

接口说明：用户修改密码的一种方式。用户在登陆状态下，调用该接口修改密码。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
origin_password 密码字符 原始的密码 string(6-30) 是 无
password 密码字符 新设置的密码 string(6-30) 是 无

请求实例：

  1. PUT /v1/account_password HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "access_token":"555b2fd1fd99a5fa70ff1c203c673d68e040894b",
  7.     "origin_password":"123456",
  8.     "password":"123456@a"
  9. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "username":"demo",
  6.     "mobile":"15898784512",
  7.     "realname":"demo@chehubao.com",
  8.     "avatar":"http://www.weipei.cc/avatar/demo.png",
  9.     "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e"
  10. }
返回参数 含义 参数类型 长度
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32

10.账号登陆

接口说明：用户需要修改现有的手机号码,需要提交新的手机号码到服务器

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
account 账号 可以是手机号码/用户名 string(-) 是 无
password 密码 登陆密码 string(6~12) 是 无

请求实例：

  1. POST /v1/login HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "account":"21",
  7.     "password":"123456@a"
  8. }

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "account_id": 5,
  6.   "username": "186****8190",
  7.   "mobile": "18615788190",
  8.   "realname": "程会勇，维修厂",
  9.   "avatar": "http://i.weipei.cc/Uploads/pictures/avatar/3f9a3755c8fb5.jpg",
  10.   "uuid": "0f8a3d218ac46a64641805fa8ea4d2eb",
  11.   "account_extra": {
  12.     "name": "车护宝",
  13.     "contact": "程会勇",
  14.     "contact_number": "18615788190",
  15.     "contact_mobile": "18615788190",
  16.     "address": "成都市高新区环球中心",
  17.     "image": "http://i.weipei.cc//Uploads/avatar/20150602/556dd1764dd96.jpg",
  18.     "province": 23,
  19.     "city": 385,
  20.     "district": 0,
  21.     "district_name": "未知",
  22.     "province_name": "四川省",
  23.     "city_name": "成都市"
  24.   },
  25.   "third_token": "GsouLBOxwQLYn6OgW+exnF2BLW7I5KqIxlUWqko/s8TuoS1CKeLd17w0bwWxaEZTMVyGVXwK5bU8hFfzxbl+IPmpaS0Xcjwxc7yMP+G2TpAVpU+EXYfltSDAhSfRyXx8",
  26.   "access_token": "YjJkNmUyY2VjYjQ1OTk0MjdkZDNmZWJiOTU3ZTQ4YWQ=",
  27.   "refresh_token": "MzUyMTc0OTcxZGE1NTIyOGI1NDkyNDA1ODk1Yzg4ZmI=",
  28.   "expiry_time": 1448437148
  29. }
返回参数 含义 参数类型 长度
username 用户名 string -
mobile 手机号码 string 11
realname 真实姓名 string -
access_token 身份授权Token string 32
refresh_token 身份刷新Token string 32
avatar 头像 string -
uuid 账号唯一编码 string 32
expiry_time 过期时间 integer 10
rongyuntong 荣运通账号身份信息 string -
account_role 账号角色,1-配件商 2-修理厂 integer -
name 修理厂或者配件商名称 string -
contact 修理厂或者配件商联系人 string -
contact_number 修理厂或者配件商联系电话 string -
mobile 修理厂或者配件商手机号 string -
address 修理厂或者配件商详细地址 string -
image 修理厂或者配件商图片 string -
province 省份编号 integer -
city 城市编号 integer -
district 地区编号 integer -
district_name 地区名称 string -
province_name 省份编号 string -
city_name 城市编号 string -

11.收藏配件商

接口说明：门店人员收藏某些配件商

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
accessory_shop_id 配件商编号 系统返回的配件商ID integer(11) 是 无

请求实例：

  1. POST /v1/favorites HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "access_token":"3e16cdaa0061ee89106b9112890a419397b46f32",
  7.     "accessory_shop_id":1
  8. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5. }

12.我的收藏

接口说明：门店人员收藏某些配件商

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
accessory_shop 配件商名称 配件商名称搜索关键词 string 否 无
limit 限制大小 指定返回记录的数量，系统会做验证 integer 否 100
offset 偏移量 指定返回记录的开始位置 integer 否 0

请求实例：

  1. GET /v1/favorites?access_token=3e16cdaa0061ee89106b9112890a419397b46f12&limit=100&offset=0 HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "total":100,
  6.     "returned": 10,
  7.     "accessory_shops":[
  8.         {
  9.             "accessory_shop_id":1,
  10.             "accessory_shop_name":"配件商名称",
  11.             "accessory_shop_image":"配件商LOGO",
  12.             "accessory_shop_address":"配件商详细地址",
  13.             "accessory_shop_brands":[
  14.                 {   
  15.                     "brand_name":"飞夺罗"
  16.                 }
  17.             ],
  18.             "realname_authentication":1,
  19.             "weipei_authentication":1,
  20.         }
  21.     ]
  22. }
返回参数 含义 参数类型 长度
total 总记录数量 integer -
returned 当前返回记录integer integer -
accessory_shops 配件商列表 string -
accessory_shop_idinteger商编号 integer -
accessory_shop_name 配件商名称 integer -
accessory_shop_address 配件商详细地址 string -
accessory_shop_brands 配件商主营品牌列表 - -
brand_name 配件商主营品牌名称 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1

13.筛选配件商

接口说明：通过省市区/车型品牌，车系等信息查询配件商信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
city_id 城市编号 系统返回的城市ID integer 否 无
automobile_brand 品牌 系统返回的车型品牌ID integer 否 无
title 配件商名称 配件商名称 string 否 无
limit 限制大小 指定返回记录的数量，系统会做验证 integer 否 100
offset 偏移量 指定返回记录的开始位置 integer 否 0

请求实例：

  1. http://api.weipei.cc/v1/accessory_shops?city_id=1&title=对方答复&automobile_brand=1&limit=100&offset=0

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "total":100,
  6.     "returned": 10,
  7.     "accessory_shops":[
  8.         {
  9.             "accessory_shop_id":1,
  10.             "accessory_shop_name":"配件商名称",
  11.             "accessory_shop_image":"配件商LOGO",
  12.             "accessory_shop_address":"配件商详细地址",
  13.             "accessory_shop_brands":[
  14.                 {   
  15.                     "brand_id":12,
  16.                     "brand_name":"飞夺罗"
  17.                 }
  18.             ],
  19.             "realname_authentication":1,
  20.             "weipei_authentication":1,
  21.         }
  22.     ]
  23. }
返回参数 含义 参数类型 长度
total 总记录数量 integer -
returned 当前返回记录数量 integer -
accessory_shops 配件商列表 string -
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 integer -
accessory_shop_address 配件商详细地址 string -
accessory_shop_brands 配件商主营品牌列表 - -
brand_id 品牌编号 integer -
brand_name 配件商主营品牌名称 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1

14.配件商信息

接口说明：获取配件商基本信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
accessory_shop_id 配件商编号 系统返回的配件商ID integer 是 无
access_token 服务商账户Token 服务商账户授权Token string 否 无

请求实例：

  1. GET /v1/accessory-shop/information?accessory_shop_id=1&access_token=YTA5NDg5ZjgxYWUxMmVmYzRjZTVjN2Y3Zjk1NDY3NmI= HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "accessory_shop_id":1,
  6.     "accessory_shop_name":"配件商名称",
  7.     "accessory_shop_image":"配件商LOGO",
  8.     "accessory_shop_original_image": null,
  9.     "accessory_shop_address":"配件商详细地址",
  10.     "accessory_shop_brands":[
  11.                 {   
  12.                     "brand_name":"飞夺罗"
  13.                 }
  14.             ],
  15.     "realname_authentication":1,
  16.     "weipei_authentication":1,
  17.     "contact":"联系人",
  18.     "contact_number":"联系电话",
  19.     "favorites_status": 1,
  20.     "total_quotation_sheets": 2,
  21.     "total_shipped_orders": 0,
  22.     "accounts":[
  23.         {
  24.             "account_id": 1,
  25.             "username":"demo",
  26.             "mobile":"15898784512",
  27.             "realname":"demo@chehubao.com",
  28.             "avatar":"http://www.weipei.cc/avatar/demo.png",
  29.             "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e",
  30.             "third_token":"hdkxudhh4j3bvtys7tkota7dj7f48os4k"
  31.         }
  32.     ]
  33. }
返回参数 含义 参数类型 长度
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 string -
accessory_shop_image 配件商缩略图 string -
accessory_shop_original_image 配件商原始图 string -
accessory_shop_address 配件商详细地址 string -
accessory_shop_brands 配件商主营品牌列表 - -
brand_name 配件商主营品牌名称 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1
contact 联系人 string -
contact_number 联系电话 string -
favorites_status 收藏状态 0-未收藏过 1-已收藏 integer -
total_quotation_sheets 配件商总共报价单 integer -
total_shipped_orders 配件商总共已发货采购单 integer -
accounts 账号信息 - -
account_id 账号ID integer -
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32
third_token 第三方通信token string -

15.修理厂创建询价单

接口说明：服务商发布一条询价信息，图片附件请使用27.上传图片接口上传之后，拿到图片地址，然后进行参数提交。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 服务商账户Token 服务商账户授权Token string 是 无
automobile_brand 品牌编号 系统返回的品牌ID integer 是 无
automobile_series 车系编号 系统返回的车系ID integer 是 无
automobile_model 车型编号 系统返回的车型ID integer 是 无
appearance_image_id 车型外观图片 车型外观图片系统编号 integer 否 无
year 年款 自定义车型年款 string 否 无
volume 排量 自定义车型排量 string 否 无
vin_image_id VIN图 VIN图系统编号 integer 否 无
notes 备注 备注信息 string 否 无
accessory_item 配件条目编号 正常情况是填写配件类目ID, 如果不是ID, 请传入配件名称 string 否 无
accessory_item_image 配件图片 配件附件ID,请先走上传图片接口 integer 否 无
accessory_shop_ids 配件商ID 修理厂指定哪些配件商,多个请用逗号分隔，例如：2,4,5 string 否 无

请求实例：

  1. POST /v1/motor-repair-shop/inquiry-sheet HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {
  6.     "access_token":"3e16cdaa0061ee89106b9112890a419397b46f21",
  7.     "automobile_brand":5,
  8.     "automobile_series":434,
  9.     "automobile_model":2456,
  10.     "year":2013,
  11.     "volume":"4.6",
  12.     "appearance_image_id":"",
  13.     "vin_image_id":"",
  14.     "notes":"备注",
  15.     "accessories":[
  16.         {
  17.             "accessory_item":"2",
  18.             "accessory_item_image":""
  19.         }
  20.     ]
  21. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "inquiry_sheet_id":1
  6. }
返回参数 含义 参数类型 长度
inquiry_sheet_id 询价单编号 integer -

16.配件类目

接口说明：配件商或者修理厂通过省市区/车型品牌，车系等信息查询配件商信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
title 配件类目名称 配件类目名称 string 否 无
parent 父类编号 0显示所有父类配件 integer 否 0
limit 限制大小 指定返回记录的数量，系统会做验证 integer 否 100
offset 偏移量 指定返回记录的开始位置 integer 否 0

请求实例：

  1. GET /v1/accessories-items?title="default"&parent=0&limit=100&offset=0 HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "total": 6,
  6.     "returned": 6,
  7.     "accessory_items": [
  8.         {
  9.             "accessory_item_id": 1,
  10.             "accessory_item_name": "车胎",
  11.             "accessory_sub_items": [
  12.                 {
  13.                     "accessory_item_id": 3,
  14.                     "accessory_item_name": "左轮胎"
  15.                 },
  16.                 {
  17.                     "accessory_item_id": 4,
  18.                     "accessory_item_name": "右轮胎"
  19.                 }
  20.             ]
  21.         },
  22.         {
  23.             "accessory_item_id": 2,
  24.             "accessory_item_name": "疝气灯",
  25.             "accessory_sub_items": [
  26.                 {
  27.                     "accessory_item_id": 5,
  28.                     "accessory_item_name": "前灯"
  29.                 },
  30.                 {
  31.                     "accessory_item_id": 6,
  32.                     "accessory_item_name": "后灯"
  33.                 }
  34.             ]
  35.         }
  36.     ]
  37. }
返回参数 含义 参数类型 长度
total 总记录数量 integer -
returned 当前返回记录数量 integer -
accessory_items 配件列表 - -
accessory_parent 配件父类名称 string -
accessory_item_id 配件编号 integer -
accessory_item_name 配件名称 string -

17.修理厂询价单详情

接口说明：修理厂获取询价单基础信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 服务商账户Token 服务商账户授权Token string 是 无
inquiry_sheet_id 询价单编号 系统返回的询价单ID integer 是 无

请求实例：

  1. http://api.weipei.cc/v1/motor-repair-shop/inquiry-sheet-detail?access_token=3e16cdaa0061ee89106b9112890a419397b46f31&inquiry_sheet_id=1

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "inquiry_sheet": {
  6.         "inquiry_sheet_id": 1,
  7.         "inquiry_sheet_no": "558103eae2e9e",
  8.         "automobile_brand_name": "宝马",
  9.         "automobile_series_name": "威赛帝(进口)",
  10.         "automobile_model_name": "2013款 2013款 2.0T 2.0T 手自一体 手自一体 GT 320i 风尚设计套装",
  11.         "automobile_brand_id": 5,
  12.         "automobile_series_id": 567,
  13.         "automobile_model_id": 2145,
  14.         "year": "2013款",
  15.         "volume": "13.0",
  16.         "notes": "notes",
  17.         "appearance": null,
  18.         "appearance_id": 0,
  19.         "vin_id": 0,
  20.         "vin": null,
  21.         "status": 2,
  22.         "status_string": "已报价",
  23.         "created_at": "2015-06-17 13:21:46",
  24.         "exipiry_time": 1434604906,
  25.         "server_time": 1434544578,
  26.         "updated_at": "2015-06-17 13:21:46",
  27.         "total_quoted": 1,
  28.         "inquiry_sheet_accessoires": [
  29.             {
  30.                 "inquiry_sheet_accessory_item_id": 1,
  31.                 "accessory_item_id": 2,
  32.                 "accessory_item_name": null,
  33.                 "accessory_item_original_name": null,
  34.                 "accessory_item_image_id": null,
  35.                 "min_price": 0,
  36.                 "max_price": 0
  37.             }
  38.         ],
  39.         "accessory_shops": [
  40.         {
  41.             "quotation_sheet_id": 1,
  42.             "accessory_shop_id": 1,
  43.             "accessory_shop_name": "成都伟望美国汽车配件",
  44.             "lowest_price": 1
  45.         }
  46.     ]，
  47.     "dist_count": 36,
  48.     "read_count": 0,
  49.     "read_list": []
  50. }
返回参数 含义 参数类型 长度
inquiry_sheet_id 询价单系统编号 integer -
inquiry_sheet_no 询价单编号 string -
automobile_brand_name 车型品牌 string -
automobile_series_name 车系名称 string -
automobile_model_name 车型名称 string -
automobile_brand_id 品牌编号 integer -
automobile_series_id 车系integer integer -
automobile_model_id 车型编号 integer -
year 自定义车型年款 string -
volume 自定义车型排量 string -
notes 配件名称 string -
appearance 车型外观图 string -
appearance_id 车型外观编号 integer -
vin_id vin图编号 integer -
vin vin图 string -
status 状态, 0待处理 2已报价 3未报价 4已结束 integer -
status_string 状态说明 string -
created_at 创建时间 string -
exipiry_time 过期时间 integer 10
server_time 服务器当前时间戳 integer 10
updated_at 更新时间 string -
total_quoted 总报价数 integer -
inquiry_sheet_accessoires 求购配件列表 Map -
inquiry_sheet_accessory_item_id 询价配件编号 integer -
accessory_item_id 配件编号 integer -
accessory_item_name 配件名称 string -
accessory_item_original_name 配件原始图 string -
accessory_item_image_id 配件图片编号 integer -
min_price 该车型配件最小报价 double -
max_price 该车型配件最大报价 double -
accessory_shops 配件商报价列表 Map -
quotation_sheet_id 报价单编号 integer -
accessory_shop_id 配件商系统编号 integer -
accessory_shop_name 配件商名称 string -
lowest_price 最低价格 float -
dist_count 询价消息分发总数 integer -
read_count 询价消息已读总数 integer -
read_list 询价消息已读的用户 Map -

18.配件商创建报价单

接口说明：配件商提交报价

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 配件商账户Token 配件商账户授权Token string 是 无
inquiry_sheet_id 询价单编号 系统返回询价ID integer 是 -
inquiry_sheet_accessory_item_id 询价配件编号 询价配件编号 integer 是 无
accessory_item_id 配件编号 系统返回的配件编号 integer 是 无
inquiry_sheet_accessory_items 配件条目 配件条目 - - -
price 价格 报价价格，支持两位小数 float 是 无
accessory_level 配件级别 配件级别 integer 是 无
accessory_quality_gurantee_period 质保期 配件质保期 integer 是 无
accessory_arrival 到达情况 到达情况 integer 是 无
accessory_brand 品牌描述 品牌描述 string 是 无
accessory_unit 单位 单位 string 是 无
notes 备注 备注 string 是 无

请求实例：

  1. POST /v1/accessory-shop/quotation-sheet HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  6. {
  7.     "access_token":"NTNjNTVhMmVjMTkwOTNiY2M1Zjk5MTcyZTdhYjVkNTg=",
  8.     "inquiry_sheet_id":1,
  9.     "quotation_sheet_items":[
  10.         {
  11.             "inquiry_sheet_accessory_item_id":2,
  12.             "inquiry_sheet_accessory_items": [
  13.                 {
  14.                     "price":1,
  15.                     "accessory_level":1,
  16.                     "accessory_quality_gurantee_period":1,
  17.                     "accessory_arrival":1,
  18.                     "accessory_brand":"描述",
  19.                     "accessory_unit":"件",
  20.                     "notes":"备注"
  21.                 },
  22.                 {
  23.                     "price":1,
  24.                     "accessory_level":2,
  25.                     "accessory_quality_gurantee_period":2,
  26.                     "accessory_arrival":2,
  27.                     "accessory_brand":"描述",
  28.                     "accessory_unit":"件",
  29.                     "notes":"备注"
  30.                 }
  31.             ]
  32.         }
  33.     ]
  34. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "quotation_sheet_id":1
  6. }
返回参数 含义 参数类型 长度
quotation_sheet_id 报价单 integer -

19.修理厂询价列表

接口说明：修理厂的所有询价列表信息汇总。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 维修厂账户Token 维修厂账户授权Token string 是 无
unexpired 未过期标识 1=>未过期 0=>全部 integer 否 0
limit 限制大小 指定返回记录的数量，系统会做验证 integer 否 50
offset 偏移量 指定返回记录的开始位置 integer 否 0

请求实例：

  1. http://api.weipei.cc/v1/motor-repair-shop/inquiry-sheet-lists?access_token=3e16cdaa0061ee89106b9112890a419397b4613s&limit=100&offset=0

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "total": 1,
  6.     "returned": 1,
  7.     "inquiry_sheet_lists": [
  8.         {
  9.             "inquiry_sheet_id": 1,
  10.             "inquiry_sheet_no": "558103eae2e9e",
  11.             "automobile_brand_name": "宝马",
  12.             "automobile_series_name": "威赛帝(进口)",
  13.             "automobile_model_name": "2013款 2013款 2.0T 2.0T 手自一体 手自一体 GT 320i 风尚设计套装",
  14.             "automobile_brand_id": 5,
  15.             "notes": "notes",
  16.             "appearance": null,
  17.             "appearance_id": 0,
  18.             "vin_id": 0,
  19.             "vin": null,
  20.             "status": 2,
  21.             "status_string": "已报价",
  22.             "created_at": "2015-06-17 13:21:46",
  23.             "exipiry_time": 1434604906,
  24.             "server_time": 1434544928,
  25.             "updated_at": "2015-06-17 13:21:46",
  26.             "total_quoted": 1,
  27.             "inquiry_sheet_accessoires": [
  28.                 {
  29.                     "inquiry_sheet_accessory_item_id": 1,
  30.                     "accessory_item_id": 2,
  31.                     "accessory_item_name": null,
  32.                     "accessory_item_original_name": null,
  33.                     "accessory_item_image_id": null
  34.                 }
  35.             ],
  36.             "motor_repair_shop": {
  37.                 "motor_repair_shop_id": 3,
  38.                 "motor_repair_shop_address": "成都市天府新区1187",
  39.                 "motor_repair_shop_name": "成都四核保养修理厂",
  40.                 "motor_repair_shop_contact": "程先生",
  41.                 "realname_authentication": 0,
  42.                 "weipei_authentication": 0,
  43.                 "motor_repair_shop_thumbnail_image": false,
  44.                 "motor_repair_shop_original_image": false,
  45.                 "total_inquiry_sheets": 6,
  46.                 "total_shipped_orders": 0,
  47.                 "accounts": {
  48.                     "account_id": 1,
  49.                     "username": "186****8190",
  50.                     "mobile": "18615788190",
  51.                     "realname": "realname",
  52.                     "avatar": "http://img.dev.weipei.cc/Uploads/pictures/avatar/avatar.jpg",
  53.                     "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e"
  54.                 }
  55.             }
  56.         }
  57.     ]
  58. }
返回参数 含义 参数类型 长度
total 总记录数量 integer -
returned 当前返回记录数量 integer -
inquiry_sheet_id 询价单系统编号 integer -
inquiry_sheet_no 询价单编号 string -
automobile_brand_name 车型品牌 string -
automobile_series_name 车系名称 string -
automobile_model_name 车型名称 string -
notes 配件名称 string -
appearance 车型外观图 string -
vin vin图 integer -
status 状态, 0待处理 2已报价 3未报价 4已结束 integer -
status_string 状态说明 string -
created_at 创建时间 string -
total_quoted 总报价数 integer -
motor_repair_shop_id 维修厂编号 integer -
motor_repair_shop_address 维修厂详细地址 string -
motor_repair_shop_name 维修厂名称 string -
motor_repair_shop_contact 维修厂联系人 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1
motor_repair_shop_thumbnail_image 维修厂缩略图 string -
motor_repair_shop_original_image 维修厂原始图 string -
total_inquiry_sheets 维修厂总共询价单 integer -
total_shipped_orders 维修厂已发货的采购单 integer -
accounts 账号信息 - -
account_id 账号ID integer -
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32
exipiry_time 过期时间 integer 10
inquiry_sheet_accessoires 询价单条目信息 - -
inquiry_sheet_accessory_item_id 询价单配件条目ID integer -
accessory_item_id 配件编号 integer -
accessory_item_name 配件名称 string -
accessory_item_image 配件图片 string -

20.配件商询价报价列表

接口说明：配件商查看自己的报价情况。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 配件商账户Token 配件商账户授权Token string 是 无
unexpired 过期标示 1=>未过期 0=>全部 integer 否 0
quoted 报价状态 1=>已报价 2=>未报价 0=>全部 integer 否 0
limit 限制大小 指定返回记录的数量，系统会做验证 integer 否 50
offset 偏移量 指定返回记录的开始位置 integer 否 0

请求实例：

  1. http://api.weipei.cc/v1/accessory-shop/quotation-sheet-lists?access_token=3e16cdaa0061ee89106b9112890a419397b4622s&limit=100&offset=0&refresh_token=3e16cdaa0061ee89106b9112890a419397b46f32

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "quotation_sheet_lists": [
  6.         {
  7.             "quotation_sheet_id": 1,
  8.             "quotation_sheet_no": "558104bbe8a9c",
  9.             "inquiry_sheet_id": 1,
  10.             "automobile_brand_name": "宝马",
  11.             "automobile_series_name": "威赛帝(进口)",
  12.             "automobile_model_name": "2013款 2013款 2.0T 2.0T 手自一体 手自一体 GT 320i 风尚设计套装",
  13.             "notes": "notes",
  14.             "appearance": null,
  15.             "vin": null,
  16.             "status": 2,
  17.             "status_string": "已报价",
  18.             "created_at": "2015-06-17 13:21:46",
  19.             "exipiry_time": 1434604906,
  20.             "total_quoted": 1,
  21.             "server_time": 1434545475,
  22.             "lowest_price": 1,
  23.             "current_accessory_shop_is_quoted": true,
  24.             "inquiry_sheet_accessoires": [
  25.                 {
  26.                     "quotation_sheet_id": 1,
  27.                     "inquiry_sheet_accessory_item_id": 1,
  28.                     "quotation_sheet_accessory_item_id": 1,
  29.                     "accessory_item_name": "前保险杠电眼",
  30.                     "accessory_item_image": null,
  31.                     "accessory_item_original_image": null,
  32.                     "accessory_level": 1,
  33.                     "accessory_quality_gurantee_period": 1,
  34.                     "accessory_arrival": 1,
  35.                     "price": 1,
  36.                     "accessory_brand": "",
  37.                     "accessory_unit": "",
  38.                     "notes": "备注"
  39.                 }
  40.             ],
  41.             "motor_repair_shop": {
  42.                 "motor_repair_shop_id": 3,
  43.                 "motor_repair_shop_address": "成都市天府新区1187",
  44.                 "motor_repair_shop_name": "成都四核保养修理厂",
  45.                 "motor_repair_shop_contact": "程先生",
  46.                 "realname_authentication": 0,
  47.                 "weipei_authentication": 0,
  48.                 "motor_repair_shop_thumbnail_image": false,
  49.                 "motor_repair_shop_original_image": false,
  50.                 "total_inquiry_sheets": 6,
  51.                 "total_shipped_orders": 0,
  52.                 "accounts": {
  53.                     "account_id": 1,
  54.                     "username": "186****8190",
  55.                     "mobile": "18615788190",
  56.                     "realname": "realname",
  57.                     "avatar": "http://img.dev.weipei.cc/Uploads/pictures/avatar/avatar.jpg",
  58.                     "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e"
  59.                 }
  60.             }
  61.         }
  62.     ],
  63.     "total": 1,
  64.     "returned": 1
  65. }
返回参数 含义 参数类型 长度
total 总记录数量 integer -
returned 当前返回记录数量 integer -
inquiry_sheets 我的询价列表 - -
quotation_sheet_id 报价单编号 integer -
inquiry_sheet_id 询价单编号 integer -
automobile_brand_name 车型品牌 string -
automobile_series_name 车系名称 string -
automobile_model_name 车型名称 string -
notes 配件名称 string -
appearance 车型外观图 string -
vin vin图 integer -
status 状态, 0待处理 2已报价 3未报价 4已结束 integer -
status_string 状态说明 string -
created_at 创建时间 string -
total_quoted 总报价数 integer -
exipiry_time 过期时间 integer 10
server_time 服务器时间 integer 10
lowest_price 最低价总和 float -
curent_accessory_shop_is_quoted 当前登录配件商是否已经报过价，true是 false否 boolean -
quotation_sheet_items 报价单配件条目 - -
quotation_sheet_accessory_item_id 报价配件编号 integer -
price 配件价格 float -
accessory_level 配件等级 string -
accessory_quality_gurantee_period 质保期 string -
accessory_arrival 配件到达情况 string -
accessory_brand 品牌描述 string -
accessory_unit 单位 string -
notes 备注 string -
motor_repair_shop_id 维修厂编号 integer -
motor_repair_shop_address 维修厂详细地址 string -
motor_repair_shop_name 维修厂名称 string -
motor_repair_shop_contact 维修厂联系人 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1
motor_repair_shop_thumbnail_image 维修厂缩略图 string -
motor_repair_shop_original_image 维修厂原始图 string -
total_inquiry_sheets 维修厂总共询价单 integer -
total_shipped_orders 维修厂已发货的采购单 integer -
accounts 账号信息 - -
account_id 账号ID integer -
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32

21.下采购单

接口说明：修理厂创建采购单

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 修理厂账户Token 修理厂账户授权Token string 是 无
quotation_sheet_id 报价单编号 系统返回的报价单ID integer 是 -
consignee 收货人 收货人姓名 string 是 -
mobile 联系电话 收货人联系电话 string 是 -
address 收货地址 收货人收货地址 string 是 -
pirce 价格 报价价格，支持两位小数 float 是 无
way 货运方式 货运方式 string 是 无
order_accessory_items 采购单配件 采购单配件 - - -
quotation_sheet_accessory_item_id 报价配件编号 系统返回的报价配件ID integer 是 -
number 数量 采购配件数量 integer 是 -
shipping_method 发货方式 1微配直送 2其他物流 integer 是 2

请求实例：

  1. POST /v1/purchase-order HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {
  6.     "access_token":"YzM1ZmMyM2QxOGQ2NmE3ZDEyMWY5MTE0Njk2ZGQ5MDU=",
  7.     "quotation_sheet_id":1,
  8.     "consignee":"描述",
  9.     "mobile":"件",
  10.     "address":"备注",
  11.     "pirce":"90.2",
  12.     "way":1,
  13.     "shipping_method":1,
  14.     "order_accessory_items":[
  15.         {
  16.             "quotation_sheet_accessory_item_id":1,
  17.             "number":12
  18.         }
  19.     ]
  20. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "order_id":1,
  6.     "order_no":"20160304152534532696"
  7. }
返回参数 含义 参数类型 长度
order_id 采购单系统编号 integer -
order_no 采购单号 string 20

22.维修厂采购单详情

接口说明： 获取采购单单基础信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 维修厂账户Token 维修厂账户授权Token string 是 无
order_id 采购单编号 采购单系统编号 integer 是 无

请求实例：

  1. http://api.weipei.cc/v1/motor-repair-shop/purchase-order-detail?access_token=3e16cdaa0061ee89106b9112890a419397b46f1s&order_id=68

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "purchase_order": {
  6.         "order_id": 68,
  7.         "order_no": "20160308125000581156",
  8.         "type":0,
  9.         "order_status_string": "待发货",
  10.         "order_status": 1,
  11.         "order_price": 0.01,
  12.         "order_invoice": false,
  13.         "order_original_invoice": false,
  14.         "created_at": "2015-10-14 10:22:36",
  15.         "shippment_time": "2015-10-14 10:22:36",
  16.         "inquiry_sheet_id": 148,
  17.         "automobile_brand_name": "昌河",
  18.         "automobile_series_name": "福瑞达",
  19.         "automobile_model_name": "2014 1.8",
  20.         "trading_way":"online",
  21.         "trading_no":"2015101410144165472534",
  22.         "refund_no":"2015101317450260179422",
  23.         "is_suspended":false,
  24.     },
  25.     "order_receipt": {
  26.         "consignee": "车护宝维修厂",
  27.         "mobile": "18615788190",
  28.         "address": "成都市高新区环球中心",
  29.         "way": "任意"
  30.     },
  31.     "accessory_shop": {
  32.         "accessory_shop_id": 476,
  33.         "accessory_shop_name": "金顺达汽车电器有限公司",
  34.         "accessory_shop_image": null,
  35.         "accessory_shop_original_image": null,
  36.         "accessory_shop_address": "双流县金恒德汽配城1期20栋373号",
  37.         "accessory_shop_brands": [
  38.             {
  39.                 "brand_id": 75,
  40.                 "brand_name": "奇瑞"
  41.             }
  42.         ],
  43.         "realname_authentication": 0,
  44.         "weipei_authentication": 0,
  45.         "contact": "齐鹏飞",
  46.         "contact_number": "13340967117",
  47.         "province": 23,
  48.         "city": 385,
  49.         "favorites_status": 0,
  50.         "total_quotation_sheets": 4,
  51.         "total_shipped_orders": 2,
  52.         "accounts": {
  53.             "account_id": 8563,
  54.             "username": "159****9864",
  55.             "mobile": "15928039864",
  56.             "realname": "会勇配件商",
  57.             "avatar": "http://img.dev.weipei.cc/Uploads/pictures/avatar/7a6d987ef6dbb.jpg",
  58.             "uuid": "66ee21098d854d6acbb6fce447ed28bf"
  59.         }
  60.     },
  61.     "purchase_order_accessories": [
  62.         {
  63.             "accessory_item_id": 80,
  64.             "accessory_item_name": "前大灯喷水嘴",
  65.             "accessory_items": [
  66.                 {
  67.                     "accessory_item_name": "前大灯喷水嘴",
  68.                     "number": 1,
  69.                     "accessory_item_image": null,
  70.                     "accessory_item_original_image": null,
  71.                     "accessory_level": 6,
  72.                     "accessory_quality_gurantee_period": 9,
  73.                     "accessory_arrival": 11,
  74.                     "price": 0.01,
  75.                     "accessory_brand": "",
  76.                     "accessory_unit": "",
  77.                     "notes": "",
  78.                     "accessory_total_price": 0.01
  79.                 }
  80.             ]
  81.         }
  82.     ],
  83.     "timeline": [
  84.     {
  85.       "order_status": 0,
  86.       "order_status_string": "待支付",
  87.       "trading_way": "",
  88.       "created_at": "2015-10-15 15:32:41"
  89.     }
  90.   ]
  91. }
返回参数 含义 参数类型 长度
purchase_order 采购单基本信息 - -
order_id 采购单id integer -
order_no 采购单编号 string -
type 采购单采购方式 0-系统流程 1-雪种活动 integer 1
order_status_string 采购单状态 string -
order_status 采购单状态编码 integer -
order_price 采购单总价 duobule -
order_invoice 发货单照片 string -
order_original_invoice 发货单原始照片 string -
created_at 采购时间 string -
shippment_time 发货时间 string -
inquiry_sheet_id 询价单编号 integer -
automobile_brand_name 品牌 string -
automobile_series_name 车系 string -
automobile_model_name 车型 string -
trading_way 支付方式 online线上支付 offline线下支付 7
trading_no 交易单号 支付成功后的交易号 32
refund_no 退款单号 退款成功后的单号 32
is_suspended 交易是否暂停 true交易暂停 false交易正常 5
order_receipt 收货人基本信息 - -
consignee 收货人 string -
mobile 联系电话 integer -
address 地址 string -
way 送货方式 string -
accessory_shop 配件商基本信息 - -
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 string -
accessory_shop_image 配件商缩略图 string -
accessory_shop_original_image 配件商原始图 string -
accessory_shop_address 配件商详细地址 string -
accessory_shop_brands 配件商主营品牌列表 - -
brand_name 配件商主营品牌名称 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1
contact 联系人 string -
contact_number 联系电话 string -
favorites_status 收藏状态 0-未收藏过 1-已收藏 integer -
total_quotation_sheets 配件商总共报价单 integer -
total_shipped_orders 配件商总共已发货采购单 integer -
accounts 账号信息 - -
account_id 账号ID integer -
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32
third_token 第三方通信token string -
purchase_order_accessories 采购配件条目 - -
accessory_item_name 配件名称 string -
accessory_item_id 配件编号 integer -
accessory_items 采购配件列表 - -
accessory_item_name 配件名称 string -
number 配件数量 integer -
accessory_item_image 配件缩略图 string -
accessory_item_original_image 配件原始图 string -
accessory_level 配件等级 string -
accessory_quality_gurantee_period 质保期 string -
accessory_arrival 配件到达情况 string -
price 配件价格 float -
accessory_brand 品牌描述 string -
accessory_unit 单位 string -
notes 备注 string -
accessory_total_price 配件总价 dobule -
order_status 采购单状态 integer 1
order_status_string 采购单状态值 string -
trading_way 支付方式 string -
created_at 时间 string -

24.用户是否存在

接口说明 ：输入用户名/手机号码

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
account 账号信息 用户名/手机号码 string 是 -

请求实例：

  1. PUT /v1/user HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {
  6.     "account":"1861467783"
  7. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5. }

25.TOKEN免密码登陆

接口说明：根据系统返回的refresh_token进行免密码登陆。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
refresh_token 刷新Token 系统返回的refresh_token string(32) 是 无

请求实例：

  1. POST /v1/token_login HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {
  6.     "refresh_token":"8216cdaa0061ee89106b9112890a419397b46f36"
  7. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "username":"demo",
  6.     "mobile":"15898784512",
  7.     "email":"demo@chehubao.com",
  8.     "avatar":"http://www.weipei.cc/avatar/demo.png",
  9.     "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e"
  10.     "access_token":"8116cdaa0061ee89106b9112890a419397b46f36",
  11.     "refresh_token":"8e16cdaa0061ee89106b9112890a419397b46f23",
  12.     "expiry_time":1423798678,
  13.     "rongyuntong":"8e16cdaa0061ee89106b9112890a419397b46f36"
  14. }
返回参数 含义 参数类型 长度
username 用户名 string -
mobile 手机号码 string 11
email 邮箱 string -
access_token 身份授权Token string 32
refresh_token 身份刷新Token string 32
avatar 头像 string -
uuid 账号唯一编码 string 32
expiry_time 过期时间 integer 10
rongyuntong 荣运通账号身份信息 string -

26.取消收藏配件商

接口说明：门店人员取消收藏某些配件商

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
accessory_shop_id 配件商编号 系统返回的配件商ID integer(11) 是 无

请求实例：

  1. POST /v1/unfavorite HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {
  6.     "access_token":"3e16cdaa0061ee89106b9112890a419397b46f32",
  7.     "accessory_shop_id":1
  8. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5. }

27.上传图片

接口说明：图片上传接口

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 服务商账户Token 服务商账户授权Token string 是 无
filename key:image 图片名称 图片文件路径 string 是 无

请求实例：

  1. POST /v1/upload-request HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {
  6.     "access_token":"3e16cdaa0061ee89106b9112890a419397b46f21,          
  7.     "image":"file"
  8. }

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "image_id": 5,
  6.     "thumbnail_image": "http://img.dev.weipei.cc/Uploads/pictures/assets/e4e0efb241e87.jpg",
  7.     "original_image": "http://img.dev.weipei.cc/Uploads/pictures/assets/2f3675aa23917e12df07099363861cad.jpg"
  8. }
返回参数 含义 参数类型 长度
image_id 图片编号 integer -
thumbnail_image 缩略图 string -
original_image 原始图 string -

30.修理厂询价报价详情

接口说明：修理厂查询已经报价的询价单详细信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 服务商账户Token 服务商账户授权Token string 是 无
quotation_sheet_id 报价单编号 系统返回的报价单编号 integer 是 无

请求实例：

  1. http://api.weipei.cc/v1/motor-repair-shop/quotation-sheet-detail?access_token=3e16cdaa0061ee89106b9112890a419397b46f31&quotation_sheet_id=1

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "inquiry_sheet": {
  6.         "inquiry_sheet_id": 1,
  7.         "inquiry_sheet_no": "558103eae2e9e",
  8.         "automobile_brand_name": "宝马",
  9.         "automobile_series_name": "威赛帝(进口)",
  10.         "automobile_model_name": "2013款 2013款 2.0T 2.0T 手自一体 手自一体 GT 320i 风尚设计套装",
  11.         "automobile_brand_id": 5,
  12.         "notes": "notes",
  13.         "appearance": null,
  14.         "appearance_id": 0,
  15.         "vin_id": 0,
  16.         "vin": null,
  17.         "status": 2,
  18.         "status_string": "已报价",
  19.         "created_at": "2015-06-17 13:21:46",
  20.         "exipiry_time": 1434604906,
  21.         "server_time": 1434546320,
  22.         "updated_at": "2015-06-17 13:21:46",
  23.         "total_quoted": 1
  24.     },
  25.     "accessory_shop": {
  26.         "accessory_shop_id": 1,
  27.         "accessory_shop_name": "成都伟望美国汽车配件",
  28.         "accessory_shop_image": null,
  29.         "accessory_shop_address": "红牌楼三九汽配城B-203号",
  30.         "accessory_shop_brands": [
  31.             {
  32.                 "brand_id": 5,
  33.                 "brand_name": "宝马"
  34.             },
  35.             {
  36.                 "brand_id": 5,
  37.                 "brand_name": "宝马"
  38.             }
  39.         ],
  40.         "realname_authentication": 1,
  41.         "weipei_authentication": 0,
  42.         "contact": "莫伟",
  43.         "contact_number": "18328388566",
  44.         "favorites_status": 1,
  45.         "total_quotation_sheets": 2,
  46.         "total_shipped_orders": 0,
  47.         "accounts": {
  48.             "account_id": 2,
  49.             "username": "159****9864",
  50.             "mobile": "15928039864",
  51.             "realname": "维修厂",
  52.             "avatar": "http://img.dev.weipei.cc/Uploads/pictures/avatar/avatar.jpg",
  53.             "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e"
  54.         }
  55.     },
  56.     "inquiry_sheet_accessoires": [
  57.         {
  58.             "inquiry_sheet_accessory_item_id": 1,
  59.             "accessory_item_id": 2,
  60.             "accessory_item_name": null,
  61.             "accessory_item_original_name": null,
  62.             "accessory_item_image_id": null,
  63.             "quotation_sheet_items": [
  64.                 {
  65.                     "quotation_sheet_id": 1,
  66.                     "inquiry_sheet_accessory_item_id": 1,
  67.                     "quotation_sheet_accessory_item_id": 1,
  68.                     "accessory_item_name": "前保险杠电眼",
  69.                     "accessory_item_image": null,
  70.                     "accessory_item_original_image": null,
  71.                     "accessory_level": 1,
  72.                     "accessory_quality_gurantee_period": 1,
  73.                     "accessory_arrival": 1,
  74.                     "price": 1,
  75.                     "accessory_brand": "",
  76.                     "accessory_unit": "",
  77.                     "notes": "备注"
  78.                 }
  79.             ]
  80.         }
  81.     ]
  82. }
返回参数 含义 参数类型 长度
inquiry_sheet 询价单 - -
inquiry_sheet_id 询价单系统编号 integer -
inquiry_sheet_no 询价单编号 string -
automobile_brand_name 车型品牌 string -
automobile_series_name 车系名称 string -
automobile_model_name 车型名称 string -
notes 配件名称 string -
appearance 车型外观图 string -
vin vin图 integer -
status 状态, 0待处理 2已报价 3未报价 4已结束 integer -
status_string 状态说明 string -
created_at 创建时间 string -
exipiry_time 过期时间 integer 10
server_time 服务器当前时间戳 integer 10
updated_at 更新时间 string -
accessory_shop 配件商 - -
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 integer -
accessory_shop_address 配件商详细地址 string -
accessory_shop_brands 配件商主营品牌列表 - -
brand_name 配件商主营品牌名称 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1
motor_repair_shop_thumbnail_image 维修厂缩略图 string -
motor_repair_shop_original_image 维修厂原始图 string -
total_inquiry_sheets 维修厂总共询价单 integer -
total_shipped_orders 维修厂已发货的采购单 integer -
contact 联系人 string -
contact_number 联系电话 string -
favorites_status 收藏状态 0-未收藏过 1-已收藏 integer -
total_quotation_sheets 配件商总共报价单 integer -
total_shipped_orders 配件商总共已发货采购单 integer -
accounts 账号信息 - -
account_id 账号ID integer -
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32
third_token 第三方通信token string -
inquiry_sheet_accessoires 询价单条目信息 - -
inquiry_sheet_accessory_item_id 询价单配件条目ID integer -
accessory_item_id 配件编号 integer -
accessory_item_name 配件名称 string -
accessory_item_image 配件图片 string -
quotation_sheet_items 报价单配件条目 - -
quotation_sheet_accessory_item_id 报价配件编号 integer -
price 配件价格 float -
accessory_level 配件等级 string -
accessory_quality_gurantee_period 质保期 string -
accessory_arrival 配件到达情况 string -
brand_description 品牌描述 string -
unit 单位 string -
notes 备注 string -

31.配件商报价详情

接口说明：修理厂查询已经报价的询价单信息。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 配件商账户Token 配件商账户授权Token string 是 无
inquiry_sheet_id 询价单编号 系统返回的询价单编号 integer 是 无

请求实例：

  1. http://api.weipei.cc/v1/accessory-shop/quotation-sheet-detail?access_token=8e16cdaa0061ee89106b9112890a419397b46f1d&inquiry_sheet_id=1

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "inquiry_sheet": {
  6.         "inquiry_sheet_id": 1,
  7.         "inquiry_sheet_no": "5571657446a4c",
  8.         "automobile_brand_name": "宝马",
  9.         "automobile_series_name": "菱麒",
  10.         "automobile_model_name": "丰田 2008款 2013款 2007款 2012款 2011款 2009款 1.6 1.8 2.0 手动 自动 无级 卡罗拉",
  11.         "automobile_brand_id": 5,
  12.         "notes": "",
  13.         "appearance": null,
  14.         "vin": null,
  15.         "status": 2,
  16.         "status_string": "已报价",
  17.         "created_at": "2015-06-05 17:01:40",
  18.         "exipiry_time": 1433581300,
  19.         "server_time": 1433673952,
  20.         "updated_at": "2015-06-05 17:01:40",
  21.         "total_quoted": 7,
  22.     },
  23.     "motor_repair_shop": {
  24.         "motor_repair_shop_id":12,
  25.         "motor_repair_shop_address":"修理厂详细地址",
  26.         "motor_repair_shop_name":"修理厂名称",
  27.         "motor_repair_shop_contact":"联系电话",
  28.         "realname_authentication":"实名认证， 1=已通过认证 0-未通过认证",
  29.         "weipei_authentication":"微配认证 1=已通过认证 0-未通过认证",
  30.         "motor_repair_shop_thumbnail_image": false,
  31.         "motor_repair_shop_original_image": false,
  32.         "total_inquiry_sheets": 6,
  33.         "total_shipped_orders": 0,
  34.         "accounts":[
  35.             {
  36.                 "account_id": 1,
  37.                 "username":"demo",
  38.                 "mobile":"15898784512",
  39.                 "realname":"demo@chehubao.com",
  40.                 "avatar":"http://www.weipei.cc/avatar/demo.png",
  41.                 "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e",
  42.                 "third_token":"hdkxudhh4j3bvtys7tkota7dj7f48os4k"
  43.             }
  44.         ]
  45.     },
  46.     "inquiry_sheet_accessoires": [
  47.         {
  48.             "inquiry_sheet_accessory_item_id": 1,
  49.             "accessory_item_id": 2,
  50.             "accessory_item_name": "前刹车片",
  51.             "accessory_item_image": null,
  52.             "quotation_sheet_items": [
  53.                 {
  54.                     "inquiry_sheet_accessory_item_id": 2,
  55.                     "quotation_sheet_accessory_item_id": 1,
  56.                     "accessories_item_name": "前刹车片",
  57.                     "accessories_item_image": null,
  58.                     "accessory_level": 1,
  59.                     "accessory_quality_gurantee_period": 1,
  60.                     "accessory_arrival": 1,
  61.                     "price": 1,
  62.                     "accessory_brand": "描2述",
  63.                     "accessory_unit": "2件",
  64.                     "notes": "备2注"
  65.                 }
  66.             ]
  67.         }
  68.     ],
  69.     "quotation_sheet_id": 1,
  70.     "is_quoted":false,
  71.     "curent_accessory_shop_is_quoted":1
  72. }
返回参数 含义 参数类型 长度
inquiry_sheet 询价单 - -
inquiry_sheet_id 询价单系统编号 integer -
inquiry_sheet_no 询价单编号 string -
automobile_brand_name 车型品牌 string -
automobile_series_name 车系名称 string -
automobile_model_name 车型名称 string -
automobile_brand_id 品牌编号 integer -
notes 配件名称 string -
appearance 车型外观图 string -
vin vin图 integer -
status 状态, 0待处理 2已报价 4已结束 integer -
status_string 状态说明 string -
created_at 创建时间 string -
exipiry_time 过期时间 integer 10
server_time 服务器当前时间戳 integer 10
updated_at 更新时间 string -
total_quoted 总共报价 integer -
motor_repair_shop_id 维修厂编号 integer -
motor_repair_shop_address 维修厂详细地址 string -
motor_repair_shop_name 维修厂名称 string -
motor_repair_shop_contact 维修厂联系人 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1
motor_repair_shop_thumbnail_image 维修厂缩略图 string -
motor_repair_shop_original_image 维修厂原始图 string -
total_inquiry_sheets 维修厂总共询价单 integer -
total_shipped_orders 维修厂已发货的采购单 integer -
accounts 账号信息 - -
account_id 账号ID integer -
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32
third_token 第三方通信token string -
inquiry_sheet_accessoires 询价单条目信息 - -
inquiry_sheet_accessory_item_id 询价单配件条目ID integer -
accessory_item_id 配件编号 integer -
accessory_item_name 配件名称 string -
accessory_item_image 配件图片 string -
quotation_sheet_items 报价单配件条目 - -
quotation_sheet_accessory_item_id 报价配件编号 integer -
price 配件价格 float -
accessory_level 配件等级 string -
accessory_quality_gurantee_period 质保期 string -
accessory_arrival 配件到达情况 string -
accessory_brand 品牌描述 string -
accessory_unit 单位 string -
notes 备注 string -
quotation_sheet_id 报价单编号 integer -
is_quoted 询价单是否已经报过价格，true是 false否 boolean -
curent_accessory_shop_is_quoted 当前登录配件商是否已经报过价，true是 false否 boolean -

32.配件商修改报价单

接口说明：配件商修改自己的报价单

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
quotation_sheet_id 报价单系统编号 报价单系统编号 integer 是 无
access_token 配件商账户Token 配件商账户授权Token string 是 无
inquiry_sheet_id 询价单编号 系统返回询价ID integer 是 -
quotation_sheet_items 报价条目 报价条目 - - -
quotation_sheet_accessory_item_id 已报价配件编号 已报价配件编号 integer 是 无
inquiry_sheet_accessory_item_id 询价配件编号 询价配件编号 integer 是 无
accessory_item_id 配件编号 系统返回的配件编号 integer 是 无
inquiry_sheet_accessory_items 配件条目 配件条目 - - -
price 价格 报价价格，支持两位小数 float 是 无
accessory_level 配件级别 配件级别 integer 是 无
accessory_quality_gurantee_period 质保期 配件质保期 integer 是 无
accessory_arrival 到达情况 到达情况 integer 是 无
accessory_brand 品牌描述 品牌描述 string 是 无
accessory_unit 单位 单位 string 是 无
notes 备注 备注 string 是 无

请求实例：

  2. PUT /v1/accessory-shop/quotation-sheet HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  6. {
  7.     "quotation_sheet_id":1, 
  8.     "access_token":"NTNjNTVhMmVjMTkwOTNiY2M1Zjk5MTcyZTdhYjVkNTg=",
  9.     "inquiry_sheet_id":1,
  10.     "quotation_sheet_items":[
  11.         {
  12.             "inquiry_sheet_accessory_item_id":1,
  13.             "inquiry_sheet_accessory_items": [
  14.                 {
  15.                     "quotation_sheet_accessory_item_id":1,
  16.                     "price":1,
  17.                     "accessory_level":1,
  18.                     "accessory_quality_gurantee_period":1,
  19.                     "accessory_arrival":1,
  20.                     "accessory_brand":"描述",
  21.                     "accessory_unit":"件",
  22.                     "notes":"备注"
  23.                 },
  24.                 {
  25.                     "quotation_sheet_accessory_item_id":2,
  26.                     "price":1,
  27.                     "accessory_level":2,
  28.                     "accessory_quality_gurantee_period":2,
  29.                     "accessory_arrival":2,
  30.                     "accessory_brand":"描述",
  31.                     "accessory_unit":"件",
  32.                     "notes":"备注"
  33.                 }
  34.             ]
  35.         }
  36.     ]
  37. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "quotation_sheet_id":1
  6. }
返回参数 含义 参数类型 长度
quotation_sheet_id 报价单 integer -

34.修理厂修改询价单

接口说明：服务商发布一条询价信息，图片附件请使用27.上传图片接口上传之后，拿到图片地址，然后进行参数提交。_如果需要删除已询的配件，请将参数inquiry_sheet_accessory_item_id直接删除则可_

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
inquiry_sheet_id 询价单系统编号 询价单系统编号 integer 是 无
access_token 服务商账户Token 服务商账户授权Token string 是 无
automobile_brand 品牌编号 系统返回的品牌ID integer 是 无
automobile_series 车系编号 系统返回的车系ID integer 是 无
automobile_model 车型编号 系统返回的车型ID integer 是 无
appearance_image_id 车型外观图片 车型外观图片系统编号 integer 否 无
vin_image_id VIN图 VIN图系统编号 integer 否 无
notes 备注 备注信息 string 否 无
accessory_item 配件条目编号 正常情况是填写配件类目ID, 如果不是ID, 请传入配件名称 string 否 无
inquiry_sheet_accessory_item_id 已询价的配件系统编号 已询价的配件系统编号 integer 否 无
accessory_item_image 配件图片 配件附件ID,请先走上传图片接口 integer 否 无
accessory_shop_ids 配件商ID 修理厂指定哪些配件商,多个请用逗号分隔，例如：2,4,5 string 否 无

请求实例：

  2. PUT /v1/motor-repair-shop/inquiry-sheet HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  6. {
  7.     "inquiry_sheet_id":1,
  8.     "access_token":"YzM1ZmMyM2QxOGQ2NmE3ZDEyMWY5MTE0Njk2ZGQ5MDU=",
  9.     "automobile_brand":5,
  10.     "automobile_series":35,
  11.     "automobile_model":345,
  12.     "appearance_image_id":"",
  13.     "vin_image_id":"",
  14.     "notes":"notes",
  15.     "accessories":[
  16.         {
  17.             "inquiry_sheet_accessory_item_id":1,
  18.             "accessory_item":"1",
  19.             "accessory_item_image":""
  20.         }
  21.     ],
  22.     "accessory_shop_ids":"2"
  23. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "inquiry_sheet_id":1
  6. }
返回参数 含义 参数类型 长度
inquiry_sheet_id 询价单编号 integer -

35.修理厂结束询价

接口说明：修理厂取消询价信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 修理厂授权token 修理厂授权token sring 是 无
inquiry_sheet 询价单编号 系统返回的询价单编号 integer 是 无

请求实例：

  2. PUT /v1/motor-repair-shop/inquiry-sheet-end HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  6. {
  7.     "access_token":"YjBmNjk1MzJhNzQ2YTU3ZmViODVhMzc5OTdhMWQwM2E=",
  8.     "inquiry_sheet_id":1
  9. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5. }

36.修理厂采购单列表

接口说明： 修理厂查询采购单

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 服务商账户Token 服务商账户授权Token string 是 无
status 采购单状态 0-待支付 1-待发货 2-已发货 3-已关闭 4交易完毕 5全部 6-退款中 integer 否 5
limit 限制大小 指定返回记录的数量，系统会做验证 integer 否 100
offset 偏移量 指定返回记录的开始位置 integer 否 0

请求实例：

  1. http://api.weipei.cc/v1/motor-repair-shop/purchase-order-lists?access_token=ZTA1MDQwYmQyNWYwY2ViNzBjMjEyMGJkZTBhNWQ5NTQ=&limit=100&offset=0&status=3

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "total_pay":1,
  6.     "total_paid":1,
  7.     "total_delivered":1,
  8.     "total": 9,
  9.     "returned": 9,
  10.     "purchase_order_list": [
  11.         {
  12.             "purchase_order": {
  13.                 "order_id": 21,
  14.                 "order_no": "55fce95f3e167",
  15.                 "order_status_string": "待支付",
  16.                 "order_status": 0,
  17.                 "order_price": 0.01,
  18.                 "order_invoice": false,
  19.                 "order_original_invoice": false,
  20.                 "created_at": "2015-09-19 12:49:35",
  21.                 "shippment_time": "2015-09-19 12:49:35",
  22.                 "inquiry_sheet_id": 110,
  23.                 "automobile_brand_name": "奥迪",
  24.                 "automobile_series_name": "A3",
  25.                 "automobile_model_name": "2014款 1.4 TFSI 双离合 35TFSI 豪华型",
  26.                 "trading_way":"online",
  27.                 "trading_no":"2015101410144165472534",
  28.                 "refund_no":"2015101317450260179422",
  29.                 "is_suspended":false,
  31.             },
  32.             "order_receipt": {
  33.                 "consignee": "车护宝维修厂",
  34.                 "mobile": "18615788190",
  35.                 "address": "成都市高新区环球中心",
  36.                 "way": "任意"
  37.             },
  38.             "accessory_shop": {
  39.                 "accessory_shop_id": 1361,
  40.                 "accessory_shop_name": "金佰利汽配",
  41.                 "accessory_shop_image": "http://img.dev.weipei.cc//Uploads/avatar/20150720/55acd9ce64d35.jpg",
  42.                 "accessory_shop_original_image": "http://img.dev.weipei.cc//Uploads/avatar/20150720/55acd9ce64d35.jpg",
  43.                 "accessory_shop_address": "九峰汽配",
  44.                 "accessory_shop_brands": [
  45.                     {
  46.                         "brand_id": 104,
  47.                         "brand_name": "云雀"
  48.                     }
  49.                 ],
  50.                 "realname_authentication": 0,
  51.                 "weipei_authentication": 0,
  52.                 "contact": "张杰",
  53.                 "contact_number": "15881103770",
  54.                 "province": 23,
  55.                 "city": 385,
  56.                 "favorites_status": 1,
  57.                 "total_quotation_sheets": 8,
  58.                 "total_shipped_orders": 0,
  59.                 "accounts": {
  60.                     "account_id": 8563,
  61.                     "username": "159****9864",
  62.                     "mobile": "15928039864",
  63.                     "realname": "会勇配件商",
  64.                     "avatar": "http://img.dev.weipei.cc/Uploads/pictures/avatar/7a6d987ef6dbb.jpg",
  65.                     "uuid": "66ee21098d854d6acbb6fce447ed28bf"
  66.                 }
  67.             },
  68.             "purchase_order_accessories": [
  69.                 {
  70.                     "accessory_item_id": 6,
  71.                     "accessory_item_name": "前保险杠骨架",
  72.                     "accessory_items": [
  73.                         {
  74.                             "accessory_item_name": "前保险杠骨架",
  75.                             "number": 5,
  76.                             "accessory_item_image": null,
  77.                             "accessory_item_original_image": null,
  78.                             "accessory_level": 4,
  79.                             "accessory_quality_gurantee_period": 7,
  80.                             "accessory_arrival": 10,
  81.                             "price": 3269,
  82.                             "accessory_brand": "",
  83.                             "accessory_unit": "",
  84.                             "notes": "你们还在继续增加……在线指导书、一个人是从什么时候可以捏捏我想起来不及吃惊吃惊不要把门给面子，",
  85.                             "accessory_total_price": 16345
  86.                         }
  87.                     ]
  88.                 }
  89.             ]
  90.         }
  91.     ]
  92. }
返回参数 含义 参数类型 长度
total_pay 待支付总数 integer -
total_paid 待发货总数 integer -
total_delivered 已发货总数 integer -
total 总记录 integer -
returned 当前返回记录 integer -
purchase_order_list 采购单列表 - -
purchase_order 采购单基本信息 - -
order_id 采购单id integer -
order_no 采购单编号 string -
order_status_string 采购单状态 string -
order_status 采购单状态编码 integer -
order_price 采购单总价 duobule -
order_invoice 发货单照片 string -
created_at 采购时间 string -
shippment_time 发货时间 string -
inquiry_sheet_id 询价单编号 integer -
automobile_brand_name 品牌 string -
automobile_series_name 车系 string -
automobile_model_name 车型 string -
trading_way 支付方式 online线上支付 offline线下支付 7
trading_no 交易单号 支付成功后的交易号 32
refund_no 退款单号 退款成功后的单号 32
is_suspended 交易是否暂停 true交易暂停 false交易正常 5
order_receipt 收货人基本信息 - -
consignee 收货人 string -
mobile 联系电话 integer -
address 地址 string -
way 送货方式 string -
purchase_order_accessories 采购配件条目 - -
accessory_item_id 配件编号 integer -
accessory_items 采购配件列表 - -
accessory_item_name 配件名称 string -
number 配件数量 integer -
price 配件价格 float -
accessory_level 配件等级 string -
accessory_quality_gurantee_period 质保期 string -
accessory_arrival 配件到达情况 string -
brand_description 品牌描述 string -
unit 单位 string -
notes 备注 string -
accessory_total_price 配件总价 dobule -

37.配件商采购单列表

接口说明： 配件商查询采购单

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 配件商账户Token 配件商账户授权Token string 是 无
status 采购单状态 0-待支付 1-待发货 2-已发货 3-已关闭 4交易完毕 5全部 6-退款中 integer 否 5
limit 限制大小 指定返回记录的数量，系统会做验证 integer 否 100
offset 偏移量 指定返回记录的开始位置 integer 否 0

请求实例：

  1. GET http://api.weipei.cc/v1/accessory-shop/purchase-order-lists?access_token=ZDZjYzMyYTBlZTc4MzRiNTE5NzNiOGNlMzIxMzRlMDk=&limit=100&offset=0&status=5

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "total_pay":1,
  6.   "total_paid":1,
  7.   "total_delivered":1,
  8.   "total": 8,
  9.   "returned": 8,
  10.   "purchase_order_list": [
  11.     {
  12.       "purchase_order": {
  13.         "order_id": 61,
  14.         "order_no": "561cbde189f4d",
  15.         "order_status_string": "已关闭",
  16.         "order_status": 3,
  17.         "order_price": 0.01,
  18.         "order_invoice": false,
  19.         "order_original_invoice": false,
  20.         "created_at": "2015-10-13 16:16:33",
  21.         "shippment_time": "2015-10-13 16:16:33",
  22.         "inquiry_sheet_id": 145,
  23.         "automobile_brand_name": "大众",
  24.         "automobile_series_name": "Tiguan(进口)",
  25.         "automobile_model_name": "2015 1.3",
  26.         "trading_way":"online",
  27.         "trading_no":"2015101410144165472534",
  28.         "refund_no":"2015101317450260179422",
  29.         "is_suspended":false,
  30.       },
  31.       "order_receipt": {
  32.         "consignee": "车护宝维修厂",
  33.         "mobile": "18615788190",
  34.         "address": "成都市高新区环球中心",
  35.         "way": "任意"
  36.       },
  37.       "motor_repair_shop": {
  38.         "motor_repair_shop_id": 5,
  39.         "motor_repair_shop_address": "成都市高新区环球中心",
  40.         "motor_repair_shop_name": "车护宝维修厂",
  41.         "motor_repair_shop_contact": "程会勇",
  42.         "province": 23,
  43.         "city": 385,
  44.         "realname_authentication": 0,
  45.         "weipei_authentication": 0,
  46.         "motor_repair_shop_thumbnail_image": "http://img.dev.weipei.cc/Uploads/avatar/20150919/as1442645909.JPG",
  47.         "motor_repair_shop_original_image": "http://img.dev.weipei.cc/Uploads/avatar/20150919/1442645909.JPG",
  48.         "total_inquiry_sheets": 54,
  49.         "total_shipped_orders": 6,
  50.         "bd_users": "brave",
  51.         "accounts": {
  52.           "account_id": 8589,
  53.           "username": "186****8190",
  54.           "mobile": "18615788190",
  55.           "realname": "程会勇",
  56.           "avatar": "http://img.dev.weipei.cc/Uploads/pictures/avatar/6c244a2dd89bb.jpg",
  57.           "uuid": "d4c4a248f0fe36fbe43811bd5179f5d2"
  58.         }
  59.       },
  60.       "purchase_order_accessories": [
  61.         {
  62.           "accessory_item_id": 65,
  63.           "accessory_item_name": "中网亮条",
  64.           "accessory_items": [
  65.             {
  66.               "accessory_item_name": "中网亮条",
  67.               "number": 1,
  68.               "accessory_item_image": null,
  69.               "accessory_item_original_image": null,
  70.               "accessory_level": 4,
  71.               "accessory_quality_gurantee_period": 7,
  72.               "accessory_arrival": 10,
  73.               "price": 0.01,
  74.               "accessory_brand": "",
  75.               "accessory_unit": "",
  76.               "notes": "",
  77.               "accessory_total_price": 0.01
  78.             }
  79.           ]
  80.         }
  81.       ]
  82.     }
  83.   ]
  84. }
返回参数 含义 参数类型 长度
total_pay 待支付总数 integer -
total_paid 待发货总数 integer -
total_delivered 已发货总数 integer -
total 总记录 integer -
returned 当前返回记录 integer -
purchase_order_list 采购单列表 - -
purchase_order 采购单基本信息 - -
order_id 采购单id integer -
order_no 采购单编号 string -
order_status_string 采购单状态 string -
order_status 采购单状态编码 integer -
order_price 采购单总价 duobule -
order_invoice 发货单照片 string -
created_at 采购时间 string -
shippment_time 发货时间 string -
inquiry_sheet_id 询价单编号 integer -
automobile_brand_name 品牌 string -
automobile_series_name 车系 string -
automobile_model_name 车型 string -
trading_way 支付方式 online线上支付 offline线下支付 7
trading_no 交易单号 支付成功后的交易号 32
refund_no 退款单号 退款成功后的单号 32
is_suspended 交易是否暂停 true交易暂停 false交易正常 5
order_receipt 收货人基本信息 - -
consignee 收货人 string -
mobile 联系电话 integer -
address 地址 string -
way 送货方式 string -
purchase_order_accessories 采购配件条目 - -
accessory_item_id 配件编号 integer -
accessory_items 采购配件列表 - -
accessory_item_name 配件名称 string -
number 配件数量 integer -
price 配件价格 float -
accessory_level 配件等级 string -
accessory_quality_gurantee_period 质保期 string -
accessory_arrival 配件到达情况 string -
brand_description 品牌描述 string -
unit 单位 string -
notes 备注 string -
accessory_total_price 配件总价 dobule -

38.关闭采购单

接口说明：维修厂或者配件商关闭采购单，微配2.1版本增加管理员可以通过管理后台进行关闭采购单。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
order_id 采购单编号 系统返回的采购单ID integereger 是 无
administrator BD管理员 仅适用后台操作 integer 是 无

请求实例：

  1. PUT /v1/purchase-order-end HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {
  6.     "access_token":"ZGNmNDIyNTMyYjk5OGFjMzMwY2JkZGU2YzcwOTcwODE=",
  7.     "order_id":"520323",
  8.     "administrator":19,
  9. }

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "purchase_order": {
  6.         "order_id": 520323,
  7.         "order_no": "55816e7c2bc96",
  8.         "order_status_string": "待发货",
  9.         "order_status": 0,
  10.         "order_price": 12,
  11.         "order_invoice": "http://img.dev.weipei.cc/Uploads/pictures/assets/226bdccde7e8e.jpg",
  12.         "order_original_invoice": "http://img.dev.weipei.cc/Uploads/pictures/assets/d8374b826684470aba9486e9bdd159ed.jpg",
  13.         "created_at": "2015-06-17 20:56:28",
  14.         "shippment_time": "2015-06-17 20:56:28",
  15.         "inquiry_sheet_id": 1,
  16.         "automobile_brand_name": "宝马",
  17.         "automobile_series_name": "威赛帝(进口)",
  18.         "automobile_model_name": "2013款 2013款 2.0T 2.0T 手自一体 手自一体 GT 320i 风尚设计套装"
  19.     }
  20. }
返回参数 含义 参数类型 长度
purchase_order 采购单基本信息 - -
order_id 采购单id integereger -
order_no 采购单编号 string -
order_status_string 采购单状态 string -
order_status 采购单状态编码 integereger -
order_price 采购单总价 duobule -
order_invoice 发货单照片 string -
order_original_invoice 发货单原始照片 string -
created_at 采购时间 string -
shippment_time 发货时间 string -
inquiry_sheet_id 询价单编号 integereger -
automobile_brand_name 品牌 string -
automobile_series_name 车系 string -
automobile_model_name 车型 string -

39.使用邀请码

接口说明：用户注册成功后，使用邀请码功能添加身份角色（配件商或者修理厂）

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
invite_code 邀请码 系统生成的邀请码 integer 是 无

请求实例：

  1. PUT /v1/invitation/code HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {
  6.     "access_token":"3e16cdaa0061ee89106b9112890a419397b46f32",
  7.     "invite_code":1345
  8. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "username":"demo",
  6.     "mobile":"15898784512",
  7.     "realname":"demo@chehubao.com",
  8.     "avatar":"http://www.weipei.cc/avatar/demo.png",
  9.     "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e",
  10.     "access_token":"8116cdaa0061ee89106b9112890a419397b46f36",
  11.     "refresh_token":"8e16cdaa0061ee89106b9112890a419397b46f23",
  12.     "expiry_time":1423798678,
  13.     "rongyuntong":"8e16cdaa0061ee89106b9112890a419397b46f36",
  14.     "account_extra":[
  15.         {
  16.             "account_role":1,
  17.             "id":13,
  18.             "name":"龙泉驿汽配城",
  19.             "contact":"联系人",
  20.             "contact_number":"联系电话",
  21.             "mobile":"18765346793",
  22.             "address":"龙泉驿花都区1号",
  23.             "image":"img.weipei.cc/Uploads/images/image.png"            
  24.         }
  25.     ]
  26. }
返回参数 含义 参数类型 长度
username 用户名 string -
mobile 手机号码 string 11
realname 真实姓名 string -
access_token 身份授权Token string 32
refresh_token 身份刷新Token string 32
avatar 头像 string -
uuid 账号唯一编码 string 32
expiry_time 过期时间 integer 10
rongyuntong 荣运通账号身份信息 string -
account_extra 账号附加信息 - -
account_role 账号角色,1-配件商 2-修理厂 integer -
id 修理厂或者配件商编号 integer -
name 修理厂或者配件商名称 string -
contact 修理厂或者配件商联系人 string -
contact_number 修理厂或者配件商联系电话 string -
mobile 修理厂或者配件商手机号 string -
address 修理厂或者配件商详细地址 string -
image 修理厂或者配件商图片 string -

40.修改用户姓名

接口说明：通过该接口可以修改用户的姓名

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
realname 用户姓名 用户姓名 string 是 无

请求实例：

  2. PUT /v1/realname HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  6. {
  7.     "access_token":"3e16cdaa0061ee89106b9112890a419397b46f32",
  8.     "realname":13456
  9. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "username":"demo",
  6.     "mobile":"15898784512",
  7.     "realname":"demo@chehubao.com",
  8.     "avatar":"http://www.weipei.cc/avatar/demo.png",
  9.     "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e",
  10.     "access_token":"8116cdaa0061ee89106b9112890a419397b46f36",
  11.     "refresh_token":"8e16cdaa0061ee89106b9112890a419397b46f23",
  12.     "expiry_time":1423798678,
  13.     "rongyuntong":"8e16cdaa0061ee89106b9112890a419397b46f36"
  14. }
返回参数 含义 参数类型 长度
username 用户名 string -
mobile 手机号码 string 11
realname 真实姓名 string -
access_token 身份授权Token string 32
refresh_token 身份刷新Token string 32
avatar 头像 string -
uuid 账号唯一编码 string 32
expiry_time 过期时间 integer 10
rongyuntong 荣运通账号身份信息 string -

41.汽车品牌列表

接口说明：获取汽车所有品牌名称接口。

请求实例：

  1. GET /v1/auto-brands HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9

返回结果：

  1. { 
  2.     "error_msg":"",
  3.     "error_code":0, 
  4.     "status":1,
  5.     "brands":[
  6.         {
  7.             "brand_id":1,
  8.             "brand_name":"奥迪",    
  9.             "brand_first_letter":"A"
  10.         }
  11.     ]
  12. }
返回参数 含义 参数类型 长度
brand_id 品牌ID integer -
brand_name 汽车品牌名称 String 20
brand_first_letter 汽车品牌名称首字母 String 2

42.汽车品牌车系

接口说明：根据品牌ID获取品牌的所有车系。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
brand_id 品牌ID 接口返回的品牌ID integer(-) 是 无

请求实例：

  2. GET /v1/auto-series?brand_id=1 HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9

返回结果：

  1. { 
  2.     "error_msg":"",
  3.     "error_code":0, 
  4.     "status":1,
  5.     "automakers":[
  6.         {
  7.             "automaker":"东风本田",
  8.             "autoseries":[
  9.                 {
  10.                     "auto_series_id":1,
  11.                     "auto_series_name":"奥迪A3"
  12.                 }
  13.             ]
  14.         }
  15.     ]
  16. }
返回参数 含义 参数类型 长度
automakers 所有的品牌厂商列表 - -
automaker 品牌厂商名称 string 50
autoseries 品牌厂商车系列表 - -
auto_series_id 车系ID integer -
auto_series_name 车系名称 String 100

43.指定汽车车型

接口说明：根据车系ID获取车型。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
auto_series_id 车系ID 接口返回的车系ID String(integer) 是 无

请求实例：

  2. GET /v1/auto-models?auto_series_id=1 HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9

返回结果：

  1. { 
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "car_models":[
  6.         {
  7.             "auto_model_id": 21863,
  8.             "auto_model_name": "2.2 手动 ",
  9.             "auto_model_year": "2009款 "
  10.         }
  11.     ]
  12. }
返回参数 含义 参数类型 长度
motorcycle_types 所有车型列表 - -
auto_model_id 车型ID integer -
auto_model_name 车型名称 String 100
auto_model_year 车型年款 String 6

44.省份筛选

接口说明：获取所有的省份信息

请求实例：

  2. GET /v1/provinces HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9

返回结果：

  1. { 
  2.     "error_msg":"",
  3.     "error_code":0, 
  4.     "status":1,
  5.     "provinces":[
  6.         {
  7.             "province_id":1,
  8.             "province_name":"四川省"
  9.         }
  10.     ]
  11. }
返回参数 含义 参数类型 长度
provinces 省份信息列表 - -
province_id 省份ID integer -
province_name 省份名称 String -

45.城市筛选

接口说明：通过省份ID获取所有的城市信息

请求参数:

参数名 含义 规则说明 参数类型 是否必须 缺省值
province_id 省份ID 省份ID integer(11) 是 无

请求实例：

  1. GET /v1/cities HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. { 
  2.     "error_msg":"",
  3.     "error_code":0, 
  4.     "status":1,
  5.     "cities":[
  6.         {
  7.             "city_id":1,
  8.             "city_name":"成都市"
  9.         }
  10.     ]
  11. }
返回参数 含义 参数类型 长度
cities 城市列表 - -
city_id 城市ID integer -
city_name 城市名称 String -

46.配件属性

接口说明：创建报价单时选择的配件基础属性值

请求实例：

  1. GET /v1/accessories/attributes HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. { 
  2.     "error_msg":"",
  3.     "error_code":0, 
  4.     "status":1,
  5.     "attributes":[
  6.         {
  7.             "attribute_name":"级别",
  8.             "attribute_id":1,
  9.             "attribute_sub":[
  10.                 {
  11.                     "attribute_id":4,
  12.                     "attribute_name":"原厂件"
  13.                 }
  14.             ]
  15.         }
  16.     ]
  17. }
返回参数 含义 参数类型 长度
attributes 属性列表 - -
attribute_name 属性名称 string -
attribute_id 属性编号 integer -
attribute_sub 属性子分类 - -

47.发货

接口说明：配件商进行采购单发货，调用接口27.上传图片接口，上传发货单照片，进行发货操作。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 配件商账户Token 配件商账户授权Token string 是 无
order_id 采购单编号 系统返回的采购单编号 integereger 是 无
invoince 发货单照片编号 系统返回的发货单照片编号 integereger 是 无

请求实例：

  2. POST /v1/accessory-shop/shipments HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  6. {
  7.     "access_token":"MmI3MTBhNGEyZTM0YjVmOTY5MjFmYzljNzI4NDI5MTA=",
  8.     "order_id":1,
  9.     "invoince":13,
  10. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "order_id":1
  6. }
返回参数 含义 参数类型 长度
order_id 采购单id integer -

48.生成配件商邀请码

接口说明：在测试环境使用该接口生成一个配件商的邀请码，可以添加多个

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
accessory_shop_id 配件商系统编号 配件商系统编号 integer 是 无
bd BD人员系统编号 BD人员系统编号 integer 是 无

请求实例：

  2. POST /v1/accessory-shop/invitation HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  6. {
  7.     "accessory_shop_id":"1",
  8.     "bd":15
  9. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1
  5. }

49.生成修理厂邀请码

接口说明：在测试环境使用该接口生成一个修理厂的邀请码，可以添加多个

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
motor_repair_shop_id 修理厂系统编号 修理厂系统编号 integer 是 无
bd BD人员系统编号 BD人员系统编号 integer 是 无

请求实例：

  2. POST /v1/motor-repair-shop/invitation HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  6. {
  7.     "motor_repair_shop_id":"1",
  8.     "bd":10
  9. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1
  5. }

50.配件商采购单详情

接口说明： 配件商看到自己的采购单详情页面

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 配件商账户Token 配件商账户授权Token string 是 无
order_id 采购单编号 系统返回的采购单ID integer 是 -

请求实例：

  2. GET /v1/accessory-shop/purchase-order-detail?access_token=3e16cdaa0061ee89106b9112890a419397b46f1s&order_id=1 HTTP/1.1
  3. Host: api.weipei.com
  4. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "purchase_order": {
  6.         "order_id": 1,
  7.         "order_no": "55816e7c2bc96",
  8.         "order_status_string": "待发货",
  9.         "order_status": 0,
  10.         "order_price": 12,
  11.         "order_invoice": "http://img.dev.weipei.cc/Uploads/pictures/assets/226bdccde7e8e.jpg",
  12.         "order_original_invoice": "http://img.dev.weipei.cc/Uploads/pictures/assets/d8374b826684470aba9486e9bdd159ed.jpg",
  13.         "created_at": "2015-06-17 20:56:28",
  14.         "shippment_time": "2015-06-17 20:56:28",
  15.         "inquiry_sheet_id": 1,
  16.         "automobile_brand_name": "宝马",
  17.         "automobile_series_name": "威赛帝(进口)",
  18.         "automobile_model_name": "2013款 2013款 2.0T 2.0T 手自一体 手自一体 GT 320i 风尚设计套装"
  19.     },
  20.     "order_receipt": {
  21.         "consignee": "收货人",
  22.         "mobile": "18615788190",
  23.         "address": "阶段",
  24.         "way": "1"
  25.     },
  26.     "motor_repair_shop": {
  27.         "motor_repair_shop_id": 3,
  28.         "motor_repair_shop_address": "成都市天府新区1187",
  29.         "motor_repair_shop_name": "成都四核保养修理厂",
  30.         "motor_repair_shop_contact": "程先生",
  31.         "realname_authentication": 0,
  32.         "weipei_authentication": 0,
  33.         "motor_repair_shop_thumbnail_image": false,
  34.         "motor_repair_shop_original_image": false,
  35.         "total_inquiry_sheets": 6,
  36.         "total_shipped_orders": 0,
  37.         "accounts": {
  38.             "account_id": 1,
  39.             "username": "186****8190",
  40.             "mobile": "18615788190",
  41.             "realname": "realname",
  42.             "avatar": "http://img.dev.weipei.cc/Uploads/pictures/avatar/avatar.jpg",
  43.             "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e"
  44.         }
  45.     },
  46.     "purchase_order_accessories": [
  47.         {
  48.             "accessory_item_name": "前保险杠电眼",
  49.             "accessory_item_id": 2,
  50.             "accessory_items": [
  51.                 {
  52.                     "accessory_item_name": "前保险杠电眼",
  53.                     "number": 12,
  54.                     "accessory_item_image": null,
  55.                     "accessory_item_original_image": null,
  56.                     "accessory_level": 1,
  57.                     "accessory_quality_gurantee_period": 1,
  58.                     "accessory_arrival": 1,
  59.                     "price": 1,
  60.                     "accessory_brand": "",
  61.                     "accessory_unit": "",
  62.                     "notes": "备注",
  63.                     "accessory_total_price": 12
  64.                 }
  65.             ]
  66.         }
  67.     ],
  68.     "timeline": [
  69.     {
  70.       "order_status": 0,
  71.       "order_status_string": "待支付",
  72.       "trading_way": "",
  73.       "created_at": "2015-10-15 15:32:41"
  74.     }
  75. }
返回参数 含义 参数类型 长度
purchase_order 采购单基本信息 - -
order_id 采购单id integer -
order_no 采购单编号 string -
order_status_string 采购单状态 string -
order_status 采购单状态编码 integer -
order_price 采购单总价 duobule -
order_invoice 发货单照片 string -
order_original_invoice 发货单原始照片 string -
created_at 采购时间 string -
shippment_time 发货时间 string -
inquiry_sheet_id 询价单编号 integer -
automobile_brand_name 品牌 string -
automobile_series_name 车系 string -
automobile_model_name 车型 string -
order_receipt 收货人基本信息 - -
consignee 收货人 string -
mobile 联系电话 integer -
address 地址 string -
way 送货方式 string -
motor_repair_shop_id 维修厂编号 integer -
motor_repair_shop_address 维修厂详细地址 string -
motor_repair_shop_name 维修厂名称 string -
motor_repair_shop_contact 维修厂联系人 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1
motor_repair_shop_thumbnail_image 维修厂缩略图 string -
motor_repair_shop_original_image 维修厂原始图 string -
total_inquiry_sheets 维修厂总共询价单 integer -
total_shipped_orders 维修厂已发货的采购单 integer -
accounts 账号信息 - -
account_id 账号ID integer -
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32
purchase_order_accessories 采购配件条目 - -
accessory_item_id 配件编号 integer -
accessory_items 采购配件列表 - -
accessory_item_name 配件名称 string -
number 配件数量 integer -
price 配件价格 float -
accessory_level 配件等级 string -
accessory_quality_gurantee_period 质保期 string -
accessory_arrival 配件到达情况 string -
brand_description 品牌描述 string -
unit 单位 string -
notes 备注 string -
accessory_total_price 配件总价 dobule -
order_status 采购单状态 integer 1
order_status_string 采购单状态值 string -
trading_way 支付方式 string -
created_at 时间 string -

51.获取维修厂信息

接口说明：获取维修厂基本信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
motor_repair_shop_id 维修厂编号 系统返回的维修厂ID integer 是 无

请求实例：

  1. GET /v1/motor-repair-shop/information?motor_repair_shop_id=3 HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: e40e175c83b0af7e2ba3a1a4df08c0fdbddecf47

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "motor_repair_shop_id": 3,
  6.     "motor_repair_shop_address": "成都市天府新区1187",
  7.     "motor_repair_shop_name": "成都四核保养修理厂",
  8.     "motor_repair_shop_contact": "程先生",
  9.     "realname_authentication": 0,
  10.     "weipei_authentication": 0,
  11.     "motor_repair_shop_thumbnail_image": false,
  12.     "motor_repair_shop_original_image": false,
  13.     "total_inquiry_sheets": 6,
  14.     "total_shipped_orders": 0,
  15.     "accounts": [
  16.         {
  17.             "account_id": 1,
  18.             "username": "186****8190",
  19.             "mobile": "18615788190",
  20.             "realname": "realname",
  21.             "avatar": "http://img.dev.weipei.cc/Uploads/pictures/avatar/3d470f82bbe9e.jpg",
  22.             "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e"
  23.         }
  24.     ]
  25. }
返回参数 含义 参数类型 长度
motor_repair_shop_id 维修厂编号 integer -
motor_repair_shop_address 维修厂详细地址 string -
motor_repair_shop_name 维修厂名称 string -
motor_repair_shop_contact 维修厂联系人 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1
motor_repair_shop_thumbnail_image 维修厂缩略图 string -
motor_repair_shop_original_image 维修厂原始图 string -
total_inquiry_sheets 维修厂总共询价单 integer -
total_shipped_orders 维修厂已发货的采购单 integer -
accounts 账号信息 - -
account_id 账号ID integer -
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32

52.账户信息

接口说明：根据账户编号获取基本信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
account_id 账号编号 账号编号 integer 是 无

请求实例：

  1. GET /v1/account/assets?account_id=2 HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: e40e175c83b0af7e2ba3a1a4df08c0fdbddecf47

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "account_id": 2,
  6.     "username": "159****9864",
  7.     "mobile": "15928039864",
  8.     "realname": "维修厂",
  9.     "avatar": "http://img.dev.weipei.cc/Uploads/pictures/avatar/avatar.jpg",
  10.     "uuid": "93fa0c295fa84983fe5f2c8ed1d5b51e"
  11. }
返回参数 含义 参数类型 长度
account_id 账户编号 integer -
username 用户名 string -
mobile 手机号码 integer -
realname 真实姓名 string -
avatar 头像 string -

53.取消绑定邀请码

接口说明：用户取消绑定自己的邀请码

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无

请求实例：

  1. PUT /v1/invitation-code-cancellation HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {
  6.     "access_token":"MmVhNDBlNDFhMzA0NjExYjFjNDc5NzBjODZjNzY0NDM="
  7. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1
  5. }

54.筛选服务商

接口说明：通过该接口可以筛选所有的配件商、维修厂基本信息。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
servicer 服务商类型 1=>配件商 2=>维修厂 integer 是 1
province 省份 省份编号 integer 否 无
city 城市 城市编号 integer 否 无
district 区县 区县编号 integer 否 无
keyword 关键词 可以搜索名称、联系人、联系电话、联系电话 string 否 无
limit 限制数量 默认10条 integer 否 10
offset 偏移量 默认0 integer 否 0

请求实例：

  1. GET /v1/servicers?servicer=1 HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "total": 7,
  6.     "returned": 7,
  7.     "accessory_shops": [
  8.         {
  9.             "accessory_shop_id": 1,
  10.             "accessory_shop_address": "红牌楼三九汽配城B-203号",
  11.             "accessory_shop_name": "成都伟望美国汽车配件",
  12.             "contact": "莫伟",
  13.             "province": 23,
  14.             "city": 385,
  15.             "contact_number": "18328388566",
  16.             "realname_authentication": 1,
  17.             "weipei_authentication": 0
  18.         }
  19.     ]
  20. }
返回参数 含义 参数类型 长度
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 string -
accessory_shop_address 配件商详细地址 string -
contact 联系人 string -
province 省份编号 integer -
city 城市编号 integer -
province_name 省份名称 string -
city_name 城市名称 string -
contact_number 联系电话 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1

55.服务商信息

接口说明：通过该接口可以查询所有的配件商、维修厂基本信息。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
servicer 服务商类型 1=>配件商 2=>维修厂 integer 是 1
id 服务商编号 配件商或者维修厂编号 integer 是 无

请求实例：

  1. GET /v1/servicer/profile?servicer=1&id=1 HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "accessory_shops": {
  6.         "accessory_shop_id": 1,
  7.         "accessory_shop_address": "红牌楼三九汽配城B-203号",
  8.         "accessory_shop_name": "成都伟望美国汽车配件",
  9.         "contact": "莫伟",
  10.         "province": 23,
  11.         "city": 385,
  12.         "district": 385,
  13.         "district_name":"",
  14.         "province_name": "四川省",
  15.         "city_name": "成都市",
  16.         "contact_number": "18328388566",
  17.         "realname_authentication": 1,
  18.         "weipei_authentication": 0
  19.     },
  20.     "accessory_shop_brands": [
  21.         {
  22.             "brand_id": 5,
  23.             "brand_name": "宝马"
  24.         }
  25.     ],
  26.     "level":"一级",
  27.     "valid_invitation_code": [],
  28.     "accounts": [
  29.         {
  30.             "account_id": 5,
  31.             "username": "159****9864",
  32.             "mobile": "15928039864",
  33.             "realname": "realname",
  34.             "avatar": "http://img.dev.weipei.cc/Uploads/pictures/avatar/avatar.jpg",
  35.             "uuid": "75df7bb106d9de6c5e50188918486968"
  36.         }
  37.     ]
  38. }
返回参数 含义 参数类型 长度
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 string -
accessory_shop_address 配件商详细地址 string -
contact 联系人 string -
province 省份编号 integer -
city 城市编号 integer -
district 区县编号 integer -
district_name 区县名称 string -
province_name 省份名称 string -
city_name 城市名称 string -
contact_number 联系电话 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1
accessory_shop_brands 配件商主营品牌列表 - -
brand_name 配件商主营品牌名称 string -
level 维修厂等级 string -
valid_invitation_code 可用的邀请码 string -
accounts 账号信息 - -
account_id 账号ID integer -
username 用户名 string -
mobile 手机号码 integer 11
realname 真实姓名 string -
avatar 头像 string -
uuid 账号唯一编码 string 32
third_token 第三方通信token string -

56.新增配件商

接口说明：添加配件商信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
title 名称 配件商名称 string 是 无
contact 联系人 配件商主要联系人 string 是 无
mobile 联系电话 配件商主要联系电话号码 string 是 无
province 省份 省份编号 integer 否 无
city 城市 城市编号 integer 否 无
address 详细地址 配件商详细地址 string 否 无
full_range_service 是否服务全车系 0否 1是 integer 否 无
brand_ids 品牌 品牌编号 string 否 无

请求实例：

  1. POST /v1/accessory-shop/profile HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "title": "成都汽修厂",
  7.     "contact": "程会勇",
  8.     "mobile":"18718902133",
  9.     "province":23,
  10.     "city":385,
  11.     "address":"成都市高新区环球中心",
  12.     "full_range_service":1,
  13.     "brand_ids":"2,5"
  14. }

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "total": 7,
  6.     "returned": 7,
  7.     "accessory_shops": [
  8.         {
  9.             "accessory_shop_id": 1,
  10.             "accessory_shop_address": "红牌楼三九汽配城B-203号",
  11.             "accessory_shop_name": "成都伟望美国汽车配件",
  12.             "contact": "莫伟",
  13.             "province": 23,
  14.             "city": 385,
  15.             "contact_number": "18328388566",
  16.             "realname_authentication": 1,
  17.             "weipei_authentication": 0
  18.         }
  19.     ]
  20. }
返回参数 含义 参数类型 长度
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 string -
accessory_shop_address 配件商详细地址 string -
contact 联系人 string -
province 省份编号 integer -
city 城市编号 integer -
province_name 省份名称 string -
city_name 城市名称 string -
contact_number 联系电话 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1

57.修改配件商

接口说明：更新配件商信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
accessory_shop_id 编号 配件商编号 integer 是 无
title 名称 配件商名称 string 是 无
contact 联系人 配件商主要联系人 string 是 无
mobile 联系电话 配件商主要联系电话号码 string 是 无
province 省份 省份编号 integer 否 无
city 城市 城市编号 integer 否 无
district 区县 区县编号 integer 否 无
address 详细地址 配件商详细地址 string 否 无
full_range_service 是否服务全车系 0否 1是 integer 否 无
brand_ids 品牌 品牌编号 string 否 无

请求实例：

  1. PUT /v1/accessory-shop/profile-setting HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "title": "成都汽修厂",
  7.     "contact": "程会勇",
  8.     "mobile":"18718902133",
  9.     "province":23,
  10.     "city":385,
  11.     "district":2345,
  12.     "address":"成都市高新区环球中心",
  13.     "full_range_service":1,
  14.     "accessory_shop_id":15,
  15.     "brand_ids":"2,5"
  16. }

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "total": 7,
  6.     "returned": 7,
  7.     "accessory_shops": [
  8.         {
  9.             "accessory_shop_id": 1,
  10.             "accessory_shop_address": "红牌楼三九汽配城B-203号",
  11.             "accessory_shop_name": "成都伟望美国汽车配件",
  12.             "contact": "莫伟",
  13.             "province": 23,
  14.             "city": 385,
  15.             "contact_number": "18328388566",
  16.             "realname_authentication": 1,
  17.             "weipei_authentication": 0
  18.         }
  19.     ]
  20. }
返回参数 含义 参数类型 长度
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 string -
accessory_shop_address 配件商详细地址 string -
contact 联系人 string -
province 省份编号 integer -
city 城市编号 integer -
province_name 省份名称 string -
city_name 城市名称 string -
contact_number 联系电话 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1

58.新增维修厂

接口说明：添加维修厂信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
title 名称 配件商名称 string 是 无
contact 联系人 配件商主要联系人 string 是 无
mobile 联系电话 配件商主要联系电话号码 string 是 无
province 省份 省份编号 integer 否 无
city 城市 城市编号 integer 否 无
district 区县 区县编号 integer 否 无
address 详细地址 配件商详细地址 string 否 无
level 维修厂等级 等级编号 integer 否 无

请求实例：

  1. POST /v1/motor-repair-shop/profile HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "title": "成都汽修厂",
  7.     "contact": "程会勇",
  8.     "mobile":"18718902133",
  9.     "province":23,
  10.     "city":385,
  11.     "district":2345,
  12.     "address":"成都市高新区环球中心",
  13.     "level":1
  14. }

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "total": 7,
  6.     "returned": 7,
  7.     "accessory_shops": [
  8.         {
  9.             "accessory_shop_id": 1,
  10.             "accessory_shop_address": "红牌楼三九汽配城B-203号",
  11.             "accessory_shop_name": "成都伟望美国汽车配件",
  12.             "contact": "莫伟",
  13.             "province": 23,
  14.             "city": 385,
  15.             "contact_number": "18328388566",
  16.             "realname_authentication": 1,
  17.             "weipei_authentication": 0
  18.         }
  19.     ]
  20. }
返回参数 含义 参数类型 长度
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 string -
accessory_shop_address 配件商详细地址 string -
contact 联系人 string -
province 省份编号 integer -
city 城市编号 integer -
province_name 省份名称 string -
city_name 城市名称 string -
contact_number 联系电话 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1

59.修改维修厂

接口说明：修改维修厂信息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
title 名称 配件商名称 string 是 无
contact 联系人 配件商主要联系人 string 是 无
mobile 联系电话 配件商主要联系电话号码 string 是 无
province 省份 省份编号 integer 否 无
city 城市 城市编号 integer 否 无
address 详细地址 配件商详细地址 string 否 无
level 维修厂等级 等级编号 integer 否 无
motor_repair_shop_id 编号 维修厂编号 integer 是 无

请求实例：

  1. PUT /v1/motor-repair-shop/profile-setting HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "title": "成都汽修厂",
  7.     "contact": "程会勇",
  8.     "mobile":"18718902133",
  9.     "province":23,
  10.     "city":385,
  11.     "address":"成都市高新区环球中心",
  12.     "level":1,
  13.     "motor_repair_shop_id":1
  14. }

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "total": 7,
  6.     "returned": 7,
  7.     "accessory_shops": [
  8.         {
  9.             "accessory_shop_id": 1,
  10.             "accessory_shop_address": "红牌楼三九汽配城B-203号",
  11.             "accessory_shop_name": "成都伟望美国汽车配件",
  12.             "contact": "莫伟",
  13.             "province": 23,
  14.             "city": 385,
  15.             "contact_number": "18328388566",
  16.             "realname_authentication": 1,
  17.             "weipei_authentication": 0
  18.         }
  19.     ]
  20. }
返回参数 含义 参数类型 长度
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 string -
accessory_shop_address 配件商详细地址 string -
contact 联系人 string -
province 省份编号 integer -
city 城市编号 integer -
province_name 省份名称 string -
city_name 城市名称 string -
contact_number 联系电话 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1

60.BD人员登陆

接口说明：BD人员登陆

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
username 用户名 用户名 string 是 无
password 密码 密码 string 是 无

请求实例：

  1. POST /v1/business-development/login HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "username": "zhouyuan",
  7.     "password":123456
  8. }

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "user_id":10
  6. }
返回参数 含义 参数类型 长度
user_id BD编号 integer -

61.未使用短信验证码

接口说明：获取未使用过的短信验证码

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
mobile 手机号码 手机号码 string 是 无
limit 限制大小 指定返回记录的数量，系统会做验证 integer 否 10
offset 偏移量 指定返回记录的开始位置 integer 否 0

请求实例：

  1. GET /v1/sms-verifications?mobile=15928039864 HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "total": 6,
  6.     "returned": 6,
  7.     "verification_code": [
  8.         {
  9.             "code": 1044,
  10.             "mobile": "15884480681",
  11.             "send_time": "2015-07-21 13:11:40"
  12.         }
  13.     ]
  14. }
返回参数 含义 参数类型 长度
total 总记录数量 integer -
returned 当前返回记录数量 integer -
code 短信验证码 integer -
mobile 手机号码 integer -
send_time 发送时间 - -

62.维修厂等级

接口说明：获取维修厂等级列表

请求实例：

  1. GET /v1/motor-repair-shop-types HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "motor_repair_shop_level": [
  6.     {
  7.       "motor_repair_shop_level_id": 1,
  8.       "motor_repair_shop_level_name": "一级"
  9.     },
  10.     {
  11.       "motor_repair_shop_level_id": 2,
  12.       "motor_repair_shop_level_name": "二级"
  13.     }
  14.   ]
  15. }
返回参数 含义 参数类型 长度
motor_repair_shop_level_id 等级编号 integer -
motor_repair_shop_level_name 当前返回记录数量 integer -

63.区县筛选

接口说明：通过城市编号获取所有的区县信息。

请求参数:

参数名 含义 规则说明 参数类型 是否必须 缺省值
city_id 城市编号 城市ID integer(11) 是 无

请求实例：

  1. GET /v1/districts HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. { 
  2.     "error_msg":"",
  3.     "error_code":0, 
  4.     "status":1,
  5.     "districts":[
  6.         {
  7.             "district_id":1,
  8.             "city_id":22,
  9.             "district_name":"成都市"
  10.         }
  11.     ]
  12. }
返回参数 含义 参数类型 长度
districts 区县列表 - -
district_id 区县编号 integer -
city_id 城市编号 String -
district_name 区县名称 String -

64.账号登出

接口说明：配件商PC版本退出后台，需要重置授权。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无

请求实例：

  1. POST /v1/logout HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "access_token":"token"
  7. }

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  6. }

65.通栏广告

接口说明：获取APP默认首页广告图片。

广告展示策略

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token string 是 无

请求实例：

  1. GET /v1/account/advertisements?access_token=NWRiNTA0ZDgwNDFiYzBiZDA4NzFiZjgxZDUzMjdhYjk= HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "activities": [
  6.     {
  7.       "activity_title": "微配2.1发布更新",
  8.       "activity_url": "http://www.weipei.cc/index_pc.html",
  9.       "activity_image": "http://img.dev.weipei.cc/Uploads/pictures/assets/0d3f4a106429747419b56da84f459b33.jpg"
  10.     }
  11.   ]
  12. }
返回参数 含义 参数类型 长度
activities 活动广告图片汇总 - -
activity_url 链接地址 string -
activity_image 图片 string -

66.线上支付交易单

接口说明：APP发起支付前，回调该接口，拿到支付必要的参数，仅支持手机APP支付。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
order_id 采购单编号 采购单系统编号 integer 是 无
access_token 授权token 授权token string 是 无

请求实例：

  1. GET /v1/transaction?order_id=68&access_token=NWRiNTA0ZDgwNDFiYzBiZDA4NzFiZjgxZDUzMjdhYjk= HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "transactions": [
  6.     {
  7.       "trading_no": "201509301035040000001",
  8.       "total_fee": "12600",
  9.       "title": "前保险杠电眼线束",
  10.       "timestamp":"1435890533866",
  11.      }
  12.   ]
  13. }
返回参数 含义 参数类型 长度
transactions 支付交易必要参数 JSON -
trading_no 支付订单号，32位16进制格式 string -
total_fee 订单价格，单位分 integer -
title 订单标题 string -
timestamp 签名生成时间 integer 10

67.退款（部分）

接口说明：管理员在微配管理后台发起采购单退款请求。仅支持已经支付成功的订单进行退款。目前对于同一笔订单，仅能退款成功一次（对于同一个退款请求，如果第一次退款申请被驳回，仍可以进行二次退款申请）. 退款金额refund_fee必须小于或者等于原始支付订单的total_fee，如果是小于，则表示部分退款。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
order_id 采购单号 采购单系统编号 integer 是 无
items 退货列表 items为空，表示全额退款，否则表示部分退款 Map 是 无
orders_accessory_items_id 采购单配件编号 采购配件系统编号 integer 是 无
number 数量 退货数量 integer 是 无
trading_no 支付订单号 32位16进制格式 string 是 无
administrator BD管理员 仅适用后台操作 integer 是 无

请求实例：

  1. POST /v1/refund HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "order_id":"68",
  7.     "items":[
  8.         {
  9.             "orders_accessory_items_id":1,
  10.             "number":1
  11.         }
  12.     ],
  13.     "trading_no":"201509301035040000001",
  14.     "administrator":"1232",
  15. }

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "refund_no": "2015101311332126830369",
  6.   "ali_refund_no": "2015101311332126830369",
  7.   "ali_refund_url": "https://mapi.alipay.com/gateway.do?_input_charset=UTF-8&app_id=b207d0a0-391f-41d8-851d-88676afb1b61&batch_no=2015101311332126830369&batch_num=1&detail_data=2015101300001000480064479524%5E0.01%5E%E5%8D%8F%E8%AE%AE%E9%80%80%E6%AC%BE&notify_url=http%3A%2F%2Fpayservice.beecloud.cn%2Fbcpay%2FaliRefundDynamic%2Fb207d0a0-391f-41d8-851d-88676afb1b61_7192d78e-71fc-4bfb-918a-6c1207bc032b.php&partner=2088021438919935&refund_date=2015-10-13+11%3A33%3A22&seller_user_id=2088021438919935&service=refund_fastpay_by_platform_pwd&sign=0Hjxx5Ft12LxmAA7gzbDxt7nEswacCcKW2CyNWfWs2EXUJxlFzxQ7RyS4IQtjCDICpjcaSZgYedqCU3UjLLjCGVTeGXBEY0oc60dEx%2FbAze8NQOuS3hweQOF%2BeP%2B8Mn9lfQYoRaaHhw6mAx1h0Ppn%2FtZPnuP%2F%2BUd6eHUmK4lkds%3D&sign_type=RSA",
  8.   "wx_refund_status":"SUCCESS",
  9. }
返回参数 含义 参数类型 长度
refund_no 退款单号 32位16进制格式 32
ali_refund_no 支付宝退款单号 32位16进制格式，只有使用支付宝支付，才返回该参数 32
ali_refund_url 支付宝退款申请链接 使用该链接才能真正退款，只有使用支付宝支付，才返回该参数 -
wx_refund_status 微信退款状态 如果有返回，则表示微信退款正在申请中，如果返回值为SUCCESS, 则表示微信退款成功 16

68.暂停交易

接口说明：采购单如果在线上交易，允许维修厂或配件商取消交易，也支持后台暂停交易。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
order_id 采购单编号 系统返回的采购单ID integer 是 无
administrator BD管理员 仅适用后台操作 integer 是 无

请求实例：

  1. PUT /v1/trading/suspension HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "access_token":"ZGNmNDIyNTMyYjk5OGFjMzMwY2JkZGU2YzcwOTcwODE=",
  7.     "order_id":"520323",
  8.     "administrator":"1232",
  9. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "order_id":1,
  6.     "order_no":"55c0e135808a9"
  7. }
返回参数 含义 参数类型 长度
order_id 采购单系统编号 integer -
order_no 采购单号 string 20

69.恢复交易

接口说明：采购单在暂停交易状态下，可以允许后台恢复交易。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
order_id 采购单编号 系统返回的采购单ID integer 是 无
administrator BD管理员 仅适用后台操作 integer 是 无

请求实例：

  1. PUT /v1/trading/resume HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "order_id":"520323",
  7.     "administrator":"1232",
  8. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "order_id":1,
  6.     "order_no":"55c0e135808a9"
  7. }
返回参数 含义 参数类型 长度
order_id 采购单系统编号 integer -
order_no 采购单号 string 20

70.收货

接口说明：维修厂或者后台人员确认收货。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
order_id 采购单编号 系统返回的采购单ID integer 是 无
administrator BD管理员 仅适用后台操作 integer 是 无

请求实例：

  1. POST /v1/receipt HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "access_token":"ZGNmNDIyNTMyYjk5OGFjMzMwY2JkZGU2YzcwOTcwODE=",
  7.     "order_id":"520323",
  8.     "administrator":"1232",
  9. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "order_id":1,
  6.     "order_no":"55c0e135808a9"
  7. }
返回参数 含义 参数类型 长度
order_id 采购单系统编号 integer -
order_no 采购单号 string 20

71.支付同步回调

接口说明：当APP发起BeCloud支付后，BeCloud会返回支付结果，而该支付结果与WebHook返回存在参数差异，因此，为保证交易资金安全，APP需再次回调该接口保存支付结果。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
order_id 采购单号 采购单系统编号 integer 是 无
trading_no 交易单号 32位的随机10进制格式 string 是 无
channel 渠道类型 BeCloud支持的21种渠道类型，由APP端定义 string 是 无
result_id BeCloud支付标示 BeCloud成功发起支付后返回支付表记录唯一标识 string 是 无
result_code BeCloud返回码 返回码，0为正常，如果交易手动取消，该值默认设置为99 string 是 无
error_message BeCloud支付返回错误信息 具体错误信息 string 否 无
is_canceled 交易是否取消 1-是 0-否 integer 是 0

请求实例：

  1. POST /v1/transaction-callback HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "order_id": 68,
  7.     "trading_no": "201509301035040000001",
  8.     "channel": "ALI_APP",
  9.     "result_id": "121121331",
  10.     "result_code": "0",
  11.     "error_message": "",
  12.     "is_canceled":0,
  13. }

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": ""
  5. }

72.线下支付

接口说明：APP线下支持使用该接口。

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
order_id 采购单号 采购单系统编号 integer 是 无
access_token 授权token 授权token string 是 无

请求实例：

  1. POST /v1/offline-payment HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "access_token":"NWRiNTA0ZDgwNDFiYzBiZDA4NzFiZjgxZDUzMjdhYjk=",
  7.     "order_id":68,
  8. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "order_id":1,
  6.     "order_no":"55c0e135808a9"
  7. }
返回参数 含义 参数类型 长度
order_id 采购单系统编号 integer -
order_no 采购单号 string 20

73.线下转线上支付

接口说明：采购单在线下付款(未真实付款)后，允许继续转成线上支付

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
order_id 采购单号 采购单系统编号 integer 是 无
access_token 授权token 授权token string 是 无

请求实例：

  1. POST /v1/offline-to-online HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  5. {
  6.     "access_token":"NWRiNTA0ZDgwNDFiYzBiZDA4NzFiZjgxZDUzMjdhYjk=",
  7.     "order_id":68,
  8. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "order_id":1,
  6.     "order_no":"55c0e135808a9"
  7. }
返回参数 含义 参数类型 长度
order_id 采购单系统编号 integer -
order_no 采购单号 string 20

74.账务周期

接口说明：配件商商户查看账期交易数据，该接口返回所有的账期数据

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
limit 限制大小 指定返回记录的数量，系统会做验证 integer 否 100
offset 偏移量 指定返回记录的开始位置 integer 否 0

请求实例：

  1. GET /v1/bills?access_token=NWRiNTA0ZDgwNDFiYzBiZDA4NzFiZjgxZDUzMjdhYjk=&limit=100&offset=0 HTTP/1.1
  2. Host: api.weipei.cc
  4. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "total":100,
  6.     "returned": 10,
  7.     "bills":[
  8.         {
  9.             "bill_id":1,
  10.             "status_string":"未结算",
  11.             "status"1,
  12.             "start_date":'2015年10月3日',
  13.             "end_date":"2015年10月10日",
  14.             "total_price":"344",
  15.             "online_price":"344",
  16.             "offline_price":0,
  17.             "platform_fee":1
  18.         }
  19.     ]
  20. }
返回参数 含义 参数类型 长度
total 总记录数量 integer -
returned 当前返回记录integer integer -
bills 账期数据json map -
bill_id 账期编号 integer -
status_string 账期结算状态 string -
status 账期结算状态,1-未结算 2-部分结算 3-已结算 integer -
start_date 账期开始日期 string -
end_date 账期结束日期 string -
total_price 总费用 float -
online_price 平台支付金额 float -
offline_price 非平台支付金额 float -
platform_fee 平台费用 float -

75.账务周期明细

接口说明：配件商商户查看某个账期内交易数据，如何该账期内没有配件商的交易，则返回为空

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 授权token 授权token sring 是 无
limit 限制大小 指定返回记录的数量，系统会做验证 integer 否 100
offset 偏移量 指定返回记录的开始位置 integer 否 0

请求实例：

  1. GET /v1/bill/profile?bill_id=23&access_token=NWRiNTA0ZDgwNDFiYzBiZDA4NzFiZjgxZDUzMjdhYjk= HTTP/1.1
  2. Host: api.weipei.cc
  4. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "bill": {
  6.             "bill_id":1,
  7.             "status_string":"未结算",
  8.             "status":1,
  9.             "start_date":'2015年10月3日',
  10.             "end_date":"2015年10月10日",
  11.             "total_price":"344",
  12.             "online_price":"344",
  13.             "offline_price":0,
  14.             "platform_fee":1
  15.     }
  16.     "details":[
  17.         {
  18.             "repair_shop_name":"成都仪到修理厂",
  19.             "order_no":"20151017153152709552",
  20.             "order_id":1,
  21.             "order_price":"342",
  22.             "trading_way":"online",
  23.             "online_price":"234",
  24.             "platform_fee":13,
  25.             "trading_time":"2015-10-21:10:34:11"
  26.         }
  27.     ],
  28.     "bill_record": [
  29.     {
  30.       "bank": "中国工商银行高新支行",
  31.       "account": "唐丹",
  32.       "card_no": "6212264402002747115",
  33.       "contact": "唐丹",
  34.       "mobile": "18215632330",
  35.       "settlement_amount": 0.01,
  36.       "note": "测试",
  37.       "way": 0,
  38.       "way_string": "无",
  39.       "created_at":"2015-11-12 12:34:11"
  40.     }
  41.   ]
  42. }
返回参数 含义 参数类型 长度
bills 账期数据json map -
bill_id 账期编号 integer -
status_string 账期结算状态 string -
status 账期结算状态,1-未结算 2-部分结算 3-已结算 integer -
start_date 账期开始日期 string -
end_date 账期结束日期 string -
total_price 总费用 float -
online_price 平台支付金额 float -
offline_price 非平台支付金额 float -
platform_fee 平台费用 float -
details 账期明细数据 map -
repair_shop_name 修理厂名称 string -
order_no 采购单号 string 20
order_id 采购单系统编号 integer -
order_price 平台价格 float -
trading_way 支付方式 string -
online_price 采购价格 float -
platform_fee 平台费用 float -
trading_time 收货时间 string -
bill_record 打款记录 map -
bank 开户行 string -
account 账号 string -
card_no 卡号 string -
contact 联系人 string -
mobile 联系电话 string -
settlement_amount 打款金额 float -
note 备注单号 string -
way 打款方式 integer 1
way_string 打款方式描述 string -
created_at 打款时间 string -

76.账务结算

接口说明：管理员手动结算账期内交易单

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
administrator BD管理员 仅适用后台操作 integer 是 无

请求实例：

  1. POST /v1/bill HTTP/1.1
  2. Host: api.weipei.cc
  4. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  6. {
  7.     "administrator":1,
  8. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1
  5. }

77.系统消息

接口说明：批量发送系统消息

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
message_id 系统消息id 仅适用后台操作 integer 是 无

请求实例：

  1. POST /v1/system/message HTTP/1.1
  2. Host: api.weipei.cc
  4. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4
  6. {
  7.     "message_id":1,
  8. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1
  5. }

78.用户协议

接口说明：获取用户协议内容

请求实例：

  1. GET /v1/user-agreement HTTP/1.1
  2. Host: api.weipei.cc
  4. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "title": "用户协议",
  6.   "version": 3,
  7.   "url": "http://api.weipei.cc/trading/Agreement/Index?version=3"
  8. }
返回参数 含义 参数类型 长度
title 标题 string -
version 协议最新版本 integer -
url 用户协议URL string -

79.商户结算信息

接口说明：获取商户结算账号信息

请求实例：

  1. GET /v1/merchant/bill-profile HTTP/1.1
  2. Host: api.weipei.cc
  4. Authorization: 56257a57e2a48adcb77beb724217dde2535371a4

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "bill_account": {
  6.     "bank": "开户行",
  7.     "account": "性能",
  8.     "card_no": "4122",
  9.     "contact": "13",
  10.     "mobile": "13456778899"
  11.   }
  12. }
返回参数 含义 参数类型 长度
bill_account 结算账号信息 map -
bank 开户行 string -
account 账号 string -
card_no 卡号 string -
contact 联系人 string -
mobile 联系电话 string -

80.上传商户图片

接口说明：为后台商户图片上传接口并支持CDN

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
filename key:image 图片名称 图片文件路径 string 是 无

请求实例：

  1. POST /v1/merchant/image HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {          
  6.     "image":"file"
  7. }

返回结果：

  1. {
  2.     "status": 1,
  3.     "error_code": 0,
  4.     "error_msg": "",
  5.     "image_id": 5,
  6.     "thumbnail_image": "http://img.dev.weipei.cc/Uploads/pictures/assets/e4e0efb241e87.jpg",
  7.     "original_image": "http://img.dev.weipei.cc/Uploads/pictures/assets/2f3675aa23917e12df07099363861cad.jpg"
  8. }
返回参数 含义 参数类型 长度
image_id 图片编号 integer -
thumbnail_image 缩略图 string -
original_image 原始图 string -

81.系统初始化

接口说明：整合接口46、78数据，在系统初始化时加载此数据

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
client_version 版本号 客户端APP已有的版本号，默认版本号是1 integer(1) 是 1
model 手机类型 手机设备类型: 0-andriod 1-ios integer(1) 是 0

请求实例：

  1. GET /v1/bootstrap?client_version=1&model=1 HTTP/1.1
  2. Host: api.weipei.com
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "upgrade_info": {
  6.     "latest": 6,
  7.     "upgrade_log": "－修复了部分机型无法打开的问题\n－车型列表添加测试车型，可以通过此车型体验询价报价流程",
  8.     "download_url": "http://www.weipei.cc/pak/weipei_2_0_7_0919.apk",
  9.     "upgrade": 1
  10.   },
  11.   "attributes": [
  12.     {
  13.       "attribute_id": 1,
  14.       "attribute_name": "级别",
  15.       "attribute_sub": [
  16.         {
  17.           "attribute_id": 4,
  18.           "attribute_name": "原厂件"
  19.         }
  20.       ]
  21.     },
  22.     {
  23.       "attribute_id": 2,
  24.       "attribute_name": "质保",
  25.       "attribute_sub": [
  26.         {
  27.           "attribute_id": 7,
  28.           "attribute_name": "无质保"
  29.         }
  30.       ]
  31.     },
  32.     {
  33.       "attribute_id": 3,
  34.       "attribute_name": "到货情况",
  35.       "attribute_sub": [
  36.         {
  37.           "attribute_id": 10,
  38.           "attribute_name": "现货"
  39.         }
  40.       ]
  41.     }
  42.   ],
  43.   "user_agreement": {
  44.     "title": "2.1用户协议",
  45.     "version": 1,
  46.     "url": "http://api.dev.weipei.local/trading/Agreement/Index?version=1"
  47.   },
  48.   "sys_main": {
  49.     "status": "yes",
  50.     "maintenance": "系统正在维护中，请稍后再试！"
  51.   }
  52. }
返回参数 含义 参数类型 长度
upgrade_info 升级信息 Map -
latest 最新版ID integer -
upgrade_log 升级日志 string -
download_url 下载地址 string -
upgrade 升级状态 1-升级 2 - 强制升级 1
attributes 属性列表 Map -
attribute_name 属性名称 string -
attribute_id 属性编号 integer -
attribute_sub 属性子分类 - -
user_agreement 用户协议 Map -
title 标题 string -
version 协议最新版本 integer -
url 用户协议URL string -
sys_main 系统维护通知 Map -
status 维护状态，yes维护中 no不在维护中 string -
maintenance 维护通知内容 string -

82.雪种活动

接口说明：获取配件商报价列表

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
quotation_id 活动报价编号 HTML请求 integer 是 无

请求实例：

  1. GET /v1/activities_parts?quotation_id=1 HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9

返回结果：

  1. {
  2.   "status": 1,
  3.   "error_code": 0,
  4.   "error_msg": "",
  5.   "accessory_shop": {
  6.     "accessory_shop_id": 2969,
  7.     "accessory_shop_name": "John配件商",
  8.     "accessory_shop_image": null,
  9.     "accessory_shop_original_image": null,
  10.     "accessory_shop_address": "桃蹊路",
  11.     "accessory_shop_brands": [
  12.       {
  13.         "brand_id": 2,
  14.         "brand_name": "奥迪"
  15.       },
  16.       {
  17.         "brand_id": 108,
  18.         "brand_name": "保时捷"
  19.       },
  20.       {
  21.         "brand_id": 8,
  22.         "brand_name": "奔驰"
  23.       },
  24.       {
  25.         "brand_id": 56,
  26.         "brand_name": "凯迪拉克"
  27.       }
  28.     ],
  29.     "realname_authentication": 0,
  30.     "weipei_authentication": 0,
  31.     "contact": "屈行",
  32.     "contact_number": "13628029106",
  33.     "province": 23,
  34.     "province_name": "四川省",
  35.     "city": 385,
  36.     "city_name": "成都市",
  37.     "district": 4213,
  38.     "district_name": "成华区",
  39.     "favorites_status": 0,
  40.     "total_quotation_sheets": 3,
  41.     "total_shipped_orders": 1,
  42.     "accounts": {
  43.       "account_id": 10736,
  44.       "username": "153****8632",
  45.       "mobile": "15390278632",
  46.       "realname": "john",
  47.       "avatar": "http://i.weipei.cc/Uploads/pictures/avatar/avatar.jpg",
  48.       "uuid": "db6ac199bafd4424c336795431fb2f1d",
  49.       "account_extra": {
  50.         "account_role": 1,
  51.         "id": 2969,
  52.         "name": "John配件商",
  53.         "contact": "屈行",
  54.         "contact_number": "13628029106",
  55.         "contact_mobile": "13628029106",
  56.         "address": "桃蹊路",
  57.         "image": null,
  58.         "province": 23,
  59.         "city": 385,
  60.         "district": 4213,
  61.         "district_name": "成华区",
  62.         "province_name": "四川省",
  63.         "city_name": "成都市",
  64.         "is_support_logistics": false
  65.       }
  66.     }
  67.   },
  68.   "inquiry_sheet_accessoires": [
  69.     {
  70.       "accessory_item_id": 1297,
  71.       "accessory_item_name": "冷却剂",
  72.       "accessory_item_original_name": null,
  73.       "accessory_item_image_id": 0,
  74.       "quotation_sheet_items": [
  75.         {
  76.           "quotation_sheet_id": 0,
  77.           "quotation_sheet_accessory_item_id": 10,
  78.           "accessory_item_name": "冷却剂",
  79.           "accessory_item_image": "",
  80.           "accessory_item_original_image": "",
  81.           "accessory_level": 5,
  82.           "accessory_quality_gurantee_period": 8,
  83.           "accessory_arrival": 19,
  84.           "price": 0.01,
  85.           "accessory_brand": "车仆",
  86.           "accessory_unit": "箱",
  87.           "notes": "车仆牌",
  88.           "stock": 84
  89.         },
  90.         {
  91.           "quotation_sheet_id": 0,
  92.           "quotation_sheet_accessory_item_id": 7,
  93.           "accessory_item_name": "冷却剂",
  94.           "accessory_item_image": "",
  95.           "accessory_item_original_image": "",
  96.           "accessory_level": 4,
  97.           "accessory_quality_gurantee_period": 7,
  98.           "accessory_arrival": 10,
  99.           "price": 0.01,
  100.           "accessory_brand": "111",
  101.           "accessory_unit": "1111",
  102.           "notes": "1212",
  103.           "stock": 2289
  104.         },
  105.         {
  106.           "quotation_sheet_id": 0,
  107.           "quotation_sheet_accessory_item_id": 6,
  108.           "accessory_item_name": "冷却剂",
  109.           "accessory_item_image": "",
  110.           "accessory_item_original_image": "",
  111.           "accessory_level": 12,
  112.           "accessory_quality_gurantee_period": 15,
  113.           "accessory_arrival": 18,
  114.           "price": 1,
  115.           "accessory_brand": "13",
  116.           "accessory_unit": "11",
  117.           "notes": "11",
  118.           "stock": 0
  119.         }
  120.       ]
  121.     }
  122.   ],
  123.   "inquiry_sheet": {
  124.     "exipiry_time": 1459439999,
  125.     "server_time": 1458115183,
  126.     "created_at": 1457539200,
  127.     "automobile_brand_name": "雪种活动"
  128.   }
  129. }
返回参数 含义 参数类型 长度
accessory_shop 配件商 - -
accessory_shop_id 配件商编号 integer -
accessory_shop_name 配件商名称 string -
accessory_shop_image 配件商缩略图 string -
accessory_shop_original_image 配件商图片 string -
accessory_shop_address 配件商详细地址 string -
accessory_shop_brands 配件商主营品牌列表 - -
brand_name 配件商主营品牌名称 string -
realname_authentication 实名认证， 1=已通过认证 0-未通过认证 integer 1
weipei_authentication 微配认证 1=已通过认证 0-未通过认证 integer 1
contact 联系人 string -
contact_number 联系电话 string -
province 省份编号 integer -
province_name 省份名称 string -
city 城市编号 integer -
city_name 城市名称 string -
district 区域编号 integer -
district_name 区域名称 string -
favorites_status 是否收藏 integer -
total_inquiry_sheets 维修厂总共询价单 integer -
total_shipped_orders 维修厂已发货的采购单 integer -
account_extra 账号附加信息 - -
account_role 账号角色,1-配件商 2-修理厂 integer -
name 修理厂或者配件商名称 string -
contact 修理厂或者配件商联系人 string -
contact_number 修理厂或者配件商联系电话 string -
mobile 修理厂或者配件商手机号 string -
address 修理厂或者配件商详细地址 string -
image 修理厂或者配件商图片 string -
province 省份编号 integer -
city 城市编号 integer -
district 地区编号 integer -
district_name 地区名称 string -
province_name 省份编号 string -
city_name 城市编号 string -
is_support_logistics 是否支持物流 true支持 false不支持 boolean -
inquiry_sheet_accessoires 询价单条目信息 - -
accessory_item_id 配件编号 integer -
accessory_item_name 配件名称 string -
accessory_item_image 配件图片 string -
stock 库存 integer -
quotation_sheet_items 报价单配件条目 - -
quotation_sheet_accessory_item_id 报价配件编号 integer -
price 配件价格 float -
accessory_level 配件等级 string -
accessory_quality_gurantee_period 质保期 string -
accessory_arrival 配件到达情况 string -
brand_description 品牌描述 string -
unit 单位 string -
notes 备注 string -

83.雪种活动采购单

接口说明：修理厂创建采购单

请求参数：

参数名 含义 规则说明 参数类型 是否必须 缺省值
access_token 修理厂账户Token 修理厂账户授权Token string 是 无
consignee 收货人 收货人姓名 string 是 -
mobile 联系电话 收货人联系电话 string 是 -
address 收货地址 收货人收货地址 string 是 -
pirce 价格 报价价格，支持两位小数 float 是 无
way 货运方式 货运方式 string 是 无
order_accessory_items 采购单配件 采购单配件 - - -
quotation_sheet_accessory_item_id 报价配件编号 系统返回的报价配件ID integer 是 -
number 数量 采购配件数量 integer 是 -
shipping_method 发货方式 1微配直送 2其他物流 integer 是 2

请求实例：

  1. POST /v1/activities-parts-order HTTP/1.1
  2. Host: api.weipei.cc
  3. Authorization: d4a5cc579e4aca45fe7c4d33e72656a135aaa0f9
  5. {
  6.     "access_token":"YzM1ZmMyM2QxOGQ2NmE3ZDEyMWY5MTE0Njk2ZGQ5MDU=",
  7.     "consignee":"描述",
  8.     "mobile":"件",
  9.     "address":"备注",
  10.     "pirce":"90.2",
  11.     "way":1,
  12.     "shipping_method":1,
  13.     "order_accessory_items":[
  14.         {
  15.             "quotation_sheet_accessory_item_id":1,
  16.             "number":12
  17.         }
  18.     ]
  19. }

返回结果：

  1. {
  2.     "error_msg":"",
  3.     "error_code":0,
  4.     "status":1,
  5.     "order_id":1,
  6.     "order_no":"20160304152534532696"
  7. }
返回参数 含义 参数类型 长度
order_id 采购单系统编号 integer -
order_no 采购单号 string 20
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注