Panoramica dell'API

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

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, 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.

Autenticazione

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

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

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	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:

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "No active menu found for this venue"
}

⌘I

​Autenticazione

​URL di base

​Endpoint disponibili

​Gestione degli errori

Autenticazione

URL di base

Endpoint disponibili

Gestione degli errori