> 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/it/documentazione-api/getting-started-with-the-geopard-api.md).

# Introduzione all'API GeoPard

Il team GeoPard consiglia vivamente di iniziare con Altair per esaminare a fondo le funzionalità dell’API GeoPard. Recupera sempre la versione più recente delle entità, query, mutation e subscription disponibili. Consulta la guida rapida qui sotto:

1. Installa l’estensione Altair GraphQL per Chrome da questo [LINK](https://chrome.google.com/webstore/detail/altair-graphql-client/flnheeellpciglgpaodhkhmapeljopja) oppure usa Altair GraphQL Client direttamente nel [tuo browser](https://altairgraphql.dev/).
2. Ogni richiesta deve essere autenticata con un’ `Authorization` HEADER, che deve contenere il token richiesto. Per eseguire rapidamente dei test, puoi ricavare il valore dell’ `Authorization` HEADER dalle richieste inviate dopo aver effettuato l’accesso a GeoPard Agriculture.\
   \&#xNAN;*La schermata seguente fornisce una breve spiegazione.*
3. L’endpoint GraphQL principale è disponibile all’indirizzo [`https://api.geopard.tech/data`](https://api.geopard.tech/data).\
   \&#xNAN;*La schermata seguente fornisce una breve spiegazione.*
4. Puoi accedere allo schema GraphQL tramite il pulsante "Docs" nell’interfaccia di Altair. Questa sezione consente di esplorare tutte le query, le mutation e le subscription disponibili. Inoltre, offre informazioni sulle diverse entità e sulle rispettive strutture, fornendo una panoramica completa della configurazione GraphQL del sistema.\
   \&#xNAN;*La schermata seguente fornisce una breve spiegazione.*
5. Verifica che le richieste in uscita funzionino correttamente utilizzando la console di sviluppo del browser. Puoi applicare filtri alle richieste, ad esempio `/data`.
6. Puoi accedere allo schema da questo [LINK](https://docs.geopard.tech/geopard-tutorials/it/documentazione-api/geopard-api-data-schema.md).
7. Per caricare i file, utilizziamo [questi endpoint](https://docs.geopard.tech/geopard-tutorials/it/documentazione-api/geopard-api-requests-overview/55.-upload-zip-files-over-6-mb.md).
8. Per accedere ai dati raster e vettoriali, utilizziamo i formati OGC WMS (immagini raster per una visualizzazione rapida) e WFS (`shp`, `geojson`). Per maggiori informazioni, consulta la sezione [Geo Endpoint](https://docs.geopard.tech/geopard-tutorials/it/documentazione-api/geo-endpoints-for-spatial-data-access.md).

{% hint style="info" %}
La schermata seguente mostra una breve guida con alcuni suggerimenti per utilizzare 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: guida rapida</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/it/documentazione-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.
