https://apireference.neosidea.com/ 2026-06-05T04:09:40+00:00 https://apireference.neosidea.com/ https://apireference.neosidea.com/lib/exe/fetch.php?media=wiki:dokuwiki.svg text/html 2024-04-08T14:38:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:api&rev=1712587101&do=diff Sommario API Di seguito esemplificheremo le api di base Creazione oggetti Questa api consentirà di richiedere al backend la generazione di un determinato numero di oggetti di un determinato modello (fino a un massimo di “create_max”). Gli oggetti saranno tutti creati in stato text/html 2024-04-11T09:52:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:bibliografia&rev=1712829147&do=diff Sommario Bibliografia ECMA-262. (s.d.). <https://262.ecma>international.org/14.0/?_gl=1*c8wn2m*_ga*MTE4NDYyOTA3NC4xNzEwMTQ5Mjk4*_ga_TDCK4 DWEPP*MTcxMDE0OTI5OC4xLjAuMTcxMDE0OTI5OC4wLjAuMA..#sec-number.epsilon. InnoDB limits. (s.d.). <https://dev.mysql.com/doc/refman/8.0/en/innodb-limits.html>. ISO639. (s.d.). <https://www.iso.org/standard/74575.html>. JSONPath. (s.d.). text/html 2024-04-22T14:04:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:campi_base&rev=1713794698&do=diff Sommario Campi base Tutti gli oggetti di tutti i microservizi dovranno avere un set minimo di campi base, di seguito descritto, dove non diversamente descritto non sono manipolabili da nessun client: uuid: campo di tipo uuid, con modello equivalente al modello stesso (es: text/html 2024-04-22T14:03:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:changelog&rev=1713794595&do=diff Sommario 11/03/2024 1.0 Gabriele Messineo Prima versione 19/03/2024 1.0.1 Gabriele Messineo Aggiunte utilità di ricerca per UI 27/03/2024 1.0.2 Gabriele Messineo Sistemato il grant, aggiunte variabili di configurazione, aggiunti suggerimenti per UI text/html 2024-04-08T15:04:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:codici_errore&rev=1712588672&do=diff Sommario Codici di errore Di seguito una tabella di referenza degli errori previsti: Categorie: E0: errori interni tipo 500 E1: errori nella richiesta E2: errori di permessi ---------- Chiamata Codice Campo Descrizione * E001 - Repository non disponibile text/html 2024-04-08T12:49:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:consistenza&rev=1712580560&do=diff Sommario Consistenza Il modello d'uso previsto è compatibile con dei repository consistenti o eventualmente consistenti (con delle limitazioni). E' fuori dallo scopo di questa api lo studio di una verifica di consistenza, ad esempio, a blockchain, o un sistema di verifica dei job sulla base dell'impatto. text/html 2024-04-08T09:54:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:definizioni&rev=1712570098&do=diff Sommario Definizioni Microservizio: un'applicazione server side black box con un API HTTPS. Attore: un client del microservizio, può essere: un Aggregatore, un altro Servizio, una Interfaccia UI Modello: entità di definizione dati Campo: proprietà di un modello text/html 2024-04-08T15:28:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:esempi_uso&rev=1712590094&do=diff Sommario Esempi di uso Caricamento del Manifest const axios=require('axios'); let response=await axios.get('<https://pim.neosidea.com/api/manifest.json>'); if(typeof(response.data['error'])=='undefined' && typeof(response.data['error']['code'])=='undefined');else{alert(response.data.error.description);return;} let manifest=response.data; console.log('Caricato il microservizio: '+manifest.code); text/html 2024-04-08T12:21:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:espressioni_di_ricerca&rev=1712578909&do=diff Sommario Espressioni di ricerca Un'espressione di ricerca consente la definizione di un atom di ricerca e di combinarlo ad altri per personalizzare l'estrazione dati. Le stesse sono codificate in JSON come oggetto con una proprietà funzione che ne definisce gli altri parametri. text/html 2024-04-11T09:55:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:formati_e_protocolli&rev=1712829350&do=diff Sommario Formati e Protocolli L'interfaccia impiegherà diversi protocolli standard per la comunicazione, in particolare: * ogni comunicazione di produzione avverrà attraverso canale confidenziale e autenticato tipo https o http2 (h2) * i messaggi saranno codificati in JSON (RFC8259, JSON) text/html 2024-04-08T12:52:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:interfaccia&rev=1712580757&do=diff Sommario Interfaccia L'interfaccia delle api fornirà le seguenti chiamate: In generale: * Manifesto del microservizio * Backup * Ripristino Per ogni modello: * Creazione oggetti * Caricamento dati * Salvataggio dati * Ricerca dati * Backup text/html 2024-04-08T09:54:30+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:introduzione&rev=1712570070&do=diff Sommario Introduzione Il presente documento andrà a indicare l'interfaccia di comunicazione che i microservizi offriranno esternamente. text/html 2024-04-08T12:44:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:lifecycle_oggetto&rev=1712580267&do=diff Sommario Lifecycle di un oggetto Un oggetto può assumere uno dei seguenti stati: GENERATO ATTIVO CANCELLATO Solo gli oggetti in stato “ATTIVO” sono ricercabili da api Gli oggetti in stato “ATTIVO” o “GENERATO” sono caricabili e salvabili da text/html 2024-04-22T14:08:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:manifesto_microservizio&rev=1713794919&do=diff Sommario Manifesto del microservizio Questa api potrà essere pubblicata a qualsiasi url, sarà richiamabile in GET e fornirà al client le seguenti informazioni: * Elenco puntatoDefinizione del microservizio Fornirà al cliente informazioni per identificare il microservizio quali: text/html 2024-04-22T14:02:07+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:microservizi_di_sistema&rev=1713794527&do=diff Sommario Microservizi di sistema Per funzionare il sistema avrà bisogno dei seguenti microservizi “di bootstrap”, gli stessi non sono necessari a un funzionamento di base, ma serviranno per un utilizzo completo: Microservizio AAA (Authentication, Authorization, Accounting) text/html 2024-04-08T09:55:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:sicurezza&rev=1712570135&do=diff Sommario Sicurezza Il microservizio di autenticazione fornirà un'api di verifica dei token, che consentirà di: * verificare l'identità del possessore dello stesso * verificare le capabilities associate allo stesso Ogni microservizio in produzione integrerà dei controlli di sicurezza CORS che limitino i verbi HTTP a quelli implementati, più quello di preflight, limiteranno l'utilizzo degli header, e limiteranno l'origine delle richieste allo stesso dominio. Per chiamare un microservizio… text/html 2024-04-08T10:41:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://apireference.neosidea.com/doku.php?id=apireference:struttura&rev=1712572869&do=diff Sommario Struttura Ogni microservizio esporrà una struttura di Modelli e di campi, e una serie di chiamate per interagire con gli stessi. La struttura degli stessi è monodimensionale e limitata per accomodare esigenze tecniche di encoding, di funzionamento interno, di performance, e di portabilità.