Rapporto sulla tabella oraria dei conducenti API

Descrizione

L’API per il report della tabella degli orari degli autisti restituisce gli orari di lavoro degli autisti dal file DDD (tachigrafo) per un periodo di 1 mese, con orari di lavoro notturni, diurni e totali.

Limitazioni

  • 1000 req/min
  • Il periodo massimo รจ di 3 mesi
  • Funziona solo per i dati TACHOGRAPH

Parametri della richiesta

GET /drivertimetable/{type}-{identifier}?api_key=<..>&time_range_year=<..>&timezone=<..>&time_range_month=<..>&business_hours_start=<..>&business_hours_end=<..>&status_available_as_working_time=<..>&version=<..>
Host: api.fm-track.com
Content-Type: application/json;charset=UTF-8
 ParameterTypeDescriptionIs requiredRemarks
1identifierstringDriver card number+
2typestringtype of identification+Now only "TACHOGRAPH" is supported
3timezonestringtime zone+example for format: "timezone=GMT", "timezone=Vilnius" etc.
4time_range_monthintegertime range set by months+example for format: "time_range_month=8"
5time_range_yearintegertime range year by year+Example for format: "time_range_year=2022"
6business_hours_startstringbusiness hours start at time+Example for format: "business_hours_start=07:00"
7business_hours_endstringbusiness hours end at time+Example for format: "business_hours_end=18:00"
8status_available_as_working_timebooleanstatus available as working time TRUE/FALSE+Include status available as working time for the working hours calculation
9versionstringversion of API+At this moment we have only version=1
10api_keystringUser identification key+

Parametri di risposta

{
  "days": [
    {
      "date": "2023-05-15T13:56:15.275Z",
      "holiday": true,
      "work_duration_at_day": 0,
      "work_duration_at_night": 0
    }
  ],
  "driver_name": "string",
  "identifier": "string",
  "time_card_number": "string",
  "total_day_working_hours": 0,
  "total_night_working_hours": 0,
  "total_working_hours": 0
}
NameTypeDescription
identifierstringDriver card number
driver_namestringDriver name and surname
time_card_numberstringTime card number
total_day_working_hoursnumberSummary of working time during day hours. Units: seconds.
total_night_working_hoursnumberSummary of working time during night hours. Units: seconds.
total_working_hoursnumberSummary of working time. Units: seconds.
daysarrayArray of days
datedatetimeDay date, format "2022-07-03T00:00:00.000"
holidayboolean"True" if day is holiday, "false" if not.
work_duration_at_daynumberWorking time for the day during day hours. Units: seconds.
work_duration_at_nightnumberWorking time for the day during night hours. Units: seconds.