# Panoramica dell'API

Vibedasher espone un'API programmatica per l'intera piattaforma gestita — connessioni, dataset, aggiornamenti, dbt, SQL, visualizzazioni, governance e altro. È così che il tuo harness raggiunge quella piattaforma: il **[server MCP](/it/guides/build-with-your-agent.md)** guidato dal tuo agente è un wrapper su questa API, e gli SDK sono il modo in cui il tuo stesso codice interroga la piattaforma e incorpora le dashboard che i tuoi agenti vi pubblicano. Ci sono due livelli:

1. **L'API autenticata**, raggiunta attraverso gli **[SDK](/it/api/sdks.md)** ufficiali con una chiave API. Questa è l'intera superficie rivolta all'utente.
2. Una **superficie pubblica, senza autenticazione** sotto `/v1/public/*` per leggere visualizzazioni *pubblicate* — gli stessi dati che le tue dashboard incorporate consumano.

La superficie SDK è l'API **programmatica**. L'idraulica interna (admin, websocket, invocazione diretta, tracciamento dell'uso), i flussi di fatturazione/portale, e le funzionalità solo nell'app (notifiche, feedback, branding dell'account, configurazione email) sono esclusi — sono guidati dall'interfaccia dell'app, non dall'API pubblica.

## URL di base[​](#url-di-base "Link diretto a URL di base")

```
https://api.vibedasher.com/api
```

È il solo indirizzo che ti serve. L'edge davanti legge la tua credenziale e inoltra la richiesta alla regione che ospita i dati del tuo account, quindi non devi sapere quale sia — vedi [Un solo host, instradato dalla tua credenziale](/it/api/authentication.md#one-host-routed-by-your-credential).

Ogni regione risponde anche sul proprio hostname, `https://api.{region}.vibedasher.com/api`. Sono pienamente supportati, e sono il modo per fissare un client a una sola regione di proposito. Per un'installazione self-hosted, sostituisci con il tuo host API.

## Autenticazione[​](#autenticazione "Link diretto a Autenticazione")

L'API autenticata usa una **chiave API** inviata nell'header `X-Api-Key` — generane una nell'app sotto Impostazioni → Chiavi API. (La creazione della chiave è solo di sessione e non è invocabile con una chiave.) Vedi **[Autenticazione](/it/api/authentication.md)** per i dettagli.

Se raggiungi la piattaforma dal tuo agente via MCP invece che dal tuo stesso codice, non hai bisogno di alcuna chiave: `vibedasher login` (in `vibedasher-mcp` **0.6.0 o versioni successive**) ti fa accedere attraverso il browser. Vedi **[Crea con il tuo agente](/it/guides/build-with-your-agent.md)**.

Gli endpoint `/v1/public/*` sotto non richiedono **alcuna** autenticazione.

## Endpoint pubblici (senza autenticazione)[​](#endpoint-pubblici-senza-autenticazione "Link diretto a Endpoint pubblici (senza autenticazione)")

Per leggere visualizzazioni pubblicate e pubbliche:

| Metodo | Percorso                                     | Scopo                                          |
| ------ | -------------------------------------------- | ---------------------------------------------- |
| `GET`  | `/v1/public/viz/slug/{slug}`                 | Recupera una viz pubblicata per slug           |
| `GET`  | `/v1/public/viz/{account_slug}/{slug}`       | Recupera una viz pubblicata per account + slug |
| `POST` | `/v1/public/viz/{account_slug}/{slug}/query` | Esegui una query sulla viz                     |

Solo le visualizzazioni che sono **pubblicate e contrassegnate come pubbliche** sono raggiungibili attraverso queste route — draft e dashboard private restituiscono 404.

## Schema OpenAPI e generazione del codice[​](#schema-openapi-e-generazione-del-codice "Link diretto a Schema OpenAPI e generazione del codice")

L'intera API autenticata è descritta da una specifica OpenAPI 3.0 tracciata (`Vibedasher SDK API`, v2.0.0). Gli SDK ufficiali sono generati a partire da essa, quindi il percorso più semplice è **usare gli SDK** invece di costruire un client a mano:

* **TypeScript** — `npm install @vibedasher/client`
* **Python** — `pip install vibedasher`

Vedi **[SDK](/it/api/sdks.md)** per l'uso. Se hai bisogno di un client in un altro linguaggio, generane uno dalla stessa specifica OpenAPI con il generatore che preferisci.

## Esplora ogni endpoint[​](#esplora-ogni-endpoint "Link diretto a Esplora ogni endpoint")

Il riferimento completo, per ogni endpoint — ogni operazione raggruppata per risorsa (dataset, connessioni, viz, questions, …) con esempi di richiesta curl / Python / TypeScript — si trova nel **[Riferimento API](/it/reference/vibedasher-sdk-api.md)**.

## Passi successivi[​](#passi-successivi "Link diretto a Passi successivi")

* **[SDK](/it/api/sdks.md)** — i client ufficiali TypeScript e Python.
* **[Autenticazione](/it/api/authentication.md)** — chiavi API e la superficie pubblica.
* **[Riferimento API](/it/reference/vibedasher-sdk-api.md)** — ogni endpoint, con esempi di codice.
* **[Incorporare una dashboard](/it/api/embedding-the-share-iframe.md)** — inserisci una dashboard pubblicata nella tua stessa app, pubblicamente o vincolata per singolo visualizzatore con filtri per riga.