# Common interface

# Get Information for Launched Cities

Feature: View launched cities and city codes in the user’s location

Method: POST

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

Requested Parameters:

Parameter	Type	Required or Not	Description
fleet_id	int64	Yes	Fleet ID
location_country	string	Yes	Country
lang	string	Yes	Language

Returned Parameters:

Parameter	Type	Description
value	int32	City code
text	string	City name

Return example:

Normal condition

{
  "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

Note: “response” in the return example is json data obtained through decryption and deserialization

# Upload Image Information

Feature: Upload image needed for review

Method: POST

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

Requested Parameters:

Parameter	Type	Required or Not	Description
fleet_id	int64	Yes	Fleet ID
location_country	string	Yes	Country
lang	string	Yes	Language
img_data	string	Yes	Image data; format: PNG or JPG. base64 encoding is required for image data, and the file cannot exceed 500kb

Returned Parameters:

Parameter	Type	Required or Not	Description
img_url	string	Yes	url link of the image

Request example:

{
  "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

Return example:

Normal condition

{
  "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

Abnormal condition

{
    "errno": 10001,
    "msg": "parameter error."
}

1
2
3
4

Note: “response” in the return example is json data obtained through decryption and deserialization