La API de OptiSigns está organizada alrededor de GraphQL. GraphQL es un lenguaje de consulta para API, proporciona una descripción completa y comprensible de los datos en la API, otorga a los clientes el poder de solicitar exactamente lo que necesitan y nada más, facilita la evolución de las API con el tiempo y habilita potentes herramientas para desarrolladores.
Por qué GraphQL
Solo un punto de acceso de API
Las API de GraphQL están organizadas en términos de tipos y campos, no de puntos de acceso. Accede a todas las capacidades de tus datos desde un único punto de acceso. GraphQL utiliza tipos para garantizar que las aplicaciones solo soliciten lo que es posible y proporciona errores claros y útiles. Las aplicaciones pueden usar tipos para evitar escribir código de análisis manual.
Obtén muchos recursos en una sola solicitud
Las consultas de GraphQL acceden no solo a las propiedades de un recurso, sino que también siguen sin problemas las referencias entre ellos. Mientras que las API REST típicas requieren cargar desde múltiples URL, las API de GraphQL obtienen todos los datos que tu aplicación necesita en una sola solicitud. Las aplicaciones que usan GraphQL pueden ser rápidas incluso en conexiones de red móvil lentas.
Sin exceso ni falta de datos
Envía una consulta GraphQL a tu API y obtén exactamente lo que necesitas, nada más y nada menos. Las consultas de GraphQL siempre devuelven resultados predecibles. Las aplicaciones que usan GraphQL son rápidas y estables porque controlan los datos que obtienen, no el servidor.
Sin versionado
Se pueden agregar nuevos campos y tipos a la API de GraphQL sin afectar las consultas existentes. Los campos obsoletos pueden marcarse como deprecados y ocultarse de las herramientas. Al usar una versión única en evolución, las API de GraphQL brindan a las aplicaciones acceso continuo a nuevas funciones y fomentan un código de servidor más limpio y mantenible.
Punto de acceso de la API de OptiSigns
Se puede acceder a la API de GraphQL utilizando el punto de acceso.
https://graphql-gateway.optisigns.com
También ofrecemos un IDE de GraphQL basado en web para acceder a nuestra API.
https://graphql-gateway.optisigns.com/graphql
Siguiente artículo - Generar y administrar clave de API