{"id":6076,"date":"2026-05-03T12:31:51","date_gmt":"2026-05-03T11:31:51","guid":{"rendered":"https:\/\/www.atlantisevo.com\/doc\/manuale\/utlita\/amministrazione\/web-api\/gestione-connessione-api\/"},"modified":"2026-09-14T10:16:43","modified_gmt":"2026-09-14T09:16:43","slug":"gestione-connessione-api","status":"publish","type":"manual_documentation","link":"https:\/\/www.atlantisevo.com\/doc\/manuale\/utilita\/amministrazione\/web-api\/gestione-connessione-api\/","title":{"rendered":"Gestione connessione API"},"content":{"rendered":"<div id=\"toctoc\"><\/div><div id=\"toctoc\"><\/div>\n<p>La maschera <strong>Gestione connessione API<\/strong> mostra se Atlantis Evo \u00e8 collegato al server di appoggio delle Web API e permette di <strong>avviare, riavviare e fermare<\/strong> il collegamento. Da quel collegamento passano l\u2019<a href=\"\/manuale\/app-mobile\/\">App Mobile<\/a>, il pannello POS web, i servizi usati dai plugin WordPress \/ WooCommerce e il server MCP per gli assistenti AI: con il servizio fermo nessuno di questi funziona.<\/p>\n<p>Di norma il servizio parte da solo all\u2019apertura del programma, e questa maschera serve in due casi: <strong>rendere operative le modifiche<\/strong> fatte in <a href=\"\/manuale\/utilita\/amministrazione\/web-api\/amministrazione-web-api\/\">Amministrazione Web API<\/a>, agli utenti o alle password, e <strong>capire perch\u00e9<\/strong> l\u2019App o un assistente AI non rispondono.<\/p>\n<p>Si trova in <strong>Utilit\u00e0 \u2192 Amministrazione \u2192 Web API<\/strong>.<\/p>\n<p><img loading=\"lazy\" class=\"aligncenter wp-image-6077 size-full\" src=\"https:\/\/www.atlantisevo.com\/doc\/wp-content\/uploads\/2026\/05\/immagine.png\" alt=\"\" width=\"383\" height=\"192\" srcset=\"https:\/\/www.atlantisevo.com\/doc\/wp-content\/uploads\/2026\/05\/immagine.png 383w, https:\/\/www.atlantisevo.com\/doc\/wp-content\/uploads\/2026\/05\/immagine-300x150.png 300w\" sizes=\"(max-width: 383px) 100vw, 383px\" title=\"\"><\/p>\n<h4>Cosa fa il servizio<\/h4>\n<p>Il servizio collega al server di appoggio <strong>tutte le configurazioni con il flag Attiva<\/strong> dell\u2019azienda in cui si \u00e8 entrati, una per ogni ID installazione. Al collegamento comunica le impostazioni di ciascuna configurazione, l\u2019elenco degli utenti e degli agenti che possono accedere e i limiti della licenza.<\/p>\n<p>Il servizio vive <strong>dentro Atlantis Evo aperto<\/strong>: chiudendo il programma si ferma. Chiudendo invece la sola maschera Gestione connessione API il servizio <strong>continua a funzionare<\/strong> nello stato in cui si trova.<\/p>\n<p>Parte da solo all\u2019apertura del programma, circa <strong>tre secondi<\/strong> dopo la comparsa della finestra principale, ma solo se l\u2019utente con cui si \u00e8 entrati ha il flag <strong>Avvia Web API<\/strong> in <a href=\"\/manuale\/utilita\/amministrazione\/amministrazione-utenti\/utenti\/\">Amministrazione utenti<\/a>. Per gli altri utenti non parte, a meno di avviarlo da questa maschera.<\/p>\n<h4>Lo stato<\/h4>\n<p>Accanto a <strong>Stato<\/strong> compare una sola icona: il <strong>segno di spunta verde<\/strong> quando almeno una configurazione \u00e8 collegata e riconosciuta dal server, quindi App e assistenti possono lavorare; il <strong>punto esclamativo rosso<\/strong> quando nessuna configurazione \u00e8 pronta a ricevere richieste.<\/p>\n<p>Passando il mouse sull\u2019icona compare il dettaglio:<\/p>\n<table>\n<tbody>\n<tr>\n<td><em>\u201cServizio attivo (N connessione\/i)\u201d<\/em><\/td>\n<td>collegato; N \u00e8 il numero di configurazioni avviate<\/td>\n<\/tr>\n<tr>\n<td><em>\u201cOperazione in corso&#8230;\u201d<\/em><\/td>\n<td>\u00e8 stato premuto Avvia \/ Riavvia o Ferma e l\u2019operazione non \u00e8 ancora terminata<\/td>\n<\/tr>\n<tr>\n<td><em>\u201cServizio avviato, connessione al server non disponibile\u201d<\/em><\/td>\n<td>il servizio \u00e8 acceso ma il server non risponde, o non ha ancora accettato il collegamento. Il programma <strong>sta riprovando da solo<\/strong><\/td>\n<\/tr>\n<tr>\n<td><em>\u201cServizio non attivo\u201d<\/em><\/td>\n<td>il servizio \u00e8 fermo: nessuno lo ha avviato, oppure \u00e8 stato premuto Ferma<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Lo stato si aggiorna da solo <strong>ogni secondo<\/strong> finch\u00e9 la maschera \u00e8 aperta. Dopo Avvia \/ Riavvia \u00e8 normale vedere per qualche istante l\u2019icona rossa: diventa verde solo quando il server ha risposto, un momento dopo la fine dell\u2019avvio.<\/p>\n<p>Il numero indicato nel messaggio conta le configurazioni <strong>avviate<\/strong>, non quelle collegate: con due configurazioni, una collegata e una che sta riprovando, compare comunque \u201c2 connessione\/i\u201d.<\/p>\n<h4>I pulsanti<\/h4>\n<ul>\n<li><strong>Avvia \/ Riavvia<\/strong>: chiude i collegamenti esistenti e li riapre <strong>rileggendo tutto<\/strong>: configurazioni Web API, utenti e password, licenza. Funziona anche se il servizio non era mai partito;<\/li>\n<li><strong>Ferma<\/strong>: chiude tutti i collegamenti e spegne il controllo automatico. App, POS, servizi e assistenti AI smettono di rispondere, e le richieste in corso in quel momento ricevono un errore;<\/li>\n<li><strong>Chiudi<\/strong>: chiude la maschera. Il servizio resta nello stato in cui \u00e8.<\/li>\n<\/ul>\n<p>Mentre un\u2019operazione \u00e8 in corso i due pulsanti sono bloccati. <strong>Ferma<\/strong> \u00e8 disponibile solo con il servizio avviato, anche quando \u00e8 avviato ma scollegato, proprio per poter spegnere un servizio che continua a riprovare. Se il controllo automatico sta riavviando i collegamenti, Ferma attende che abbia finito: pu\u00f2 richiedere qualche secondo.<\/p>\n<h4>Avvia \/ Riavvia nel dettaglio<\/h4>\n<p>Il pulsante usa l\u2019<strong>azienda<\/strong> e l\u2019<strong>utente<\/strong> con cui si \u00e8 entrati in quel momento. Il flag Avvia Web API dell\u2019utente <strong>non serve<\/strong>: chiunque apra la maschera pu\u00f2 avviare il servizio.<\/p>\n<p>Le configurazioni vengono collegate una dopo l\u2019altra. Se il server non risponde, per ciascuna si fanno fino a <strong>5 tentativi<\/strong>, ognuno con un\u2019attesa massima di 25 secondi pi\u00f9 5 secondi di pausa: nel caso peggiore l\u2019operazione dura <strong>oltre due minuti per configurazione<\/strong>, con l\u2019icona su \u201cOperazione in corso&#8230;\u201d. Nel frattempo il programma resta utilizzabile.<\/p>\n<p>I messaggi che possono comparire:<\/p>\n<ul>\n<li><em>\u201cErrore. Impossibile stabilire la connessione dopo 5 tentativi\u201d<\/em>: il server non \u00e8 raggiungibile. Verificare la connessione internet della postazione;<\/li>\n<li><em>\u201cErrore. Servizio WEB Api non eseguibile in modalita\u2019 demo.\u201d<\/em>: il programma \u00e8 in modalit\u00e0 dimostrativa;<\/li>\n<li><em>\u201cErrore. WEB Api non disponibili. Licenza scaduta.\u201d<\/em>: le Web API risultano scadute in licenza.<\/li>\n<\/ul>\n<p>Se nessuna configurazione ha il flag Attiva non compare alcun errore: il servizio risulta avviato ma resta su \u201cServizio avviato, connessione al server non disponibile\u201d.<\/p>\n<p>\u26a0\ufe0f <strong>Dopo un errore di avvio il servizio resta acceso e riprova da solo ogni pochi minuti.<\/strong> Se la causa \u00e8 la modalit\u00e0 demo o la licenza scaduta non si risolver\u00e0 mai: premere <strong>Ferma<\/strong>.<\/p>\n<p>\u26a0\ufe0f <strong>Con pi\u00f9 configurazioni attive, una che non si collega blocca quelle successive.<\/strong> L\u2019avvio si interrompe alla prima configurazione che non riesce a collegarsi, e il controllo automatico interviene solo quando <strong>nessuna<\/strong> configurazione \u00e8 collegata: se la prima \u00e8 collegata e la seconda no, la seconda resta ferma finch\u00e9 non si preme Avvia \/ Riavvia. Tenere spente (flag Attiva) le configurazioni non utilizzate.<\/p>\n<h4>Cosa succede quando il collegamento cade<\/h4>\n<p>Una volta avviato, il servizio si occupa da solo di restare collegato, su due livelli.<\/p>\n<p><strong>Riconnessione immediata.<\/strong> Se il collegamento cade (rete assente, server riavviato, computer in sospensione) ogni configurazione riprova da sola: il primo tentativo dopo <strong>5 secondi<\/strong>, poi con attese che raddoppiano fino a <strong>un minuto<\/strong>, senza limite di tentativi. Il programma riconosce anche i collegamenti \u201cmorti\u201d che sembrano aperti: ogni 25 secondi manda un segnale al server e, se non riceve risposta, chiude e riapre. Se il server <strong>rifiuta le credenziali<\/strong> dell\u2019installazione, il nuovo tentativo avviene dopo pi\u00f9 tempo.<\/p>\n<p><strong>Controllo automatico.<\/strong> Ogni <strong>minuto<\/strong> il servizio verifica se almeno una configurazione \u00e8 collegata. Dopo <strong>tre controlli consecutivi<\/strong> negativi, circa tre minuti, chiude tutto e riavvia da zero, esattamente come Avvia \/ Riavvia: rilegge configurazioni, utenti e licenza. Il controllo continua finch\u00e9 qualcuno non preme Ferma o chiude il programma.<\/p>\n<p>Il controllo automatico parte anche se l\u2019avvio all\u2019apertura del programma fallisce, per esempio perch\u00e9 la connessione internet non \u00e8 ancora disponibile: appena la rete torna il servizio si collega senza bisogno di intervenire.<\/p>\n<p>Tutto questo avviene <strong>senza messaggi a video<\/strong>: i tentativi vengono registrati solo nel file di log. Questa maschera \u00e8 l\u2019unico posto in cui vederne l\u2019effetto.<\/p>\n<h4>Quando usarla<\/h4>\n<p><strong>Dopo una modifica in Amministrazione Web API, a un utente o a una password.<\/strong> Le impostazioni vengono lette solo al collegamento: salvare, aprire Gestione connessione API, premere <strong>Avvia \/ Riavvia<\/strong> e attendere l\u2019icona verde.<\/p>\n<p><strong>L\u2019App o l\u2019assistente AI segnalano il servizio non disponibile.<\/strong><\/p>\n<ol>\n<li>Aprire la maschera sulla postazione che tiene aperto Atlantis Evo con le Web API.<\/li>\n<li>Se lo stato \u00e8 \u201cServizio non attivo\u201d, premere <strong>Avvia \/ Riavvia<\/strong>.<\/li>\n<li>Se lo stato \u00e8 \u201cServizio avviato, connessione al server non disponibile\u201d, il programma sta gi\u00e0 riprovando. Verificare la connessione internet; se la rete funziona, attendere qualche minuto oppure premere Avvia \/ Riavvia per vedere l\u2019eventuale messaggio di errore.<\/li>\n<li>Se l\u2019icona \u00e8 verde ma l\u2019App non entra, il problema non \u00e8 il collegamento ma le credenziali o la configurazione (livello di complessit\u00e0 password, flag Attiva, flag Server MCP): vedi <a href=\"\/manuale\/utilita\/amministrazione\/web-api\/amministrazione-web-api\/\">Amministrazione Web API<\/a>.<\/li>\n<\/ol>\n<p><strong>Sospendere temporaneamente l\u2019accesso esterno.<\/strong> Ferma blocca subito App, POS, servizi e assistenti AI; per riattivarli si preme Avvia \/ Riavvia. Chiudendo e riaprendo il programma, per\u00f2, il servizio riparte da solo per l\u2019utente con il flag Avvia Web API.<\/p>\n<h4>Promemoria<\/h4>\n<ul>\n<li>Il servizio va tenuto acceso su <strong>una sola postazione<\/strong>. Se la stessa installazione viene collegata da due computer, ciascuno scollega l\u2019altro e l\u2019App funziona a intermittenza.<\/li>\n<li>Chiudere la maschera non ferma il servizio; chiudere Atlantis Evo s\u00ec.<\/li>\n<li>Dopo ogni modifica alle configurazioni Web API, agli utenti o alle password: <strong>Avvia \/ Riavvia<\/strong>.<\/li>\n<li>Avvia \/ Riavvia collega le configurazioni dell\u2019azienda <strong>in cui si \u00e8 entrati in quel momento<\/strong>.<\/li>\n<li>L\u2019icona rossa subito dopo l\u2019avvio \u00e8 normale: attendere qualche secondo prima di concludere che non funziona.<\/li>\n<li>Con il servizio avviato ma scollegato il programma riprova da solo, senza messaggi: in modalit\u00e0 demo o con licenza scaduta non ci riuscir\u00e0 mai, quindi va fermato.<\/li>\n<li>Con pi\u00f9 configurazioni attive, una che non si collega blocca quelle successive: tenere spente quelle non utilizzate.<\/li>\n<\/ul>\n","protected":false},"author":1,"featured_media":0,"parent":6074,"menu_order":17,"template":"","manualdocumentationcategory":[55],"manual_doc_tag":[],"_links":{"self":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/6076"}],"collection":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation"}],"about":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/types\/manual_documentation"}],"author":[{"embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":4,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/6076\/revisions"}],"predecessor-version":[{"id":6452,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/6076\/revisions\/6452"}],"up":[{"embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/6074"}],"wp:attachment":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/media?parent=6076"}],"wp:term":[{"taxonomy":"manualdocumentationcategory","embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manualdocumentationcategory?post=6076"},{"taxonomy":"manual_doc_tag","embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_doc_tag?post=6076"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}