# 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, полученные путем расшифровки и десериализации