API REST

Costruisci a partire dai tuoi progetti Skimle

Endpoint JSON per leggere e scrivere i dati di progetto e per portare avanti un progetto dall'inizio alla fine. Si autentichi con una chiave Bearer, invii un'azione e riceva JSON in risposta.

Inizia in tre passi

Da zero alla tua prima chiamata autenticata.

1

Crea una chiave API

Una chiave di progetto raggiunge un solo progetto. Una chiave di account raggiunge un solo team e può crearvi progetti. Entrambe esistono nel livello di lettura e in quello di 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, quelle di modifica con e. Le chiavi di progetto chiamano /api/skimle-read e /api/skimle-write. Le chiavi di account chiamano /api/skimle-account.

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.