API Метод: visits. Список визитов
Данный метод необходим для авторизации на сервере WODO и последующего использования сервиса WODO API. При выполнении метода пользователь получает в ответ токен, который необходимо передавать в заголовках последующих запросов к сервису WODO API.
Для получения логина и пароля обратитесь в службу поддержки или свяжитесь со своим менеджером проекта.
Адрес запроса
https://app.mywodo.ru/external-api/visits/v1
Параметры:

  • "date" - обязательно, в формате YYYY-MM-DD
  • "page[number]" - пагинация: номер страницы (по умолчанию 0)
  • "page[size]" - пагинация: количество строк на странице (по умолчанию 1000)
Адрес запроса
https://app.mywodo.ru/external-api/visits/v1?date=2023-01-05&page[size]=20&page[number]=0
Для получения списка визитов в параметрах запроса обязательно нужно указывать дату.
Пример вызова API списка визитов:
import requests
import json

payload={}
access_token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmcmVzaCI6ZmFsc2UsImlhdCI6MTY3NTc4NDgxMSwi
anRpIjoiNDZhOWJlNDEtOTNlZi00ZWYyLThjYmItM2UyMzNlM2MzY2QzIiwidHlwZSI6ImFjY2VzcyIs
InN1YiI6InRlc3RfYXBpIiwibmJmIjoxNjc1Nzg0ODExLCJleHAiOjE2NzU3ODU3MTF9.ZPSxaEEKTPV1
Hij1W2Pw8ggJ7CGzdHoUmpbtv-6-q2U"
headers = {
'Authorization': f'Bearer {access_token}',
}

response = requests.request("GET", url, headers=headers, data=payload)
print(json.loads(response.text))

В случае не указанного или неверно указанного параметра "date", вы получите ошибку 400:
{
"detail": null,
"mes": "date",
"success": false,
"type": "BadRequest"
}
В случае успешного ответа данные содержатся в массиве "data".
В параметре "rowcount" указано общее количество строк, удовлетворяющих запросу, чтобы понимать, нужно ли запрашивать следующую страницу с данными (параметр запроса page[number]=0,1,...).
Атрибуты визита:
Пример ответа:
i{
"data": [
{
"address_tt": "Магнит - Краснодар, ул. Декабристов 59/2",
"branch_tt": "",
"city_tt": "Краснодар",
"code_tt": "666666666_2",
"contragent_name": "test",
"device_id": "-",
"device_model": "-",
“id_manager”: “2”,
"id_merch": "28",
"id_tt": "1",
"images": [
{
"category": "",
"image": "https://app.mywodo.ru/files/tmp/4af46522-9184-11ed-a3e5-318a151163b3.webp"
},
{
"category": "",
"image": "https://app.mywodo.ru/files/tmp/4af46523-9184-11ed-a3e5-318a151163b3.webp"
},
{
"category": "",
"image": "https://app.mywodo.ru/files/tmp/4af46524-9184-11ed-a3e5-318a151163b3.webp"
}
],
"latitude_tt": 45.1,
"longitude_tt": 38.9,
"name_tt": "666666666_2",
"network_tt": "Какой-то Магнит",
"type_tt": "",
"visit_begin_date": "2023-01-05T08:31:00",
"visit_date": "2023-01-05T00:00:00",
"visit_end_date": "2023-01-05T08:54:00",
"visit_end_distance":”5”,
"visit_has_fake_gps": "нет",
"visit_has_fake_photos": "нет",
"visit_id": "1",
"visit_last_time": "2023-01-11T07:48:09",
"visit_latitude": 45.1,
"visit_longitude": 38.9,
"visit_photos_url": "https://app.mywodo.ru/webapi/tasks/1/photos/export",
"visit_plan_lead_time": "77",
"visit_plan_travel_time_minutes": "0",
"visit_remote_finished": "нет",
"visit_result_url": "https://app.mywodo.ru/tasks/1/result",
"visit_status": "COMPLETED",
"visit_type": "Визит",
"visit_unscheduled": "нет",
"visit_work_time": "23"
},
{
"address_tt": "350089, Краснодарский край, Краснодар г, Бульварное Кольцо ул, дом № 7",
"branch_tt": "",
"city_tt": "Краснодар",
"code_tt": "233503",
"contragent_name": "test",
"device_id": "-",
"device_model": "-",
“id_manager”: “2”,
"id_merch": "28",
"id_tt": "2",
"images": [
{
"category": "",
"image": "https://app.mywodo.ru/files/tmp/4af46526-9184-11ed-a3e5-318a151163b3.webp"
},
{
"category": "",
"image": "https://app.mywodo.ru/files/tmp/4af46527-9184-11ed-a3e5-318a151163b3.webp"
},
{
"category": "",
"image": "https://app.mywodo.ru/files/tmp/4af46528-9184-11ed-a3e5-318a151163b3.webp"
}
],
"latitude_tt": 45.113027,
"longitude_tt": 38.937645,
"name_tt": "Завод",
"network_tt": "Какой-то Магнит",
"type_tt": "",
"visit_begin_date": "2023-01-05T09:51:00",
"visit_date": "2023-01-05T00:00:00",
"visit_end_date": "2023-01-05T10:26:00",
"visit_end_distance": “5”,
"visit_has_fake_gps": "нет",
"visit_has_fake_photos": "нет",
"visit_id": "4",
"visit_last_time": "2023-01-11T07:48:09",
"visit_latitude": 45.113027,
"visit_longitude": 38.937645,
"visit_photos_url": "https://app.mywodo.ru/webapi/tasks/4/photos/export",
"visit_plan_lead_time": "65",
"visit_plan_travel_time_minutes": "0",
"visit_remote_finished": "нет",
"visit_result_url": "https://app.mywodo.ru/tasks/4/result",
"visit_status": "COMPLETED",
"visit_type": "Визит",
"visit_unscheduled": "нет",
"visit_work_time": "35"
}],
"rowcount": 2
}


Изображения фотографий

Скачивание изображений по ссылкам доступно без авторизации. access_token указывать не нужно.
Адрес запроса
https://app.mywodo.ru/files/tmp/4af46528-9184-11ed-a3e5-318a151163b3.webp
import requests

response = requests.request("GET", url)
print(response.text)