Il contenuto richiesto \u00e8 fornito in formato JSON<\/strong> con codifica UTF-8. Se viene utilizzato un altro formato, viene specificato nella descrizione del metodo. <\/p>\n Il codice di stato HTTP identifica lo stato della richiesta – per le richieste andate a buon fine, viene restituito il codice di stato 200<\/strong>. Insieme a questa risposta, verranno ricevute le informazioni richieste dal server. Le risposte variano a seconda del tipo di API utilizzata. Le risposte API per i diversi tipi di API sono descritte nelle sezioni successive. <\/p>\n Se si \u00e8 verificato un errore nella richiesta inviata, il sistema restituir\u00e0 un messaggio di risposta con un codice di stato. Codici di errore comuni: <\/p>\n I codici di errore forniscono alcune informazioni generali sul tipo di errore, consentendo all’utente di identificare la radice del problema.<\/p>\n Alcune API hanno elementi opzionali (parametri) nella loro risposta; i parametri opzionali possono essere saltati dal sistema per vari motivi (assenza di dati, dati errati, tempo di risposta scaduto, ecc.) L’utente non deve dare per scontato che alcuni dati opzionali saranno sempre inclusi in una risposta. <\/p>\n Tutte le API hanno un’unica limitazione:<\/p>\n Questa limitazione \u00e8 valida per tutte le API esistenti di FMS.<\/p>\n L’autenticazione e l’autorizzazione delle API sono necessarie per controllare l’utilizzo delle API da parte di diversi client e la loro integrazione con diversi sistemi. Per effettuare una richiesta autorizzata alle API del sistema, l’applicazione richiedente deve prima ottenere una API_key<\/strong> per conto dell’utente web del sistema. <\/p>\n I clienti possono ottenere una chiave API solo contattando direttamente il supporto tecnico dei loro fornitori di servizi. La chiave API \u00e8 composta da lettere, numeri e simboli generati in modo casuale. <\/p>\n Esempio di richiesta che utilizza una API_key:<\/p>\n Se la chiave API_ \u00e8 scaduta, rimossa o semplicemente disabilitata, il sistema restituir\u00e0 la seguente risposta:<\/p>\n Gli endpoint API, i parametri di richiesta e le risposte possono essere visualizzati in anteprima in “Swagger” attraverso questo link: https:\/\/api.fm-track.com<\/a><\/p>\n Nota Importante! La soluzione API viene costantemente aggiornata, migliorata e modificata in altro modo, pertanto \u00e8 necessario capire cosa significa “Compatibilit\u00e0” e come influisce sull’utente quando utilizza la soluzione API.<\/p>\n Quando un’API viene aggiornata, si verifica una delle due opzioni seguenti:<\/p>\n Cosa si intende per versione API retrocompatibile:<\/p>\n <\/p>\n L’API (interfaccia di programmazione delle applicazioni) consente ai clienti di integrare l’FMS con i loro sistemi, di prelevare e inviare dati su varie entit\u00e0. Il client effettua richieste HTTP al sistema, fornendo informazioni sull’azione prevista. I comandi HTTP vengono solitamente utilizzati in un’API: GET – Leggi la risorsa; POST – Cambia lo stato della risorsa; … Continua a leggere API<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":116,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-14003","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/14003","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\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/comments?post=14003"}],"version-history":[{"count":0,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/14003\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/media?parent=14003"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
\nLimitazioni API<\/h3>\n
\n
\nAutenticazione API<\/h3>\n
![\"\"](\"https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/1.png\")
<\/a><\/p>\n<\/a><\/p>\n
\n\u00c8 sempre necessario specificare una versione API in tutti i tipi di API.<\/p><\/p>\n
\nA causa del costante sviluppo sia dell’API che del sistema da cui richiede le informazioni, gli utenti possono talvolta ricevere parametri non elencati nelle descrizioni. Si raccomanda di ignorare semplicemente i parametri sconosciuti che non sono documentati nella descrizione di ciascuna API. <\/p><\/p>\n
\nVersioni e compatibilit\u00e0<\/h3>\n
\n
\n
\nL’utente pu\u00f2 tranquillamente supporre che gli ID degli oggetti generati dal sistema non superino mai i 255 caratteri, ma deve essere in grado di gestire ID con una lunghezza potenziale di 255 caratteri. Ad esempio, se l’utente utilizza MySQL, gli ID devono essere memorizzati in una colonna VARCHAR(255) COLLATE utf8_bin (la configurazione COLLATE garantisce la sensibilit\u00e0 alle maiuscole e minuscole nelle ricerche). <\/li>\n
\n