# Common interface

# 获取已开放城市信息

功能: 查看所在地区开放的城市和城市码

方法: POST

URL: /fleet/open-api/utils/getRegisteredCity

请求参数:

参数 类型 是否必填 说明
fleet_id int64 车头ID
location_country string 所属国家
lang string 语言

返回参数:

参数 类型 说明
value int32 城市编码
text string 城市名

返回示例:

正常情况

{
    "errno": 0,
    "msg": "success",
    "data": {
      "response": {
        "registered_city": [{
          "text":"Астрахань",
          "value":7350200
        },{
          "text":"Абакан",
          "value":7200300
        }]
      },
      "trace_id": "0a6072d45f3cdd6be61db3f9ffdfc9b0"
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

注:返回示例中的“response”是经过解密,反序列化后的json格式

# 上传图片信息

功能: 上传审核需要的图片

方法: POST

URL: /fleet/open-api/utils/uploadPicture

请求参数:

参数 类型 是否必填 说明
fleet_id int64 车头ID
location_country string 所属国家
lang string 语言
img_data string 图片数据,格式为PNG或者JPG。图片数据需要经过base64转码,文件大小不超过500kb

返回参数:

参数 类型 是否必填 说明
img_url string 图片的url链接

请求示例:

{
  "fleet_id":10000000000000, 
  "location_country": "RU",
  "lang": "ru-RU",
"img_data":"data:image/jpg;base64,/9j/4AAQSkZJRgABAQAASABIAAD/4QMgAAhAEbAAUAAAABAAAAjAEoAAMAAAABAAIAAAEyAAIAAAAUAAAAlIdpAAQAAAABAAAAqAAAAABDYW5vFB4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHikAIcbX4/LFGmdM1fnqF1mXI/EitXTf2grUFVGmeIN2SRt1vPXr95apU0+ocp9bP4atZI2Qu/zDqXx+I/CvLbj9mP4ZySyT/2Xcs8rmV83bjLE5PSvN7P4/2KKf8AiW+MUVuxJ/hIpTM2eUfNRY84jdxt5GKhMjAkZzjjNArn//2Q=="
}
1
2
3
4
5
6

返回示例:

正常情况

{
    "errno": 0,
    "msg": "success",
    "data": {
      "response": {
        "img_url": "/upload/rooster20210901/57394549e2d/3563379dd813b2"
      },
      "trace_id": "0a6072d45f3cdd6be61db3f9ffdfc9b0"
    }
}
1
2
3
4
5
6
7
8
9
10

异常情况

{
    "errno": 10001,
    "msg": "parameter error."
}
1
2
3
4

注:返回示例中的“response”是经过解密,反序列化后的json格式