> ## 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, letzte Anfragen und API-Dokumentation > Sehen Sie Ihre letzten Flowella-API-Anfragen, schalten Sie die organisationsweite API-Sandbox ein oder aus und öffnen Sie Schnellstarts, die interaktive API-Dokumentation, Postman und OpenAPI. Der Developer Hub bündelt alles, was Sie zum Entwickeln mit der [Flowella REST API](https://knowledge.flowella.io/de/api-reference/introduction.md) benötigen. Er zeigt die API-Adresse, ein Protokoll der letzten API-Anfragen, den organisationsweiten Schalter **API sandbox**, Schnellstarts und Links zur API-Dokumentation. Um ihn zu öffnen, gehen Sie zu **Settings** und wählen Sie in der Gruppe **Developer** die Option **Developer hub**. ## Wer ihn verwenden kann | Bereich des Hubs | Wer ihn verwenden kann | | - | - | | **API base URL**, **Quickstarts** und **Links** | Alle Mitglieder der Organisation. | | **Recent API requests** | Owners und Admins. Für andere Rollen zeigt die Karte keine Anfragen an. | | **API sandbox** | Alle sehen, ob sie **Active** oder **Off** ist. Nur Owners und Admins können sie ein- oder ausschalten. | | Die API-Schlüssel und Entwickler-Apps, die die Links öffnen | Owners und Admins. Siehe [API-Schlüssel](https://knowledge.flowella.io/de/settings/api-keys.md) und [Entwickler-Apps](https://knowledge.flowella.io/de/settings/developer-apps.md). | ## API-Basis-URL Diese Karte zeigt die Adresse der REST API. Verwenden Sie in Ihrer Integration `https://api.flowella.io/v1` als Basis-URL, auch wenn die Karte eine Adresse mit der Endung `/api/v1` anzeigt. Den Grund dafür finden Sie unter [Basis-URL](https://knowledge.flowella.io/de/api-reference/introduction.md#basis-url). ## Letzte API-Anfragen Diese Karte listet die 25 neuesten API-Anfragen an Ihre Organisation auf, die mit API-Schlüsseln oder OAuth-Access-Tokens gestellt wurden, die neueste zuerst. | Spalte | Was sie anzeigt | | - | - | | **Time** | Wann Flowella die Anfrage empfangen hat. | | **Method** | Die HTTP-Methode, zum Beispiel `POST`. | | **Path** | Der aufgerufene Endpunkt. | | **Status** | Der HTTP-Status, den Flowella zurückgegeben hat. | | **Actor** | Wer den Aufruf gemacht hat: `key:` gefolgt von einer Kennung für einen API-Schlüssel oder `oauth:` gefolgt von der Client-ID einer OAuth-App. Die `key:`-Kennung ist nicht das Schlüsselpräfix, das auf dem Bildschirm API keys angezeigt wird. | | **Request id** | Die ID der Anfrage, derselbe Wert wie der Antwort-Header `X-Request-Id`. | Anfragen, die Flowella vor der Ausführung ablehnt, werden nicht aufgeführt. Dazu gehören Anfragen mit fehlendem oder ungültigem Token, fehlendem Scope, einem nicht unterstützten Header `API-Version` oder solche über dem Ratenlimit. Um alles zu sehen, was mit einer Anfrage verknüpft ist, etwa die ausgelösten Ereignisse, Jobs und Webhook-Zustellungen, rufen Sie `GET /v1/requests/{requestId}` mit der **Request id** auf. Dafür ist der Scope `account:read` erforderlich. Siehe [Request-IDs](https://knowledge.flowella.io/de/api-reference/introduction.md#anfrage-ids). ## API-Sandbox Die Karte **API sandbox** enthält einen organisationsweiten Schalter zum Testen, ohne etwas an WhatsApp zu senden. Das Badge zeigt **Active**, wenn die Sandbox eingeschaltet ist, und **Off**, wenn sie ausgeschaltet ist. **Sandbox guide** öffnet den Sandbox-Leitfaden in der App. Um die Sandbox einzuschalten, aktiviert ein Owner oder Admin das Kontrollkästchen unten auf der Karte. Deaktivieren Sie es, um die Sandbox auszuschalten. Die Änderung gilt sofort für die gesamte Organisation. Sie können die Einstellung auch mit `GET /v1/sandbox` und `PATCH /v1/sandbox` lesen und ändern, mit dem Body `{ "enabled": true }` oder `{ "enabled": false }`. Beide benötigen den Scope `sandbox:manage`. > [!WARNING] > > Die API-Sandbox betrifft mehr als nur API-Aufrufe. Solange sie eingeschaltet ist, erreichen auch [Bulk send](https://knowledge.flowella.io/de/app/bulk-send.md) in der App und die Aktion **Send WhatsApp Template** in HubSpot-Workflows keine Kontakte mehr. Antworten aus dem Inbox sowie die HubSpot-Aktionen **Send WhatsApp Message** und **Send WhatsApp Reply** werden weiterhin tatsächlich gesendet. Schalten Sie die Sandbox aus, sobald Sie mit dem Testen fertig sind. ### API-Sandbox und Sandbox-Schlüssel Es gibt zwei Möglichkeiten, die Sandbox zu nutzen. Die organisationsweite **API sandbox** gilt für jede Anfrage, ein [Sandbox-Schlüssel](https://knowledge.flowella.io/de/settings/api-keys.md#sandbox-schlüssel) dagegen nur für die Anfragen, die mit diesem Schlüssel gestellt werden. | | Organisationsweite **API sandbox** | **Sandbox key** | | - | - | - | | Wie Sie sie einschalten | Ein Owner oder Admin aktiviert hier den Schalter oder ruft `PATCH /v1/sandbox` auf. | Aktivieren Sie **Sandbox key** beim Erstellen eines API-Schlüssels. | | Welche Anfragen sie abdeckt | Alle API-Anfragen in der Organisation, von jedem API-Schlüssel oder jeder OAuth-App. | Nur Anfragen mit diesem Schlüssel. | | `POST /v1/messages` | In Flowella gespeichert, nicht gesendet. | In Flowella gespeichert, nicht gesendet. | | Einreichen von Vorlagen | Sofortige simulierte Entscheidung. | Sofortige simulierte Entscheidung. | | Testsendungen von Vorlagen | Übersprungen. | Übersprungen. | | `POST /v1/templates/send` | Empfänger werden als erledigt erfasst, nichts wird gesendet. | Tatsächlich gesendet. | | **Bulk send** in der App und die HubSpot-Aktion **Send WhatsApp Template** | Empfänger werden als erledigt erfasst, nichts wird gesendet. | Nicht betroffen. | ### Was sich in der Sandbox ändert Wenn die Sandbox eine Anfrage abdeckt: * `POST /v1/messages` speichert die Nachricht in der Konversation und gibt `"sandbox": true` mit `metaMessageId` gleich `null` zurück. Nichts erreicht WhatsApp, und es wird kein Webhook `message.sent` ausgelöst. * Das Einreichen von Vorlagen mit `POST /v1/templates/{id}/submit` erreicht Meta nicht. Die Vorlage wird sofort genehmigt oder abgelehnt, wenn der Vorlagenname `reject_` enthält. Ein Medien-Header, dessen Beispiel nur eine Webadresse ist, wird mit `400 INVALID_TEMPLATE_COMPONENTS` abgelehnt. Die Entscheidung erscheint in der API und im Ereignis-Feed, aber die Seite **Templates** in der App ändert sich nicht. * Die Sandbox läuft in Ihrer echten Organisation. Kontakte, Konversationen und Nachrichten, die bei Tests entstehen, werden wie alle anderen gespeichert und erscheinen in der App. ### Sandbox-Testwerkzeuge Diese Endpunkte helfen Ihnen, Aktivität zu simulieren. Sie benötigen den Scope `sandbox:manage` und funktionieren unabhängig davon, ob die Sandbox eingeschaltet ist. Verwenden Sie sie daher nur mit Testdaten. | Methode | Pfad | Was er tut | | - | - | - | | `GET` | `/v1/sandbox/status` | Gibt zurück, ob die API-Sandbox eingeschaltet ist, sowie `sandboxKey`, das angibt, ob Ihr Schlüssel ein Sandbox-Schlüssel ist. | | `POST` | `/v1/test/contacts` | Erstellt oder aktualisiert einen Kontakt aus `phone` und optional `name` und `email`. | | `POST` | `/v1/test/messages/{id}/simulate-status` | Fügt dem Ereignis-Feed für eine Nachricht ein Ereignis `message.sent`, `message.delivered`, `message.read`, `message.failed` oder `message.accepted` hinzu. Senden Sie den `status` ohne das Präfix `message.`. | | `POST` | `/v1/test/webhooks/replay-event` | Fügt dem Ereignis-Feed ein Ereignis des von Ihnen gewählten `type` hinzu. | | `POST` | `/v1/sandbox/fixtures/reset` | Löscht Sandbox-Ereignisse, Sandbox-Jobs und simulierte Vorlagenentscheidungen. `POST /v1/test/reset` tut dasselbe. | Die Testwerkzeuge schreiben nur in den Ereignis-Feed (`GET /v1/events`). Sie senden keine Webhooks und ändern die Nachricht selbst nicht. ## Schnellstarts Die Karte **Quickstarts** verlinkt auf Schritt-für-Schritt-Anleitungen. Jede öffnet sich als Markdown-Datei in einem neuen Tab. | Schnellstart | Was er behandelt | | - | - | | Salesforce | OAuth-Installation, Vorlagenversand und Formularübernahme. | | Zoho CRM | Massen-Upsert von Kontakten und ausgehende Webhooks. | | SurveyMonkey | Zuordnung von Umfragedetails und eingehende Webhooks. | | Typeform | Typeform-Provider-Flows und eingehende Webhooks. | | n8n | HTTP-Request-Knoten, die die API aufrufen. | ## Links | Link | Was er öffnet | | - | - | | **Interactive API docs** | Die API-Referenz in der App mit Anfrageschemas und Try-it-Beispielen. Fügen Sie einen API-Schlüssel ein, um Testanfragen zu senden. | | **Manage API keys** | [API-Schlüssel](https://knowledge.flowella.io/de/settings/api-keys.md), wo Sie Schlüssel erstellen und widerrufen. | | **Developer apps** | [Entwickler-Apps](https://knowledge.flowella.io/de/settings/developer-apps.md), wo Sie OAuth-Apps registrieren. | | **OpenAPI JSON** | Das OpenAPI-Dokument der API, das Sie in Postman, Insomnia oder einen Codegenerator importieren können. | | **Postman collection** | Lädt `flowella-v1.postman_collection.json` herunter. | | **Capabilities matrix (authenticated)** | `GET /v1/capabilities`, das die Scopes Ihres Tokens, den Status der Sandbox sowie unterstützte Nachrichtentypen und Vorlagenkategorien auflistet. Es benötigt einen API-Schlüssel mit dem Scope `account:read`, daher zeigt ein Browser-Tab einen Authentifizierungsfehler an. Rufen Sie es stattdessen aus Ihrem API-Client auf. | ## Verwandt > **[API-Einführung](https://knowledge.flowella.io/de/api-reference/introduction.md)** > > Authentifizierung, Scopes, Ratenlimits und Fehler. > **[API-Schlüssel](https://knowledge.flowella.io/de/settings/api-keys.md)** > > Live- und Sandbox-Schlüssel erstellen. > **[Entwickler-Apps](https://knowledge.flowella.io/de/settings/developer-apps.md)** > > Eine OAuth-App registrieren und installierte Apps verwalten. > **[Webhooks-Referenz](https://knowledge.flowella.io/de/api-reference/webhooks.md)** > > Ereignistypen, Payloads und Signaturprüfungen. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.