# 8. GraphQL

GraphQL fue desarrollado por Facebook para facilitar la consulta de información. Por ejemplo una aplicación para celulares suele contener menos información que una aplicación web, por lo cual en lugar de crear 2 servicios uno para web y otro para la app, se crea un servicio Graph para traer solamente la información que se necesita.

De momento no cuenta con librería oficial por parte de Microsoft. Hay 2 paquetes de Graphql Hotchocolate y grapqhl for .net. El que esta teniendo mas popularidad es Hotchocolate.

La estructura de GraphQL esta formada por 3 partes:

1. Operación
2. Tabla y/o datos
3. Campos de la tabla

![](/files/-LasENUgdISWGtPMg7dY)

GraphQL se basa en enviar las peticiones por medio de consultas, se tienen 3 tipos:

1. **Query**: Para consultar información
2. **Mutation**: Para modificar información (crear, borrar, modificar)
3. **Subscription**: Para WebSockets (con WebSockets puedes por ejemplo recibir notificaciones cuando ocurre algún evento).

Un ejemplo para obtener la clave y nombre de los clientes sería el siguiente:

```graphql
http://myapi/graphql?query={clientes{clave, nombre}}
```

Esta petición genera el siguiente resultado

```javascript
{
  "data": {
    "clientes": [
      {gr
        "Clave": 1,
        "Nombre": "John Doe"
      },
      {
        "Clave": "2",
        "Nombre": "Alicia Smith"
      }
    ]
  }
}
```

###  Agregar  paquetes Nuget para habilitar graphQL en .NET Core

Vamos a agregar los siguientes paquetes Nuget para habilitar GraphQL en nuestro proyecto

```
Install-Package HotChocolate.AspNetCore
Install-Package HotChocolate.Data.EntityFramework
```

Para poder probar los servicios podemos utilizar el siguiente paquete el cual es similar a Swagger ya que nos genera la documentación y nos ayuda a probar nuestros servicios

```
Install-Package GraphQL.Server.UI.Playground
```

La estructura básica es la siguiente:

* **GraphType:** Permite indicar los campos del modelo que están disponibles para el servicio, los tipos de datos comunes de .net como int, string tienen su equivalente para graphQL
* **Query:** Permite configurar nuestro objeto GraphType (Modelo) con nuestra base de datos para llenar los campos del modelo.
* **Schema:** Nos permite definir las operaciones a realizar: Query (Consulta información), Mutation: (Crear, Borrar, Modificar) y Suscripción (Operaciones con WebSockets).

![](/files/-Let_ax4yOdAIOqgiy-a)

Vamos a crear nuestra tabla caducidad la cual contendrá los datos del cliente y del producto para realizar la consulta de la siguiente manera:

```graphql
{
    "query": "query {
		caducidades {
			id
			producto {
				id
				clave
				nombre
			}
			cliente
			{
				id
				nombreComercial
			}			
	      }	
   }"
} 
```

Este método se podrá consultar por GET o por POST, es mas cómodo realizarlo por POST.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://abi.gitbook.io/net-core/6.3-agregar-graphql.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.