API
Leggi e modifica i tuoi dati Solid con endpoint REST o GraphQL generati dal tuo modello dati.
Solid genera la propria API a partire dal tuo modello dati. Gli oggetti personalizzati ricevono gli stessi endpoint di quelli standard, con i nomi dei tuoi oggetti e campi.
Due API
| API | Percorso | Usala per |
|---|---|---|
| Core | /rest/ o /graphql/ | Creare, leggere, aggiornare ed eliminare record |
| Metadata | /rest/metadata/ o /metadata/ | Gestire oggetti, campi e impostazioni del workspace |
REST e GraphQL accedono agli stessi dati. GraphQL consente inoltre di recuperare i record correlati in un'unica chiamata e supporta gli upsert in batch.
Autenticazione
Invia una chiave API con ogni richiesta:
Authorization: Bearer YOUR_API_KEYPer creare una chiave:
- Vai su Impostazioni → API e Webhook.
- Fai clic su + Crea chiave, assegnale un nome e una data di scadenza.
- Copia subito la chiave. Viene mostrata una sola volta.
Una chiave API dà accesso ai tuoi dati. Assegnale un ruolo limitato in Impostazioni → Membri → Ruoli ed eliminala non appena non è più necessaria.
Una prima richiesta
Elenca le aziende con REST:
curl https://YOUR_SOLID_URL/rest/companies \
-H "Authorization: Bearer YOUR_API_KEY"Crea un record in un oggetto personalizzato chiamato Contracts:
curl -X POST https://YOUR_SOLID_URL/rest/contracts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Rinnovo Acme 2026"}'Sostituisci YOUR_SOLID_URL con l'indirizzo del tuo workspace.
Il riferimento del tuo workspace
Poiché l'API segue il tuo modello dati, il riferimento completo viene generato per ciascun workspace. Apri Impostazioni → API e Webhook, crea una chiave e scegli REST API o GraphQL API per esplorare e provare ogni endpoint nel playground.