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 libro

Strumenti 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