{"meta":{"title":"Acerca de la API de GraphQL","intro":"La API de GraphQL de GitHub ofrece flexibilidad y la capacidad de definir precisamente los datos que quieres recuperar.","product":"GraphQL API","breadcrumbs":[{"href":"/es/graphql","title":"GraphQL API"},{"href":"/es/graphql/overview","title":"Información general"},{"href":"/es/graphql/overview/about-the-graphql-api","title":"Acerca de la API de GraphQL"}],"documentType":"article"},"body":"# Acerca de la API de GraphQL\n\nLa API de GraphQL de GitHub ofrece flexibilidad y la capacidad de definir precisamente los datos que quieres recuperar.\n\n## Información general\n\nAquí tienes algunos enlaces rápidos para ayudarte a iniciar con la API de GraphQL:\n\n* [Authentication](/es/graphql/guides/forming-calls-with-graphql#authenticating-with-graphql)\n* [Punto de entrada raíz](/es/graphql/guides/forming-calls-with-graphql#the-graphql-endpoint)\n* [Introspección del esquema](/es/graphql/guides/introduction-to-graphql#discovering-the-graphql-api)\n* [Límites de velocidad](/es/graphql/overview/resource-limitations)\n* [Migrando desde REST](/es/graphql/guides/migrating-from-rest-to-graphql)\n\nPara más información sobre las API de GitHub, consulta [Comparación de la API REST de GitHub y GraphQL API](/es/rest/overview/about-githubs-apis).\n\n## Acerca de GraphQL\n\nEl lenguaje de consulta de datos [GraphQL](https://graphql.org/) es:\n\n* **una [especificación](https://spec.graphql.org/June2018/).** La especificación determina la validez del [schema](/es/graphql/guides/introduction-to-graphql#schema) en el servidor de API. El modelo determina la validez de las llamadas al cliente.\n\n***\n\n```\n          [Establecimiento inflexible de tipos](#about-the-graphql-schema-reference).** El esquema define el sistema de tipos de una API y todas las relaciones de objetos.\n```\n\n***\n\n```\n          [Introspective](/graphql/guides/introduction-to-graphql#discovering-the-graphql-api).** Un cliente puede consultar el esquema para obtener más información sobre él.\n```\n\n***\n\n```\n          [Jerárquico](/graphql/guides/forming-calls-with-graphql).** La forma de una llamada de GraphQL refleja la forma de los datos JSON que se devuelven. \n          [Nested fields](/graphql/guides/migrating-from-rest-to-graphql#example-nesting) permite consultar y recibir solo los datos que especifique en un solo recorrido de ida y vuelta.\n```\n\n* **Nivel de aplicación.** GraphQL no es un modelo de storage ni un lenguaje de consulta de base de datos. El *graph* hace referencia a las estructuras de grafos definidas en el esquema, donde [nodes](/es/graphql/guides/introduction-to-graphql#node) definen objetos y [edges](/es/graphql/guides/introduction-to-graphql#edge) definen relaciones entre objetos. La API recorre y recupera datos de la aplicación basándose en las definiciones del modelo, independientemente de cómo se almacenan los datos.\n\n## Por qué GitHub usa GraphQL\n\nGitHub eligió GraphQL porque ofrece una flexibilidad significativamente mayor para nuestros integradores. La capacidad de definir exactamente los datos que desea— y *solo* los datos que desea— es una potente ventaja en comparación con los puntos de conexión de API de REST tradicionales. GraphQL le permite reemplazar varias solicitudes de REST con *una sola llamada* para obtener los datos que especifique.\n\nPara obtener más información sobre por qué GitHub invierte en GraphQL, consulte la entrada de blog [del anuncio original](https://github.blog/2016-09-14-the-github-graphql-api/).\n\n## Acerca de la referencia del modelo de GraphQL\n\nLos documentos de la barra lateral se generan a partir de los datos GitHub GraphQL [schema](/es/graphql/guides/introduction-to-graphql#discovering-the-graphql-api). Todas las llamadas se validan y ejecutan contra el modelo. Utiliza estos documentos para encontrar los datos a los que puedes llamar:\n\n* Operaciones permitidas: [consultas](/es/graphql/reference/queries) y [mutaciones](/es/graphql/reference/mutations).\n\n* Tipos definidos por el esquema: [escalares](/es/graphql/reference/scalars), [objetos](/es/graphql/reference/objects), [enumeraciones](/es/graphql/reference/enums), [interfaces](/es/graphql/reference/interfaces), [uniones](/es/graphql/reference/unions) y [objetos de entrada](/es/graphql/reference/input-objects).\n\nPara obtener otra información, como la autenticación y los detalles del límite de velocidad, consulte el [guides](/es/graphql/guides).\n\n## Solicitar soporte\n\nPara las preguntas, reportes de errores y debates sobre las GitHub Apps, OAuth apps y el desarrollo de la API, explora [Categoría API y webhooks en las discusiones de la comunidad de GitHub](https://github.com/orgs/community/discussions/categories/api-and-webhooks). El personal de GitHub modera y mantiene las discusiones y la comunidad de GitHub las responde.\n\nConsidera la posibilidad de ponerse en contacto con [Soporte de GitHub](https://support.github.com/) directamente mediante el formulario de contacto para:\n\n* Respuestas garantizadas del personal de GitHub\n* Solicitudes de soporte que involucren preocupaciones sobre datos confidenciales o privados\n* Solicitud de función\n* Comentarios sobre los productos de GitHub\n\nSi observa errores inesperados, puede usar [githubstatus.com](https://www.githubstatus.com/) o la [API de estado GitHub](https://www.githubstatus.com/api) para comprobar si hay incidentes que afectan a la API."}