> For the complete documentation index, see [llms.txt](https://docs.geopard.tech/geopard-tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geopard.tech/geopard-tutorials/esp/documentacion-de-la-api/getting-started-with-the-geopard-api.md).

# Primeros pasos con la API de GeoPard

El equipo de GeoPard recomienda encarecidamente empezar con Altair para explorar a fondo las funcionalidades de la API de GeoPard. Altair obtiene siempre la versión más reciente de las entidades, consultas, mutaciones y suscripciones disponibles. Consulta la guía de inicio rápido que se muestra a continuación:

1. Instala la extensión de Chrome Altair GraphQL desde este [ENLACE](https://chrome.google.com/webstore/detail/altair-graphql-client/flnheeellpciglgpaodhkhmapeljopja) o, como alternativa, usa Altair GraphQL Client directamente en [tu navegador](https://altairgraphql.dev/).
2. Cada solicitud debe autenticarse con un `Authorization` ENCABEZADO, que debe incluir el token correspondiente. Para hacer pruebas rápidas, puedes obtener el valor del `Authorization` ENCABEZADO de las solicitudes que se envían después de iniciar sesión en GeoPard Agriculture.\
   \&#xNAN;*En la captura de pantalla siguiente se incluye una breve explicación.*
3. El endpoint raíz de GraphQL se encuentra en [`https://api.geopard.tech/data`](https://api.geopard.tech/data).\
   \&#xNAN;*En la captura de pantalla siguiente se incluye una breve explicación.*
4. Puedes acceder al esquema de GraphQL desde el botón «Docs» de la interfaz de Altair. Esta sección te permite explorar todas las consultas, mutaciones y suscripciones disponibles. También ofrece información sobre las distintas entidades y sus estructuras, lo que proporciona una visión completa de la configuración de GraphQL del sistema.\
   \&#xNAN;*En la captura de pantalla siguiente se incluye una breve explicación.*
5. Comprueba que las solicitudes salientes funcionan correctamente mediante la consola de desarrollo del navegador. Puedes aplicar filtros de solicitudes, como `/data`.
6. Puedes acceder al esquema desde [AQUÍ](https://docs.geopard.tech/geopard-tutorials/esp/documentacion-de-la-api/geopard-api-data-schema.md).
7. Para cargar archivos, utilizamos [estos endpoints](https://docs.geopard.tech/geopard-tutorials/esp/documentacion-de-la-api/geopard-api-requests-overview/55.-upload-zip-files-over-6-mb.md).
8. Para acceder a los datos ráster y vectoriales, utilizamos los formatos OGC WMS (imágenes ráster para una representación rápida) y WFS (`shp`, `geojson`). Para obtener más información, consulta la sección [Geo Endpoint](https://docs.geopard.tech/geopard-tutorials/esp/documentacion-de-la-api/geo-endpoints-for-spatial-data-access.md).

{% hint style="info" %}
En la captura de pantalla siguiente se destacan una guía breve y algunos consejos para usar Altair.
{% endhint %}

<div data-full-width="false"><figure><img src="https://lh4.googleusercontent.com/EZpStltSSIrSpTFL7hBm0R1he22M4nFKjMOIOUld0kW-Y18sw3FH-nzbuu0kn98RV2ifuAyX7PH3cTs8pbkMqPTkXI-2IySPzzCJmM-WGDGIHZk6NztLHak_cJQQ_EhzH8hH37jmwng8GlVSyofmYA" alt=""><figcaption><p>Altair: guía breve</p></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.geopard.tech/geopard-tutorials/esp/documentacion-de-la-api/getting-started-with-the-geopard-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
