> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Panoramica dell'API

> Collega la tua app all'API REST di storekit: autenticazione, URL di base, firma delle richieste e gestione programmatica di negozi e ordini.

L'API di storekit ti permette di gestire in modo programmatico i tuoi negozi, i menu e gli ordini.

> [!WARNING]
>
> **Early Access** — L'API di storekit è attualmente in early access e non è ampiamente disponibile. L'accesso viene concesso caso per caso: richiedilo tramite il modulo [storekit MCP/API Access Request](https://t09czsyu90l.typeform.com/to/G6rIJWNv), indicando cosa stai costruendo, per quali negozi o account, quali dati o azioni ti servono e il volume previsto. Vedi [Richiedere l'accesso all'API](/docs/it/developers/introduction#requesting-api-access).

## Autenticazione

Tutte le richieste API richiedono l'autenticazione tramite una API key. Includi la tua API key nell'header `x-api-key`:

```bash theme={null}
curl -X POST https://api.storekit.com/pos/availability \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{ ... }'
```

> [!NOTE]
>
> Le API key vengono emesse dal team storekit durante l'onboarding. Ogni API key è associata a un account specifico e può accedere solo alle risorse di quell'account.

## URL di base

Tutte le richieste API devono essere inviate a:

```
https://api.storekit.com
```

## Endpoint disponibili

| Endpoint | Metodo | Descrizione |
| - | - | - |
| [/pos/availability](/docs/it/developers/api/pos-availability) | POST | Aggiorna la disponibilità e l'inventario degli articoli |

## Gestione degli errori

L'API utilizza codici di stato HTTP standard:

| Stato | Descrizione |
| - | - |
| 200 | Successo |
| 400 | Richiesta non valida — controlla il payload |
| 401 | Non autorizzato — API key non valida o mancante |
| 404 | Non trovato — negozio o risorsa non trovata |
| 500 | Errore del server |

Le risposte di errore includono un messaggio che spiega cosa è andato storto:

```json theme={null}
{
  "statusCode": 404,
  "error": "Not Found",
  "message": "No active menu found for this venue"
}
```


## Related topics

- [Panoramica degli agenti di ordinazione](/docs/it/developers/agents/ordering/overview.md)
- [Panoramica integrazioni POS](/docs/it/guides/integrations/pos/overview.md)
- [Panoramica sugli sconti](/docs/it/guides/discounts/overview.md)
- [Panoramica sulle integrazioni](/docs/it/guides/integrations/overview.md)
- [Panoramica degli ordini](/docs/it/guides/orders/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.