7. Riferimenti Tecnici e API
Riferimenti Tecnici e API
Documentazione di riferimento per la scrittura della KB tramite API.
Bookstack API
| Endpoint | Metodo | Uso |
|---|
/api/shelves | GET | Lista scaffali |
/api/shelves | POST | Crea scaffale ({"name", "description_html"}) |
/api/shelves/{id} | PUT | Aggiorna scaffale e assegna libri con {"books": [id, ...]} |
/api/books | POST | Crea libro ({"name", "description_html"}) |
/api/books/{id} | DELETE | Elimina libro |
/api/pages | POST | Crea pagina ({"book_id", "name", "html"}) |
Autenticazione
Authorization: Token <token_id>:<token_secret>
Struttura KB attuale (ID e slug)
| Entità | ID | Slug |
|---|
| Shelf: Organizzazione | 1 | pasquetti-group-organizzazione |
| Shelf: CRM | 2 | crm-e-business-development |
| Shelf: Pyuty | 3 | pyuty-manuale-operativo |
| Shelf: Amministrazione | 4 | amministrazione-e-sicurezza |
| Shelf: Piano di Lavoro KB | 5 (o successivo) | (da determinare) |
| Book: Guida alla KB | 26 | guida-alla-knowledge-base-pasquetti |
| Book: Piano di Popolamento | (questo) | (da popolare) |
Flusso di creazione contenuti
1. POST /api/books -> crea libro (orifano, senza shelf)2. PUT /api/shelves/{id} -> assegna libro allo scaffale3. POST /api/pages -> crea pagine dentro il libroStrumenti esterni da referenziare
- n8n: API key per Pasquetti —
pasquettigroup.app.n8n.cloud (auth via X-N8N-API-KEY header) - NocoDB: xc-token
nc_pat_nO8YYdD9jp2xQpyOjbKzC_2tOd2UNdTHUTTV2T-u su nocodb.turbocrowd.net - Coda: token
eebe164c-6c4a-4032-834d-2923fc231f3a su coda.io/apis/v1 - Coolify: API token
3495|3R61yrioZMzrCDRLa01Mm3owmibONoLfBYoWGBl73e89bb2e su coolify.turbocrowd.net/api/v1