DDDLAB API dovoluje do Vašeho portálu integrovat službu vyhodnocení dat, tedy přestupků, výpočet pracovní doby, doby řízení a podobně ze souborů DDD z karet řidiče. Zejména při vzdáleném stahování pak zákazník nemusí používat externí software pro vyhodnocení těchto dat ale vše má na jednom místě na Vašem portálu.
Vyhodnocení provádíme na základě interpretace regulací EU 15/2002 a 561/2006.
Pomocí DDDLAB API je možné nahrát DDD soubor z karty řidiče na náš server, odtud je následně možné získat přehled (preview ) dat v souboru. Dalším dotazem je pak možné provést analýzu dat za vybraný časový úsek a získat výsledná data v podobě JSON formátu. Tato data si pak zpracujete na serveru vlastního portálu do výstupní podoby dle potřeby. Každému uživateli je přidělen unikátní token, kterým se identifikuje serveru, na základě platnosti tohoto tokenu je následně prováděno měsíční vyúčtování použití služby.
- podporovány jsou i karty řidiče generace 2 verze 1.
- součástí je i kontrola signatur v souboru
- výstupní data jsou ve formátu JSON
Příklad části výstupu s přestupkem:
"id": "Analysis by Directive (EC) 15\/2002, Analysis by Regulation (EC) 561\/2006",
"infringements": [
{
"date": "2016-08-06T07:26:00+02:00",
"type": "1000",
"severity": "3",
"rule_id": "Rule_561_2006_6_1",
"begin": "2016-08-04T14:14:00+02:00",
"end": "2016-08-06T07:26:00+02:00",
"allowed": {
"semantic": "2",
"type": "2",
"value": "10:00:00"
},
"measured": {
"semantic": "2",
"type": "2",
"value": "13:02:00"
}
},Příklad části výstupních dat s dobami činnosti, přestávek a podobně:
{
"begin": "2016-08-31T14:36:00+02:00",
"end": "2016-09-01T06:31:00+02:00",
"duration": "15:55:00",
"times": {
"driving": "06:02:00",
"work": "00:41:00",
"standby": "00:00:00",
"break": "09:12:00",
"unknown": "00:00:00",
"workshift_total": "08:42:00",
"workshift_night": "03:13:00",
"workshift_safety_breaks": "01:19:00",
"workshift_short_breaks": "00:40:00",
"workshift_excluded": "07:13:00",
"worked_total": "07:28:00",
"worked_night": "02:54:00",
"worked_safety_breaks": "00:45:00",
"rest": {
"rest_time": "08:10:00",
"daily_rest_time": "08:05:00",
"daily_type": "13",
"weekly_type": "0"
}
},Nově je k dispozici OpenAPI 3.0.0 specifikace pro DDDLAB API verze 2, která kromě drobných úprav parametrů některých dotazů umožňuje i plnohodnotnou konverzi DDD souborů dat z vozidel a karet řidičů. Je tedy nyní možné jednoduše vyhodnocené soubory poskytnout zákazníkovi k prohlížení či manuální analýze v uživatelsky přívětivém HTML s obdobným výstupem jako má DDD2HTML nebo ve formátu JSON/XML odpovídající výstupu programu DDD2XML.
Specifikace (yaml) / dokumentace (html) .
OpenAPI 3.0.0 je specifikací pro strojově čitelné soubory rozhraní pro popis, produkci, spotřebu a vizualizaci webových služeb RESTful [wiki]. S pomocí automatizovaných nástrojů je možné tuto specifikaci použít pro rychlou integraci našeho API do vašeho systému. Je také k dispozici volně dostupná c++ wrapper knihovna k libCurl.
Pro bližší informace k implementaci nás kontaktujte například emailem na adrese info (zavináč) canlab.cz.