# 7. Riferimenti Tecnici e API

# Riferimenti Tecnici e API

Documentazione di riferimento per la scrittura della KB tramite API.

## Bookstack API

<table id="bkmrk-endpointmetodouso%2Fap"><tr><th>Endpoint</th><th>Metodo</th><th>Uso</th></tr><tr><td>`/api/shelves`</td><td>GET</td><td>Lista scaffali</td></tr><tr><td>`/api/shelves`</td><td>POST</td><td>Crea scaffale (`{"name", "description_html"}`)</td></tr><tr><td>`/api/shelves/{id}`</td><td>PUT</td><td>Aggiorna scaffale e assegna libri con `{"books": [id, ...]}`</td></tr><tr><td>`/api/books`</td><td>POST</td><td>Crea libro (`{"name", "description_html"}`)</td></tr><tr><td>`/api/books/{id}`</td><td>DELETE</td><td>Elimina libro</td></tr><tr><td>`/api/pages`</td><td>POST</td><td>Crea pagina (`{"book_id", "name", "html"}`)</td></tr></table>

## Autenticazione

`Authorization: Token <token_id>:<token_secret>`

## Struttura KB attuale (ID e slug)

<table id="bkmrk-entit%C3%A0idslugshelf%3A-o"><tr><th>Entità</th><th>ID</th><th>Slug</th></tr><tr><td>Shelf: Organizzazione</td><td>1</td><td>`pasquetti-group-organizzazione`</td></tr><tr><td>Shelf: CRM</td><td>2</td><td>`crm-e-business-development`</td></tr><tr><td>Shelf: Pyuty</td><td>3</td><td>`pyuty-manuale-operativo`</td></tr><tr><td>Shelf: Amministrazione</td><td>4</td><td>`amministrazione-e-sicurezza`</td></tr><tr><td>Shelf: Piano di Lavoro KB</td><td>5 (o successivo)</td><td>(da determinare)</td></tr><tr><td>Book: Guida alla KB</td><td>26</td><td>`guida-alla-knowledge-base-pasquetti`</td></tr><tr><td>Book: Piano di Popolamento</td><td>(questo)</td><td>(da popolare)</td></tr></table>

## 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`