A API OptiSigns é organizada em torno do GraphQL. GraphQL é uma linguagem de consulta para API, fornece uma descrição completa e compreensível dos dados na API, dá aos clientes o poder de solicitar exatamente o que precisam e nada mais, torna mais fácil evoluir APIs ao longo do tempo e permite ferramentas de desenvolvimento poderosas.
Por que GraphQL
Apenas um endpoint de API
As APIs GraphQL são organizadas em termos de tipos e campos, não endpoints. Acesse todas as capacidades dos seus dados a partir de um único endpoint. O GraphQL usa tipos para garantir que as aplicações solicitem apenas o que é possível e forneça erros claros e úteis. As aplicações podem usar tipos para evitar escrever código de análise manual.
Obter muitos recursos numa única solicitação
As consultas GraphQL acedem não apenas às propriedades de um recurso, mas também seguem suavemente as referências entre eles. Enquanto as APIs REST típicas requerem carregamento de múltiplos URLs, as APIs GraphQL obtêm todos os dados que a sua aplicação precisa numa única solicitação. As aplicações que usam GraphQL podem ser rápidas mesmo em conexões de rede móvel lentas.
Sem busca excessiva e busca insuficiente
Envie uma consulta GraphQL para a sua API e obtenha exatamente o que precisa, nada mais e nada menos. As consultas GraphQL sempre retornam resultados previsíveis. As aplicações que usam GraphQL são rápidas e estáveis porque controlam os dados que obtêm, não o servidor.
Sem versionamento
Novos campos e tipos podem ser adicionados à API GraphQL sem impactar as consultas existentes. Campos antigos podem ser descontinuados e ocultados das ferramentas. Ao usar uma única versão em evolução, as APIs GraphQL dão às aplicações acesso contínuo a novos recursos e incentivam código de servidor mais limpo e fácil de manter.
Endpoint da API OptiSigns
A API GraphQL pode ser acedida usando o endpoint.
https://graphql-gateway.optisigns.com
Também oferecemos um IDE GraphQL baseado na web para aceder à nossa API.
https://graphql-gateway.optisigns.com/graphql
Próximo Artigo - Gerar e Gerir Chave de API