> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Developer hub: API sandbox, richieste recenti e documentazione API > Visualizzate le richieste recenti alla Flowella API, attivate o disattivate la API sandbox a livello di organizzazione e aprite guide rapide, documentazione API interattiva, Postman e OpenAPI. Il Developer hub riunisce ciò che vi serve per sviluppare sulla [Flowella REST API](https://knowledge.flowella.io/it/api-reference/introduction.md). Mostra l'indirizzo dell'API, un registro delle richieste API recenti, l'interruttore **API sandbox** a livello di organizzazione, le guide rapide e i link alla documentazione API. Per aprirlo, andate su **Settings**, poi selezionate **Developer hub** nel gruppo **Developer**. ## Chi può usarlo | Parte dell'hub | Chi può usarla | | - | - | | **API base URL**, **Quickstarts** e **Links** | Tutti i membri dell'organizzazione. | | **Recent API requests** | Owner e Admin. Per gli altri ruoli la scheda non mostra richieste. | | **API sandbox** | Tutti possono vedere se è **Active** o **Off**. Solo Owner e Admin possono attivarla o disattivarla. | | Le chiavi API e le app per sviluppatori aperte dai link | Owner e Admin. Consultate [Chiavi API](https://knowledge.flowella.io/it/settings/api-keys.md) e [App per sviluppatori](https://knowledge.flowella.io/it/settings/developer-apps.md). | ## API base URL Questa scheda mostra l'indirizzo della REST API. Nella vostra integrazione, usate `https://api.flowella.io/v1` come URL di base, anche se la scheda mostra un indirizzo che termina con `/api/v1`. Consultate [Base URL](https://knowledge.flowella.io/it/api-reference/introduction.md#url-di-base) per sapere perché. ## Richieste API recenti Questa scheda elenca le 25 richieste API più recenti effettuate alla vostra organizzazione con chiavi API o access token OAuth, dalla più recente. | Colonna | Cosa mostra | | - | - | | **Time** | Quando Flowella ha ricevuto la richiesta. | | **Method** | Il metodo HTTP, ad esempio `POST`. | | **Path** | L'endpoint chiamato. | | **Status** | Lo stato HTTP restituito da Flowella. | | **Actor** | Chi ha effettuato la chiamata: `key:` seguito da un identificatore per una chiave API, oppure `oauth:` seguito dal client ID di un'app OAuth. L'identificatore `key:` non è il prefisso della chiave mostrato nella schermata API keys. | | **Request id** | L'ID della richiesta, lo stesso valore dell'intestazione di risposta `X-Request-Id`. | Le richieste che Flowella rifiuta prima di eseguirle non sono elencate. Tra queste rientrano le richieste con un token mancante o non valido, uno scope mancante, un'intestazione `API-Version` non supportata o oltre il limite di frequenza. Per vedere tutto ciò che è collegato a una richiesta, come gli eventi, i job e le consegne webhook che ha generato, chiamate `GET /v1/requests/{requestId}` con il **Request id**. Richiede lo scope `account:read`. Consultate [Request IDs](https://knowledge.flowella.io/it/api-reference/introduction.md#id-delle-richieste). ## API sandbox La scheda **API sandbox** contiene un interruttore a livello di organizzazione per effettuare test senza inviare nulla a WhatsApp. Il badge mostra **Active** quando la sandbox è attiva e **Off** quando è disattivata. **Sandbox guide** apre la guida alla sandbox nell'app. Per attivare la sandbox, un Owner o un Admin seleziona la casella in fondo alla scheda. Deselezionatela per disattivare la sandbox. La modifica si applica subito all'intera organizzazione. Potete anche leggere e modificare l'impostazione con `GET /v1/sandbox` e `PATCH /v1/sandbox`, usando il corpo `{ "enabled": true }` o `{ "enabled": false }`. Entrambi richiedono lo scope `sandbox:manage`. > [!WARNING] > > La API sandbox non riguarda solo le chiamate API. Finché è attiva, anche l'[invio massivo](https://knowledge.flowella.io/it/app/bulk-send.md) nell'app e l'azione **Send WhatsApp Template** nei workflow di HubSpot smettono di raggiungere i contatti. Le risposte dall'inbox e le azioni HubSpot **Send WhatsApp Message** e **Send WhatsApp Reply** vengono invece inviate davvero. Disattivate la sandbox non appena avete finito i test. ### API sandbox e chiavi sandbox Esistono due modi per usare la sandbox. La **API sandbox** a livello di organizzazione copre ogni richiesta, mentre una [chiave sandbox](https://knowledge.flowella.io/it/settings/api-keys.md#chiavi-sandbox) copre solo le richieste effettuate con quella chiave. | | **API sandbox** a livello di organizzazione | **Chiave sandbox** | | - | - | - | | Come si attiva | Un Owner o un Admin seleziona l'interruttore qui, oppure chiama `PATCH /v1/sandbox`. | Selezionate **Sandbox key** quando create una chiave API. | | Quali richieste copre | Tutte le richieste API dell'organizzazione, da qualsiasi chiave API o app OAuth. | Solo le richieste effettuate con quella chiave. | | `POST /v1/messages` | Memorizzato in Flowella, non inviato. | Memorizzato in Flowella, non inviato. | | Invio dei modelli | Decisione simulata immediata. | Decisione simulata immediata. | | Invii di prova dei modelli | Saltati. | Saltati. | | `POST /v1/templates/send` | I destinatari vengono registrati come completati, nulla viene inviato. | Inviato davvero. | | **Bulk send** nell'app e azione HubSpot **Send WhatsApp Template** | I destinatari vengono registrati come completati, nulla viene inviato. | Nessun effetto. | ### Cosa cambia nella sandbox Quando la sandbox copre una richiesta: * `POST /v1/messages` memorizza il messaggio nella conversazione e restituisce `"sandbox": true` con `metaMessageId` impostato a `null`. Nulla arriva a WhatsApp e non viene attivato alcun webhook `message.sent`. * L'invio di un modello con `POST /v1/templates/{id}/submit` non raggiunge Meta. Il modello viene approvato subito, oppure rifiutato se il nome contiene `reject_`. Un'intestazione multimediale il cui esempio è solo un indirizzo web viene rifiutata con `400 INVALID_TEMPLATE_COMPONENTS`. La decisione compare nell'API e nel feed degli eventi, ma la pagina **Templates** nell'app non cambia. * La sandbox funziona nella vostra organizzazione reale. I contatti, le conversazioni e i messaggi creati durante i test vengono memorizzati come tutti gli altri e compaiono nell'app. ### Strumenti di test della sandbox Questi endpoint vi aiutano a simulare attività. Richiedono lo scope `sandbox:manage` e funzionano indipendentemente dal fatto che la sandbox sia attiva, quindi usateli solo con dati di test. | Metodo | Percorso | Cosa fa | | - | - | - | | `GET` | `/v1/sandbox/status` | Indica se la API sandbox è attiva e restituisce `sandboxKey`, che indica se la vostra chiave è una chiave sandbox. | | `POST` | `/v1/test/contacts` | Crea o aggiorna un contatto a partire da `phone` e da `name` ed `email` facoltativi. | | `POST` | `/v1/test/messages/{id}/simulate-status` | Aggiunge al feed degli eventi un evento `message.sent`, `message.delivered`, `message.read`, `message.failed` o `message.accepted` per un messaggio. Inviate lo `status` senza il prefisso `message.`. | | `POST` | `/v1/test/webhooks/replay-event` | Aggiunge al feed degli eventi un evento del `type` che scegliete. | | `POST` | `/v1/sandbox/fixtures/reset` | Cancella gli eventi della sandbox, i job della sandbox e le decisioni simulate sui modelli. `POST /v1/test/reset` fa lo stesso. | Gli strumenti di test scrivono solo nel feed degli eventi (`GET /v1/events`). Non inviano webhook e non modificano il messaggio stesso. ## Guide rapide La scheda **Quickstarts** rimanda a guide passo per passo. Ciascuna si apre come file Markdown in una nuova scheda. | Guida rapida | Cosa tratta | | - | - | | Salesforce | Installazione OAuth, invio di modelli e acquisizione dei moduli. | | Zoho CRM | Upsert massivo dei contatti e webhook in uscita. | | SurveyMonkey | Mappatura dei dati dei sondaggi e webhook in entrata. | | Typeform | Flussi del provider Typeform e webhook in entrata. | | n8n | Nodi HTTP Request che chiamano l'API. | ## Link | Link | Cosa apre | | - | - | | **Interactive API docs** | Il riferimento API nell'app, con gli schemi delle richieste ed esempi da provare. Incollate una chiave API per inviare richieste di prova. | | **Manage API keys** | [Chiavi API](https://knowledge.flowella.io/it/settings/api-keys.md), dove create e revocate le chiavi. | | **Developer apps** | [App per sviluppatori](https://knowledge.flowella.io/it/settings/developer-apps.md), dove registrate le app OAuth. | | **OpenAPI JSON** | Il documento OpenAPI dell'API, che potete importare in Postman, Insomnia o in un generatore di codice. | | **Postman collection** | Scarica `flowella-v1.postman_collection.json`. | | **Capabilities matrix (authenticated)** | `GET /v1/capabilities`, che elenca gli scope del vostro token, se la sandbox è attiva e i tipi di messaggio e le categorie di modelli supportati. Richiede una chiave API con lo scope `account:read`, quindi una scheda del browser mostra un errore di autenticazione. Chiamatelo invece dal vostro client API. | ## Risorse correlate > **[Introduzione all'API](https://knowledge.flowella.io/it/api-reference/introduction.md)** > > Autenticazione, scope, limiti di frequenza ed errori. > **[Chiavi API](https://knowledge.flowella.io/it/settings/api-keys.md)** > > Create chiavi live e sandbox. > **[App per sviluppatori](https://knowledge.flowella.io/it/settings/developer-apps.md)** > > Registrate un'app OAuth e gestite le app installate. > **[Riferimento webhook](https://knowledge.flowella.io/it/api-reference/webhooks.md)** > > Tipi di eventi, payload e verifica delle firme. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.