Strumenti Utente

Strumenti Sito


apireference:manifesto_microservizio

Questa è una vecchia versione del documento!


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:

  • codice identificativo
  • nome mnemonico

le stesse potranno essere estese in futuro per fornire funzioni di aggregazione/abilitazione automatica, quali, ad esempio: icona, colore, scope (gruppo, capability o progetto).

Esempio:

{“code”:“pim”,“name”:{“it”:“Gestione delle informazioni dei prodotti”,“en”:“Product Information Management”}}

o (di seguito: ogni “nome mnemonico” potrà essere rappresentato come stringa o come oggetto che includa un set di codici di locale (1+) con la stringa equivalente, i codici di locale saranno delle stringhe di 2 caratteri, e rappresenteranno il Set 1 dello standard ISO 639 (ISO639) (Language Codes), quindi limitativi alla rappresentazione di una lingua più che di una cultura o provenienza geografica, la cui inclusione sarà oggetto di valutazioni successive)

{“code”:“pim”,“name”:“Product Information Management”}

Configurazione del Microservizio

Fornirà al client informazioni utili per utilizzare correttamente per le api quali:

  • numero massimo di risultati in ricerca
  • numero massimo di elementi creabili
  • numero massimo di elementi caricabili
  • numero massimo di elementi salvabili
  • numero massimo di elementi in una relazione multipla
  • tempo di riciclo degli oggetti non committati (in millisecondi)
  • locale supportati
  • tempo massimo di vita degli oggetti non committati
  • periodicità di verifica dellifetime degli oggetti
  • tempo massimo di vita degli oggetti cancellati
  • dimensione massima di una richiesta json (attenzione: questo limite viene applicato anche alla chiamata di restore)

Le stesse potranno essere estese da configurazioni specifiche per microservizio (ad esempio: dimensione massima di un chunk di upload )

Il client non potrà fare assunzioni sul valore delle stesse che sarà oggetto di tuning microservizio per microservizio (ad esempio un microservizio potrà consentire di caricare 1000 oggetti per volta, un altro solo di 10 per ragioni tecniche/di performance/di sicurezza)

apireference/manifesto_microservizio.1712581159.txt.gz · Ultima modifica: 2024/04/08 12:59 da marcomerlino