API REST

Costruisca a partire dai Suoi 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.

Inizi in tre passi

Da zero alla Sua prima chiamata autenticata.

1

Crei 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. Apra la pagina delle chiavi API
  2. 2. Scelga 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

Invii la Sua 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

Apra il riferimento dell'API

Sfogli 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?

Gestisca le chiavi dei Suoi progetti oppure dia un'occhiata al server MCP per i client agentici.