{"id":7467,"date":"2024-03-14T10:42:47","date_gmt":"2024-03-14T09:42:47","guid":{"rendered":"https:\/\/kb.apptec360.com\/manual\/knowledgebase\/impostazioni-generali\/accesso-basato-sui-ruoli\/accesso-api\/regole-generali\/"},"modified":"2024-12-04T05:38:08","modified_gmt":"2024-12-04T04:38:08","slug":"regole-generali","status":"publish","type":"knowledgebase","link":"https:\/\/kb.apptec360.com\/manual\/it\/knowledgebase\/impostazioni-generali\/accesso-basato-sui-ruoli\/accesso-api\/regole-generali\/","title":{"rendered":"Regole generali"},"content":{"rendered":"\n<ul class=\"wp-block-list\">\n<li>L&#8217;API REST \u00e8 disponibile sotto l&#8217;URL di base:<\/li>\n<\/ul>\n\n<p>\/public\/external\/api<\/p>\n\n<ul class=\"wp-block-list\">\n<li>Tutte le richieste devono essere inviate tramite POST.  <\/li>\n\n\n\n<li>L&#8217;API REST supporta solo le richieste via HTTPS.  <\/li>\n\n\n\n<li>Le richieste devono contenere le seguenti intestazioni:<\/li>\n<\/ul>\n\n<table id=\"tablepress-6\" class=\"tablepress tablepress-id-6\">\n<caption style=\"caption-side:bottom;text-align:left;border:none;background:none;margin:0;padding:0;\"><a href=\"https:\/\/kb.apptec360.com\/manual\/wp-admin\/admin.php?page=tablepress&#038;action=edit&#038;table_id=6\" rel=\"nofollow\">Modifica<\/a><\/caption>\n<tbody class=\"row-hover\">\n<tr class=\"row-1 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Nome dell&#8217;intestazione<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Valore dell&#8217;intestazione<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Descrizione<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-2 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>Tipo di contenuto<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>applicazione\/json<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>fisso<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-3 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>auth<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>123&#8230;xyz<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Chiave API dalla scheda &#8220;Accesso API<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-4 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>firma<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Firma codificata in base64<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Firma del payload generato con il metodo<\/p><br\/>\n        <p>chiave privata dalla scheda &#8220;Accesso API<\/p><br\/>\n      <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<ul class=\"wp-block-list\">\n<li>Il corpo della richiesta deve essere un oggetto codificato json che deve contenere i seguenti valori:<\/li>\n<\/ul>\n\n<div class=\"pagebreak-after\"><\/div>\n\n<table id=\"tablepress-7\" class=\"tablepress tablepress-id-7\">\n<caption style=\"caption-side:bottom;text-align:left;border:none;background:none;margin:0;padding:0;\"><a href=\"https:\/\/kb.apptec360.com\/manual\/wp-admin\/admin.php?page=tablepress&#038;action=edit&#038;table_id=7\" rel=\"nofollow\">Modifica<\/a><\/caption>\n<tbody class=\"row-hover\">\n<tr class=\"row-1 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Campo<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Campo Esempio Valore<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Descrizione<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-2 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>api<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>v2\/dispositivo\/elenco dispositivi<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Nome dell&#8217;API<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-3 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>tempo<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>1529662725<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Timestamp Unix (UTC) del computer client.<\/p><br\/>\n        <p>La differenza di tempo massima consentita<\/p><br\/>\n        <p>tra il client e il server \u00e8 di 30<\/p><br\/>\n        <p>minuti.<\/p><br\/>\n      <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<ul class=\"wp-block-list\">\n<li>In caso di successo, l&#8217;API restituisce i dati richiesti (vedi le Query di seguito) e un codice di stato HTTP 200.<\/li>\n\n\n\n<li>Se si verifica un errore, il codice di stato HTTP sar\u00e0 compreso tra 4xx e 5xx a seconda dell&#8217;errore e l&#8217;oggetto risposta conterr\u00e0 un array con la chiave &#8220;errors&#8221;, che contiene un elenco di messaggi di errore leggibili dall&#8217;uomo.<\/li>\n\n\n\n<li>Se non ci sono dati corrispondenti per un dispositivo, verr\u00e0 restituito un array vuoto.<\/li>\n\n\n\n<li>Se l&#8217;Id di un dispositivo non esiste, i dati restituiti saranno nulli.<\/li>\n<\/ul>\n","protected":false},"parent":7459,"menu_order":0,"template":"","class_list":["post-7467","knowledgebase","type-knowledgebase","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/kb.apptec360.com\/manual\/it\/wp-json\/wp\/v2\/knowledgebase\/7467","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kb.apptec360.com\/manual\/it\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/kb.apptec360.com\/manual\/it\/wp-json\/wp\/v2\/types\/knowledgebase"}],"version-history":[{"count":1,"href":"https:\/\/kb.apptec360.com\/manual\/it\/wp-json\/wp\/v2\/knowledgebase\/7467\/revisions"}],"predecessor-version":[{"id":7468,"href":"https:\/\/kb.apptec360.com\/manual\/it\/wp-json\/wp\/v2\/knowledgebase\/7467\/revisions\/7468"}],"up":[{"embeddable":true,"href":"https:\/\/kb.apptec360.com\/manual\/it\/wp-json\/wp\/v2\/knowledgebase\/7459"}],"wp:attachment":[{"href":"https:\/\/kb.apptec360.com\/manual\/it\/wp-json\/wp\/v2\/media?parent=7467"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}