Die Entwickler-Workbench verwenden

Die Workbench ist die Konsole für alle, die Cord mit einem anderen System integrieren. Sie ist Teil der App, sodass Sie Ihre Integration prüfen können, ohne Ihren Arbeitsplatz zu verlassen.

Öffnen

1. Aktivieren Sie den Entwicklermodus unter Ihr Konto › Präferenzen. Es ist eine Einstellung Ihres Kontos, nicht der Organisation.
2. Unten rechts erscheint die Schaltfläche Entwickler. Klicken Sie darauf oder drücken Sie die Taste W.

Sie benötigen in der Organisation die Berechtigung Einstellungen. Ohne sie erscheint die Workbench nicht.

Was jeder Tab enthält

• Übersicht: Anfragen, Fehlerquote, Latenz, Webhook-Zustellungen, API-Nutzung des Monats und aktive Warnungen.
• Protokolle: jede Anfrage an die API und an den MCP-Server. Suchen Sie nach Pfad, nach Request-ID (req_…) oder nach Fehlercode, und öffnen Sie eine Anfrage, um ihre Details zu sehen, sie als cURL zu kopieren oder in der Shell zu wiederholen.
• Fehler: die Fehler nach Code und Pfad gruppiert, mit ihrer Häufigkeit und dem Weg zur Behebung.
• Ereignisse: was in Ihrem Konto passiert ist (ein bezahltes Angebot, ein neu angelegter Kunde) und was Cord an jeden Endpoint zugestellt hat, mit der Möglichkeit, erneut zu senden.
• Webhooks: Ihre Endpoints, ihre Erfolgsquote und der Zustellverlauf mit dem, was Cord gesendet und was Ihr Server geantwortet hat.
• Shell: Testen Sie jede API-Operation mit Ihrer Sitzung, ohne einen Schlüssel zu erstellen. Im Modus Test kann sie Daten in Ihrer Testumgebung erstellen und ändern; im Modus Live liest sie nur. Sie liefert Ihnen einsatzbereiten Code in cURL, Node, JavaScript oder Python.
• Schlüssel: Erstellen, rotieren und widerrufen Sie API-Schlüssel, und sehen Sie die autorisierten Verbindungen: Zapier, Make, das Gmail-Add-on und jede per OAuth verbundene App.
• Zustand: die Liste dessen, was Ihre Integration beeinträchtigen kann, etwa ein Endpoint, der häufig fehlschlägt, oder ein Schlüssel, der bald abläuft.

In der oberen Leiste sucht der Inspektor (Taste /) jede req_…, evt_… oder die ID eines Angebots, einer Rechnung, eines Kunden, eines Produkts, eines Schlüssels oder eines Webhooks.

Was Cord speichert und wie lange

Zu jeder API-Anfrage speichert Cord ihre technischen Daten: Methode, Pfad, Status, Latenz, IP, den Schlüssel, der sie gestellt hat, die Request-ID, Fehlercode und Fehlermeldung, die Version, die Herkunft und den Idempotency-Key. Den Body der Anfrage oder der Antwort speichert Cord nie, damit keine Daten Ihrer Kunden gespeichert werden.

Die Protokolle werden 30 Tage aufbewahrt. Wenn Sie einen längeren Verlauf benötigen, speichern Sie in Ihrem System die Request-ID, die jede Antwort im Header Cord-Request-Id zurückgibt.

Häufige Fragen

Verbrauchen die Workbench oder die Shell mein API-Kontingent? Nein. Es zählen nur Anfragen, die Sie mit Live-Schlüsseln stellen.

Ich sehe eine Anfrage nicht, die ich mit einem Testschlüssel gestellt habe. Die Workbench zeigt die Umgebung, in der sich die App gerade befindet. Wechseln Sie in die Testumgebung, um zu sehen, was Ihre sk_test_-Schlüssel getan haben.

Warum sehe ich den Zustellverlauf eines Webhooks nicht? Verlauf, Wiederholen und erneutes Senden sind ab dem Professional-Tarif enthalten.

Die vollständige Anleitung finden Sie in der Dokumentation der Workbench.