• Passa alla navigazione primaria
  • Passa al contenuto principale
  • Passa alla barra laterale primaria
  • Passa al piè di pagina
Glue Labs

Glue Labs

Trasformiamo le tue idee in prodotti digitali di successo!

  • HOME
  • SOLUZIONI
  • NEWS
  • PRODOTTI
  • CONTATTI
  • CASE STUDY

Come progettare le API

URL, naming convention, versioning, SEO per le API

Le Application Programming Interface (API) rappresentano il modo in cui i software comunicano tra di essi. Di fatto astraggono la complessità del sistema sottostante e permettono la fruizione di servizi complessi in maniera semplice. Grazie a questa qualità, le API sono diventate l’ingrediente principale di qualsiasi applicazione moderna.

Il primo aspetto importante da valutare nella progettazione delle API è lo scopo per cui vengono realizzate e ne esistono due:

  1. per la integration: in questo caso le API sono realizzate per un progetto specifico e solo per l’integrazione senza alcuna possibilità di utilizzo ( o riutilizzo) esterno e futuro. E’ un approccio classico che oggi è poco saggio in quanto limita fortemente qualsiasi opportunità di sviluppo futuro.
  2. per la consumption: in questo caso, invece, le API sono realizzate in maniera modulare, scalabile e fornendo il riutilizzo delle funzionalità, di fatto permettendo di creare continuamente nuove esperienze grazie alla possibilità di effettuare il mix di API consumabili. E’ l’approccio moderno e che trovate usato da tantissimi provider, per es. Cloud API.

La scelta dipende dal progetto, dalle necessità di business e da molti altri aspetti ma, in linea di principio, occorre sempre orientarsi verso API consumabili perchè guardano al futuro. Contattaci subito e senza impegno per realizzare API.

Le strategie per la progettazione: REST, RPC e GraphQL

I modelli citati nel titolo sono quelli più usati e che hanno i loro pro ed i loro contro per ogni progetto. E’ necessaria un’analisi puntuale delle necessità di business per fare la scelta giusta e rimandiamo ad un futuro articolo la disamina dei casi, per il momento ti indichiamo che la strategia REST è quella che può essere ideale nella gran parte dei casi e che viene utilizzata da tutti i maggiori provider di API ed in qualsiasi scenario moderno di Web Service. Puoi approfondire GraphQL con un nostro articolo e REST e RPC in un articolo del Blog di Google. Contattaci subito e senza impegno per una consulenza.

Best Practises

Vi indichiamo di seguito alcune best practise da seguire nella progettazione di API:

  • Definire le relazioni con link e non con chiavi: le API spesso raccontano relazioni e spesso rappresentano il mezzo per esporre campi di un database e relazioni tra i vari campi ed entità, il primo aspetto da considerare è quello di esprimere queste relazioni tramite Web Link. Per un approfondimento vi consigliamo la seguente lettura.
  • Definire le URL in maniera che il mix di nomi e identificativi sia corretto e guardi al futuro, in particolare occorre pensare a quali dati potrebbero cambiare nel tempo e quindi non renderli permanenti nell’URL ma variabili tramite opportune costruzioni. Per un approfondimento vi consigliamo la seguente lettura.
  • Stabilire il versioning: le API sono veri e propri software che seguono processi di sviluppo e miglioramento che possono far si di rendere disponibili nuove versioni della medesima API. Occorre quindi definire le modalità di versioning (nell’URL? nell’Header?nei Data?) o anche di “non versioning”, vale a dire di non far inserire la versione nella richiesta. Stabilire il versioning è spesso una cosa che si rimanda o che non si valuta nelle fasi iniziali della progettazione delle API ed invece è decisamente importante. Per un approfondimento vi consigliamo la seguente lettura.
  • Risolvere gli eventuali problemi SEO: soprattutto nelle Single Page App (SPA) è necessario rendere fruibili i contenuti ai motori di ricerca ed ottimizzare le API per il SEO diventa essenziale. Per un approfondimento vi consigliamo la seguente lettura.

Contattaci subito e senza impegno per una consulenza sulla progettazione di API.

Glue Labs e le API

Realizziamo API dalla nostra nascita e grazie alle competenze specialistiche maturate in tantissimi settori e con numerosi Clienti possiamo fornirti assistenza e supporto per portare in produzione qualsiasi API. Inoltre ti forniamo formazione avanzata sulla progettazione e realizzazione di API.  Contattaci subito senza impegno per maggiori informazioni.

Continua la lettura

  1. Cos’è un Mock Server e perchè usarlo

Categoria: Articoli Tags: API, Cloud API, GraphQL, RCP, REST

Barra laterale primaria

Cosa facciamo

  • Content Strategy
  • E-Commerce
  • Formazione avanzata Web, Mobile & Cloud
  • IoT – Sviluppo e Integrazione
  • Micro Live Learning(MLL) Web, Mobile & Cloud
  • Project Management Prince2
  • PushAPE
  • Sicurezza ICT
  • Software Aziendali
  • Sviluppo Mobile App
  • Sviluppo, Supporto, Assistenza Tecnica e Hosting Google Cloud
  • System Integration
  • Web Application
  • Web Design

Contatti

Scrivici dal form di contatto

Tel +39 06 56549766
Fax +39 06 21122581
Mail: info@glue-labs.com
Pec: gluelabs@legalmail.it

Dove siamo

Roma: Piazza Don Sturzo 15
Milano: Via Lazzaretto 19
Torino: Via San Domenico 28
Altamura: Via Maggio 1648 24

"*" indica i campi obbligatori

Nome*
Questo sito è protetto da reCAPTCHA e si applicano le Normative sulla Privacy e i Termini di Servizio di Google.
Inviando i tuoi dati accetti le condizioni sulla Privacy. Li useremo per rispondere alle tue domande e richieste.
Consenso*
Questo campo serve per la convalida e dovrebbe essere lasciato inalterato.

Siamo parte di

La nostra Agenzia di Marketing

Footer

Partnership



Rimaniamo in contatto

Iscriviti alla nostra newsletter

Nome
Questo campo serve per la convalida e dovrebbe essere lasciato inalterato.

Soluzioni

  • Revisione, validazione, attestazione e Relazione Tecnica su Ricerca & Sviluppo e Innovazione Tecnologica
  • Migrazione da ASP.NET Web Forms e Visual Basic ad Angular Web Application
  • Corso Angular 15
  • Supporto ed Integrazione di SPID e CIE con OpenID Connect
  • Consulenza e Assessment pre-formazione
  • Integrazione con le API di OpenAI e ChatGPT
  • Corso Firebase
  • Corso Cucumber per Javascript
  • Supporto ed Assistenza nell’implementazione ed utilizzo dei Kit di Designers Italia
  • Realizzazione di Tour Virtuali 3D

Articoli

  • Le 4 metriche principali delle Performance del DevOps
  • Come trasformare una Web Application in una Mobile App: Capacitor di Ionic
  • Moodle per essere compliant con gli obblighi formativi in ambito sicurezza sul lavoro
  • Perchè adottare il modello One Concern(o Application) One Container
  • Perchè utilizzare la WebAR
  • Le 3 ragioni per implementare un chatbot nella tua azienda
  • I 5 fattori che impattano sulla reliability delle applicazioni
  • Le 10 innovazioni che modificheranno i servizi IT nel 2023
  • DevSusOps: sviluppare per la sostenibilità del software e delle architetture IT
  • Cos’è la Communications Platform as a Service(CPaaS) e perchè utilizzarla

Le nostre sedi

  • Roma, Piazza Don Sturzo 15
  • Milano, Via Lazzaretto 19
  • Torino, Via San Domenico 28
  • Altamura, Via Maggio 1648 24

Contatti

  • Tel. +39 06 87811067
  • Fax +39 06 99335373
  • glue-labs@legalmail.it
  • info@glue-labs.com
  • Facebook
  • LinkedIn
  • Twitter

Scarica app da App StoreScarica app da Play Store


Glue Labs © 2011–2023 | Copyright | Privacy Policy | Company Info | Cookie Policy | Gestione Cookies

Gestisci Consenso Cookie
Usiamo cookie per ottimizzare il nostro sito web ed i nostri servizi.
Funzionale Sempre attivo
La conservazione tecnica o l'accesso sono strettamente necessari al fine legittimo di consentire la fruizione di uno specifico servizio esplicitamente richiesto dall'abbonato o dall'utente, o al solo fine di effettuare la trasmissione di una comunicazione su una rete di comunicazione elettronica.
Preferenze
The technical storage or access is necessary for the legitimate purpose of storing preferences that are not requested by the subscriber or user.
Statistiche
L'archiviazione tecnica o l'accesso che viene utilizzato esclusivamente a fini statistici anonimi. Senza un mandato di comparizione, il rispetto volontario da parte del tuo provider di servizi Internet o registrazioni aggiuntive da parte di terzi, le informazioni archiviate o recuperate solo per questo scopo non possono essere generalmente utilizzate per identificarti. The technical storage or access that is used exclusively for anonymous statistical purposes. Without a subpoena, voluntary compliance on the part of your Internet Service Provider, or additional records from a third party, information stored or retrieved for this purpose alone cannot usually be used to identify you.
Marketing
L'archiviazione tecnica o l'accesso è necessario per creare profili utente per inviare pubblicità o per tracciare l'utente su un sito Web o su più siti Web per scopi di marketing simili.
Gestisci opzioni Gestisci servizi Gestisci fornitori Per saperne di più su questi scopi
Gestisci preferenze
{title} {title} {title}