L'API OptiSigns è organizzata attorno a GraphQL. GraphQL è un linguaggio di query per API, fornisce una descrizione completa e comprensibile dei dati nell'API, dà ai client il potere di chiedere esattamente ciò di cui hanno bisogno e nulla di più, rende più facile far evolvere le API nel tempo e abilita potenti strumenti per sviluppatori.
Perché GraphQL
Un solo endpoint API
Le API GraphQL sono organizzate in termini di tipi e campi, non di endpoint. Accedi alle capacità complete dei tuoi dati da un singolo endpoint. GraphQL usa i tipi per garantire che le app chiedano solo ciò che è possibile e fornisce errori chiari e utili. Le app possono utilizzare i tipi per evitare di scrivere codice di parsing manuale.
Ottieni molte risorse in una singola richiesta
Le query GraphQL accedono non solo alle proprietà di una risorsa ma seguono anche fluidamente i riferimenti tra di esse. Mentre le tipiche API REST richiedono il caricamento da più URL, le API GraphQL ottengono tutti i dati di cui la tua app ha bisogno in una singola richiesta. Le app che utilizzano GraphQL possono essere veloci anche su connessioni di rete mobile lente.
Nessun over-fetching e under-fetching
Invia una query GraphQL alla tua API e ottieni esattamente ciò di cui hai bisogno, niente di più e niente di meno. Le query GraphQL restituiscono sempre risultati prevedibili. Le app che utilizzano GraphQL sono veloci e stabili perché controllano i dati che ricevono, non il server.
Nessun versionamento
Nuovi campi e tipi possono essere aggiunti all'API GraphQL senza impattare le query esistenti. I campi obsoleti possono essere deprecati e nascosti dagli strumenti. Utilizzando una singola versione in evoluzione, le API GraphQL forniscono alle app accesso continuo a nuove funzionalità e incoraggiano un codice server più pulito e manutenibile.
Endpoint API OptiSigns
L'API GraphQL è accessibile utilizzando l'endpoint.
https://graphql-gateway.optisigns.com
Offriamo anche un IDE GraphQL basato su web per accedere alla nostra API.
https://graphql-gateway.optisigns.com/graphql
Articolo successivo - Generare e gestire la chiave API