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