API REST

Costruisci a partire dai tuoi progetti Skimle

Un unico endpoint per direzione — lettura o scrittura — per ogni risorsa del progetto. Autenticati con una chiave API legata al progetto, invia un'azione in JSON e ricevi JSON in risposta.

Inizia in tre passi

Da zero alla tua prima chiamata autenticata.

1

Crea una chiave API

Le chiavi API valgono per un singolo progetto e un singolo livello di accesso (lettura o modifica).

  1. 1. Apri la pagina delle chiavi API
  2. 2. Scegli il progetto a cui la chiave deve accedere e se l'accesso è in lettura o in modifica
  3. 3. Copia la chiave: Skimle ne conserva soltanto l'hash

Copia subito la chiave.

Il valore completo della chiave viene mostrato una sola volta, alla creazione. Dopo aver chiuso la finestra, da parte nostra resta solo l'hash: una chiave smarrita va riemessa.

2

Invia la tua prima richiesta

Passa la chiave come token Bearer e l'azione nel corpo JSON. Ogni endpoint riceve JSON e restituisce JSON.

curl -X POST https://app.skimle.com/api/skimle-read \
  -H "Authorization: Bearer skm_…r" \
  -H "Content-Type: application/json" \
  -d '{ "action": "get_categories" }'

Le chiavi di lettura terminano con r e possono chiamare soltanto /api/skimle-read. Quelle di modifica terminano con e e possono chiamare entrambi gli endpoint.

3

Apri il riferimento dell'API

Sfoglia tutti gli endpoint con descrizioni, struttura delle richieste e un riquadro per provarli. Ogni rotta accetta un corpo come unione discriminata sulla chiave action.

La specifica OpenAPI 3.1 grezza è disponibile su /api/openapi.json.

Pronto a costruire?

Gestisci le chiavi dei tuoi progetti oppure dai un'occhiata al server MCP per i client agentici.