diff --git a/docs/es/features/graphql.md b/docs/es/features/graphql.md index 1d2da841a..12f45992a 100644 --- a/docs/es/features/graphql.md +++ b/docs/es/features/graphql.md @@ -1,24 +1,25 @@ # Documentación de la API -* [Características](#características) +* [Características](#caracteristicas) * [GraphQL](#graphql) * [Haciendo peticiones a la API](#haciendo-peticiones-a-la-api) * [Clientes soportados](#clientes-soportados) * [GraphiQL](#graphiql) * [Postman](#postman) - * [Librerías HTTP](#librerías-http) -* [Información disponible](#información-disponible) + * [Librerías HTTP](#librerias-http) +* [Información disponible](#informacion-disponible) * [Ejemplos de consultas](#ejemplos-de-consultas) - * [Recuperar un único elemento de una colección](#recuperar-un-único-elemento-de-una-colección) - * [Recuperar una colección completa](#recuperar-una-colección-completa) - * [Paginación](#paginación) - * [Acceder a varios recursos en una única petición](#acceder-a-varios-recursos-en-una-única-petición) + * [Recuperar un único elemento de una colección](#recuperar-un-unico-elemento-de-una-coleccion) + * [Recuperar una colección completa](#recuperar-una-coleccion-completa) + * [Paginación](#paginacion) + * [Acceder a varios recursos en una única petición](#acceder-a-varios-recursos-en-una-unica-peticion) * [Limitaciones de seguridad](#limitaciones-de-seguridad) * [Ejemplo de consulta demasiado profunda](#ejemplo-de-consulta-demasiado-profunda) * [Ejemplo de consulta demasiado compleja](#ejemplo-de-consulta-demasiado-compleja) -* [Ejemplos de código](#ejemplos-de-código) +* [Ejemplos de código](#ejemplos-de-codigo) -## Características + +

Características

* API de sólo lectura * Acceso público, sin autenticación @@ -111,7 +112,8 @@ La consulta debe estar ubicada en un documento JSON válido, como valor de la cl ![Postman POST](../../img/graphql/graphql-postman-post-body.png) -#### Librerías HTTP + +

Librerías HTTP

Por supuesto es posible utilizar cualquier librería HTTP de lenguajes de programación. @@ -120,7 +122,8 @@ Por supuesto es posible utilizar cualquier librería HTTP de lenguajes de progra `User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36` -## Información disponible + +

Información disponible

El fichero [config/api.yml](../../config/api.yml) contiene una lista completa de los modelos (y sus campos) que están expuestos actualmente en la API. @@ -139,8 +142,8 @@ La lista de modelos es la siguiente: ## Ejemplos de consultas -### Recuperar un único elemento de una colección - + +

Recuperar un único elemento de una colección

``` { proposal(id: 2) { @@ -165,7 +168,8 @@ Respuesta: } ``` -### Recuperar una colección completa + +

Recuperar una colección completa

``` { @@ -202,7 +206,8 @@ Respuesta: } ``` -#### Paginación + +

Paginación

Actualmente el número máximo (y por defecto) de elementos que se devuelven en cada página está establecido a 25. Para poder navegar por las distintas páginas es necesario solicitar además información relativa al `endCursor`: @@ -259,9 +264,10 @@ Para recuperar la siguiente página, hay que pasar como parámetro el cursor rec } ``` -### Acceder a varios recursos en una única petición + +

Acceder a varios recursos en una única petición

-Esta consulta solicita información relativa a varios modelos distintos en una única peticion: `Proposal`, `User`, `Geozone` y `Comment`: +Esta consulta solicita información relativa a varios modelos distintos en una única petición: `Proposal`, `User`, `Geozone` y `Comment`: ``` { @@ -427,6 +433,7 @@ La respuesta: } ``` -## Ejemplos de código + +

Ejemplos de código

El directorio [doc/api/examples](https://github.com/consul/consul/tree/master/doc/api/examples/ruby) contiene ejemplos de código para acceder a la API.