{"id":13835,"date":"2025-05-07T15:23:11","date_gmt":"2025-05-07T12:23:11","guid":{"rendered":"https:\/\/www.fmsdocumentation.com\/assegnazione-dei-driver-api\/"},"modified":"2025-05-08T09:35:06","modified_gmt":"2025-05-08T06:35:06","slug":"assegnazione-dei-driver-api","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/it\/api\/assegnazione-dei-driver-api\/","title":{"rendered":"Assegnazione dei driver API"},"content":{"rendered":"

1. Descrizione<\/h2>\n

L’API per l’assegnazione dei conducenti \u00e8 utilizzata per assegnare i conducenti agli oggetti (veicoli). Questo permette agli utenti web che hanno generato la loro chiave API di creare assegnazioni di conducenti o di ottenere le ultime assegnazioni utilizzando le chiamate API. <\/p>\n

2. API versione 1<\/h2>\n

2.1. Crea assegnazione
\n2.1.1. Richiesta con data e ora <\/h4>\n
\n
POST \/driver\/assignations?version=1&api_key=<...>\nHOST: api.fm-track.com\nContent-Type: application\/json;charset=UTF-8\n \nBODY:\n    {\n    \"driver_id\": \"240afea1-84ae-43ec-8139-f13cfa2f3094\",\n    \"object_id\": \"7bf8990c-dba6-11e9-bdfc-1ff21de66015\",\n    \"event_type\": \"START\"\n    \"datetime\":\"2021-07-01T08:50:23.893Z\"\n    }<\/pre>\n<\/div>\n
2.1.2. Richiesta senza datetime<\/h4>\n
\n
\n
POST \/driver\/assignations?version=1&api_key=<...>\nHOST: api.fm-track.com\nContent-Type: application\/json;charset=UTF-8\n \nBODY:\n    {\n    \"driver_id\": \"240afea1-84ae-43ec-8139-f13cfa2f3094\",\n    \"object_id\": \"7bf8990c-dba6-11e9-bdfc-1ff21de66015\",\n    \"event_type\": \"START\"\n    }<\/pre>\n<\/div>\n<\/div>\n
<\/div>\n
\n\n\n\n\t\n\n\t\n\t\n\t\n\t\n\t\n\t
 <\/th>Parameter<\/th>Type<\/th>Description<\/th>Is required<\/th>Validation<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>version<\/td>string<\/td>Version of API<\/td>+<\/td><\/td>\n<\/tr>\n
2<\/td>api_key<\/td>string<\/td>User identification key\t<\/td>+<\/td><\/td>\n<\/tr>\n
3<\/td>driver_id<\/td>string<\/td>Driver identifier, External driver ID\t<\/td>+<\/td><\/td>\n<\/tr>\n
4<\/td>object_id<\/td>string<\/td>Object identifier, External object ID \t<\/td>+<\/td><\/td>\n<\/tr>\n
5<\/td>event_type<\/td>string<\/td>Event type\t<\/td>+<\/td>Possible values: START, STOP<\/td>\n<\/tr>\n
6<\/td>datetime<\/td>string<\/td>Datetime for START or STOP event\t<\/td>-<\/td>ISO 8601 datetime<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
2.1.3. Risposta per la richiesta corretta<\/h4>\n
\n
\n
\n
\n
{\n    \"object_id\":\"7bf8990c-dba6-11e9-bdfc-1ff21de66015\",\n    \"driver_id\":\"240afea1-84ae-43ec-8139-f13cfa2f3094\",\n    \"event_type\":\"START\",\n    \"datetime\":\"2021-07-01T08:50:23.893Z\"\n}<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
<\/div>\n
\n\n\n\n\t\n\n\t\n\t\n\t\n\t
 <\/th>Parameter<\/th>Type<\/th>Description<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>driver_id<\/td>string<\/td>Driver identifier, External driver ID<\/td>\n<\/tr>\n
2<\/td>object_id<\/td>string<\/td>Object identifier, External object ID<\/td>\n<\/tr>\n
3<\/td>event_type<\/td>string<\/td>Event type<\/td>\n<\/tr>\n
4<\/td>datetime<\/td>string<\/td>Datetime of START or STOP event<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
2.1.4. Risposte per richieste non corrette <\/span><\/h4>\n
\n
\n
\n
{\n    \"code\": 422,\n    \"message\": \"Validation failed, see 'fieldValidationErrors' for more details\",\n    \"field_validation_errors\": [\n        {\n            \"field\": \"objectId\",\n            \"reason\": \"must not be empty\",\n            \"rejected_value\": \"<null value>\"\n        },\n        {\n            \"field\": \"driverId\",\n            \"reason\": \"must not be empty\",\n            \"rejected_value\": \"<null value>\"\n        },\n        {\n            \"field\": \"eventType\",\n            \"reason\": \"must not be null\",\n            \"rejected_value\": \"<null value>\"\n        }\n    ]\n}<\/pre>\n<\/div>\n
\n
{\n    \"code\": 400,\n    \"message\": \"Please provide valid driver assignation event type START|STOP\"\n}<\/pre>\n<\/div>\n
\n
{\n    \"code\": 400,\n    \"message\": \"Invalid format: \\\"1993 05 04\\\" is malformed at \\\" 05 04\\\"\"\n}<\/pre>\n<\/div>\n
\n
{\n    \"code\": 404,\n    \"message\": \"Object with id 7bf8990c-dba6-11e9-bdfc-1ff21de66015asdasdasdasdasdadas not found\"\n}<\/pre>\n<\/div>\n
\n
{\n    \"code\": 404,\n    \"message\": \"Driver with id 240afea1-84ae-43ec-8139-f13casfa2f3094 not found\"\n}<\/pre>\n<\/div>\n<\/div>\n<\/div>\n
<\/div>\n
\n\n\n\n\t\n\n\t\n\t
Parameter<\/th>Description<\/th>\n<\/tr>\n<\/thead>\n
code<\/td>Error code
\n400 - server cannot or will not process the request due to an apparent client error;
\n404 - requested resource could not be found but may be available in the future;<\/td>\n<\/tr>\n
message<\/td>Error code message<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
2.2. Ottieni l’ultima assegnazione
\n2.2.1. Richiesta perObjectID <\/h4>\n
\n
GET \/driver\/assignations\/last?version=1&byObjectId={objectId}&api_key=<...>\nHOST: api.fm-track.com\nContent-Type: application\/json;charset=UTF-8<\/pre>\n<\/div>\n
2.2.2. Esempio perObjectID<\/h4>\n
\n
\n
\n
\n
GET \/driver\/assignations\/last?version=1&byObjectId=7bf8990c-dba6-11e9-bdfc-1ff21de66015&api_key=L6fwb1xODwA95qF7ybXJ4S2cSM49h1Wj\nHOST: api.fm-track.com\nContent-Type: application\/json;charset=UTF-8<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
2.2.3. Richiesta byDriverId<\/span><\/h4>\n
\n
GET \/driver\/assignations\/last?version=1&byDriverId={driverId}&api_key=<...>\nHOST: api.fm-track.com\nContent-Type: application\/json;charset=UTF-8<\/pre>\n<\/div>\n
2.2.4. Esempio perDriverId<\/span><\/h4>\n
\n
\n
\n
\n
GET \/driver\/assignations\/last?version=1&byDriverId=240afea1-84ae-43ec-8139-f13cfa2f3094&api_key=L6fwb1xODwA95qF7ybXJ4S2cSM49h1Wj\nHOST: api.fm-track.com\nContent-Type: application\/json;charset=UTF-8<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
 <\/p>\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t
 <\/th>Parameter<\/th>Type<\/th>Description<\/th>Is required<\/th>Validation<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>version<\/td>string<\/td>Version of API<\/td>+<\/td><\/td>\n<\/tr>\n
2<\/td>api_key<\/td>string<\/td>User identification key<\/td>+<\/td><\/td>\n<\/tr>\n
3<\/td>byDriverId<\/td>string<\/td>Driver identifier, External driver ID<\/td>+<\/td>Either byDriverId or byObjectId is required<\/td>\n<\/tr>\n
4<\/td>byObjectId<\/td>string<\/td>Object identifier, External object ID<\/td>+<\/td>Either byDriverId or byObjectId is required<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n
2.2.5. Risposta per la richiesta corretta <\/span><\/h4>\n
\n
\n
\n
\n
{\n    \"object_id\":\"7bf8990c-dba6-11e9-bdfc-1ff21de66015\",\n    \"driver_id\":\"240afea1-84ae-43ec-8139-f13cfa2f3094\",\n    \"event_type\":\"STOP\",\n    \"datetime\":\"2021-07-01T08:50:28.893Z\"\n}<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
 <\/p>\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t
 <\/th>Parameter<\/th>Type<\/th>Description<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>driver_id<\/td>string<\/td>Driver identifier, External driver ID<\/td>\n<\/tr>\n
2<\/td>object_id<\/td>string<\/td>Object identifier, External object ID<\/td>\n<\/tr>\n
3<\/td>event_type<\/td>string<\/td>Event type<\/td>\n<\/tr>\n
4<\/td>datetime<\/td>string<\/td>Datetime of START or STOP event<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n
2.2.6. Risposte per richieste non corrette <\/span><\/h4>\n
\n
\n
\n
\n
{\n    \"code\": 400,\n    \"message\": \"No query parameters were provided. Provide query parameters byDriverId or byObjectId\"\n}<\/pre>\n<\/div>\n
\n
{\n    \"code\": 404,\n    \"message\": \"Driver assignation event by driver id 8200f935-4970-43e3-8ab2-220c7f6463f4 not found\"\n}<\/pre>\n<\/div>\n
\n
{\n    \"code\": 404,\n    \"message\": \"Driver with id 240afea1-84ae-43ec-8139-f13cfa2f3a094 not found\"\n}<\/pre>\n<\/div>\n
\n
{\n    \"code\": 404,\n    \"message\": \"Object with id 7bf8990c-dba6-11de9-bdfc-1ff21de66015 not found\"\n}<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
<\/div>\n
\n\n\n\n\t\n\n\t\n\t
Parameter<\/th>Description<\/th>\n<\/tr>\n<\/thead>\n
code<\/td>Error code
\n400 - server cannot or will not process the request due to an apparent client error;
\n404 - requested resource could not be found but may be available in the future;<\/td>\n<\/tr>\n
message<\/td>Error code message<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
1. Descrizione L’API per l’assegnazione dei conducenti \u00e8 utilizzata per assegnare i conducenti agli oggetti (veicoli). Questo permette agli utenti web che hanno generato la loro chiave API di creare assegnazioni di conducenti o di ottenere le ultime assegnazioni utilizzando le chiamate API. 2. API versione 1 2.1. Crea assegnazione 2.1.1. Richiesta con data e … Continua a leggere Assegnazione dei driver API<\/span><\/a><\/p>\n","protected":false},"author":19,"featured_media":0,"parent":14003,"menu_order":15,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-13835","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/13835","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/users\/19"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/comments?post=13835"}],"version-history":[{"count":1,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/13835\/revisions"}],"predecessor-version":[{"id":14017,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/13835\/revisions\/14017"}],"up":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/14003"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/media?parent=13835"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}