> ## 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, requêtes récentes et documentation de l'API > Consultez vos requêtes récentes à l'API Flowella, activez ou désactivez l'API sandbox à l'échelle de l'organisation, et ouvrez les guides de démarrage rapide, la documentation interactive de l'API, Postman et OpenAPI. Le Developer hub rassemble ce dont vous avez besoin pour développer sur l'[API REST Flowella](https://knowledge.flowella.io/fr/api-reference/introduction.md). Il affiche l'adresse de l'API, un journal des requêtes API récentes, l'interrupteur **API sandbox** à l'échelle de l'organisation, des guides de démarrage rapide et des liens vers la documentation de l'API. Pour l'ouvrir, accédez à **Settings**, puis sélectionnez **Developer hub** dans le groupe **Developer**. ## Qui peut l'utiliser | Partie du hub | Qui peut l'utiliser | | - | - | | **API base URL**, **Quickstarts** et **Links** | Tout le monde dans l'organisation. | | **Recent API requests** | Les Owners et les Admins. Pour les autres rôles, la carte n'affiche aucune requête. | | **API sandbox** | Tout le monde peut voir si elle est **Active** ou **Off**. Seuls les Owners et les Admins peuvent l'activer ou la désactiver. | | Les clés API et applications développeur ouvertes par les liens | Les Owners et les Admins. Voir [Clés API](https://knowledge.flowella.io/fr/settings/api-keys.md) et [Applications développeur](https://knowledge.flowella.io/fr/settings/developer-apps.md). | ## API base URL Cette carte affiche l'adresse de l'API REST. Dans votre intégration, utilisez `https://api.flowella.io/v1` comme URL de base, même si la carte affiche une adresse se terminant par `/api/v1`. Voir [URL de base](https://knowledge.flowella.io/fr/api-reference/introduction.md#url-de-base) pour en savoir plus. ## Recent API requests Cette carte liste les 25 requêtes API les plus récentes adressées à votre organisation avec des clés API ou des jetons d'accès OAuth, de la plus récente à la plus ancienne. | Colonne | Ce qu'elle affiche | | - | - | | **Time** | Le moment où Flowella a reçu la requête. | | **Method** | La méthode HTTP, par exemple `POST`. | | **Path** | L'endpoint appelé. | | **Status** | Le statut HTTP renvoyé par Flowella. | | **Actor** | L'auteur de l'appel : `key:` suivi d'un identifiant pour une clé API, ou `oauth:` suivi du client ID d'une application OAuth. L'identifiant `key:` n'est pas le préfixe de clé affiché sur l'écran des clés API. | | **Request id** | L'ID de la requête, identique à la valeur de l'en-tête de réponse `X-Request-Id`. | Les requêtes que Flowella refuse avant de les exécuter ne sont pas listées. C'est le cas des requêtes avec un jeton manquant ou invalide, un scope manquant, un en-tête `API-Version` non pris en charge, ou qui dépassent la limite de débit. Pour voir tout ce qui est lié à une requête, comme les événements, les tâches et les envois de webhooks qu'elle a déclenchés, appelez `GET /v1/requests/{requestId}` avec le **Request id**. Cet appel nécessite le scope `account:read`. Voir [ID de requête](https://knowledge.flowella.io/fr/api-reference/introduction.md#identifiants-de-requête). ## API sandbox La carte **API sandbox** comporte un interrupteur à l'échelle de l'organisation pour tester sans rien envoyer à WhatsApp. Le badge affiche **Active** lorsque la sandbox est activée et **Off** lorsqu'elle est désactivée. **Sandbox guide** ouvre le guide de la sandbox dans l'application. Pour activer la sandbox, un Owner ou un Admin coche la case en bas de la carte. Décochez-la pour désactiver la sandbox. La modification s'applique immédiatement à toute l'organisation. Vous pouvez aussi lire et modifier ce paramètre avec `GET /v1/sandbox` et `PATCH /v1/sandbox`, avec le corps `{ "enabled": true }` ou `{ "enabled": false }`. Les deux nécessitent le scope `sandbox:manage`. > [!WARNING] > > L'API sandbox n'affecte pas que les appels API. Tant qu'elle est activée, l'[envoi groupé](https://knowledge.flowella.io/fr/app/bulk-send.md) dans l'application et l'action **Send WhatsApp Template** dans les workflows HubSpot n'atteignent plus les contacts non plus. Les réponses depuis l'inbox et les actions HubSpot **Send WhatsApp Message** et **Send WhatsApp Reply** sont toujours réellement envoyées. Désactivez la sandbox dès que vous avez terminé vos tests. ### API sandbox et clés sandbox Il existe deux façons d'utiliser la sandbox. L'**API sandbox** à l'échelle de l'organisation couvre toutes les requêtes, tandis qu'une [clé sandbox](https://knowledge.flowella.io/fr/settings/api-keys.md#clés-sandbox) ne couvre que les requêtes effectuées avec cette clé. | | **API sandbox** à l'échelle de l'organisation | **Clé sandbox** | | - | - | - | | Comment l'activer | Un Owner ou un Admin coche l'interrupteur ici, ou appelle `PATCH /v1/sandbox`. | Cochez **Sandbox key** lors de la création d'une clé API. | | Requêtes couvertes | Toutes les requêtes API de l'organisation, depuis n'importe quelle clé API ou application OAuth. | Uniquement les requêtes effectuées avec cette clé. | | `POST /v1/messages` | Stocké dans Flowella, non envoyé. | Stocké dans Flowella, non envoyé. | | Soumission de modèle | Décision simulée instantanée. | Décision simulée instantanée. | | Envois de test de modèles | Ignorés. | Ignorés. | | `POST /v1/templates/send` | Les destinataires sont enregistrés comme traités, rien n'est envoyé. | Réellement envoyé. | | **Bulk send** dans l'application et action HubSpot **Send WhatsApp Template** | Les destinataires sont enregistrés comme traités, rien n'est envoyé. | Non concernés. | ### Ce qui change dans la sandbox Lorsque la sandbox couvre une requête : * `POST /v1/messages` stocke le message dans la conversation et renvoie `"sandbox": true` avec `metaMessageId` défini sur `null`. Rien n'atteint WhatsApp, et aucun webhook `message.sent` n'est déclenché. * La soumission de modèle avec `POST /v1/templates/{id}/submit` n'atteint pas Meta. Elle approuve immédiatement le modèle, ou le rejette si le nom du modèle contient `reject_`. Un en-tête média dont l'exemple n'est qu'une adresse web est refusé avec `400 INVALID_TEMPLATE_COMPONENTS`. La décision apparaît dans l'API et dans le flux d'événements, mais la page **Templates** de l'application ne change pas. * La sandbox fonctionne dans votre organisation réelle. Les contacts, conversations et messages créés pendant les tests sont stockés comme les autres et apparaissent dans l'application. ### Outils de test de la sandbox Ces endpoints vous aident à simuler de l'activité. Ils nécessitent le scope `sandbox:manage` et fonctionnent que la sandbox soit activée ou non : utilisez-les donc uniquement avec des données de test. | Méthode | Chemin | Ce qu'il fait | | - | - | - | | `GET` | `/v1/sandbox/status` | Indique si l'API sandbox est activée, ainsi que `sandboxKey`, qui précise si votre clé est une clé sandbox. | | `POST` | `/v1/test/contacts` | Crée ou met à jour un contact à partir de `phone` et d'un `name` et d'un `email` facultatifs. | | `POST` | `/v1/test/messages/{id}/simulate-status` | Ajoute au flux d'événements un événement `message.sent`, `message.delivered`, `message.read`, `message.failed` ou `message.accepted` pour un message. Envoyez le `status` sans le préfixe `message.`. | | `POST` | `/v1/test/webhooks/replay-event` | Ajoute au flux d'événements un événement du `type` de votre choix. | | `POST` | `/v1/sandbox/fixtures/reset` | Efface les événements sandbox, les tâches sandbox et les décisions de modèles simulées. `POST /v1/test/reset` fait la même chose. | Les outils de test n'écrivent que dans le flux d'événements (`GET /v1/events`). Ils n'envoient pas de webhooks et ne modifient pas le message lui-même. ## Quickstarts La carte **Quickstarts** renvoie vers des guides pas à pas. Chacun s'ouvre sous forme de fichier Markdown dans un nouvel onglet. | Guide de démarrage rapide | Ce qu'il couvre | | - | - | | Salesforce | Installation OAuth, envoi de modèles et ingestion de formulaires. | | Zoho CRM | Upsert groupé de contacts et webhooks sortants. | | SurveyMonkey | Correspondance des données d'enquête et webhooks entrants. | | Typeform | Flux du fournisseur Typeform et webhooks entrants. | | n8n | Nœuds HTTP Request qui appellent l'API. | ## Links | Lien | Ce qu'il ouvre | | - | - | | **Interactive API docs** | La référence API dans l'application, avec les schémas de requête et des exemples à essayer. Collez une clé API pour envoyer des requêtes de test. | | **Manage API keys** | [Clés API](https://knowledge.flowella.io/fr/settings/api-keys.md), où vous créez et révoquez des clés. | | **Developer apps** | [Applications développeur](https://knowledge.flowella.io/fr/settings/developer-apps.md), où vous enregistrez des applications OAuth. | | **OpenAPI JSON** | Le document OpenAPI de l'API, que vous pouvez importer dans Postman, Insomnia ou un générateur de code. | | **Postman collection** | Télécharge `flowella-v1.postman_collection.json`. | | **Capabilities matrix (authenticated)** | `GET /v1/capabilities`, qui liste les scopes de votre jeton, indique si la sandbox est activée, et précise les types de messages et catégories de modèles pris en charge. Cet appel nécessite une clé API avec le scope `account:read` : un onglet de navigateur affiche donc une erreur d'authentification. Appelez-le plutôt depuis votre client API. | ## Voir aussi > **[Introduction à l'API](https://knowledge.flowella.io/fr/api-reference/introduction.md)** > > Authentification, scopes, limites de débit et erreurs. > **[Clés API](https://knowledge.flowella.io/fr/settings/api-keys.md)** > > Créez des clés live et sandbox. > **[Applications développeur](https://knowledge.flowella.io/fr/settings/developer-apps.md)** > > Enregistrez une application OAuth et gérez les applications installées. > **[Référence des webhooks](https://knowledge.flowella.io/fr/api-reference/webhooks.md)** > > Types d'événements, payloads et vérification des signatures. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.