Die Cord-CLI verwenden
Die Cord-CLI (@flouviahq/cli) ist das Terminal-Tool, mit dem Sie Cord in Ihr Projekt integrieren. Sie arbeitet nur im Testmodus: Nichts, was Sie damit tun, berührt echte Daten.
Der schnellste Weg: der Assistent
npx @flouviahq/cliEr führt Sie Schritt für Schritt mit Menüs durch alles: Er verbindet Ihr Terminal, richtet Ihr Konto mit KI ein, integriert Ihr Projekt (installiert das SDK, legt die Routen an und speichert die Schlüssel in Ihrer .env.local) und startet einen Listener für die Webhooks. Am Ende zeigt er Ihnen eine Zusammenfassung dessen, was eingerichtet ist.
Installieren und anmelden
npm install -g @flouviahq/cli
cord logincord login öffnet Ihren Browser mit einem Bestätigungscode. Prüfen Sie, ob er mit dem Code in Ihrem Terminal übereinstimmt, und klicken Sie auf Autorisieren. Sie benötigen im Unternehmen die Berechtigung Einstellungen. Das Terminal erhält automatisch einen eingeschränkten Testschlüssel: Er kann die Simulatoren verwenden, Ereignisse lesen und Konfigurationen vorschlagen und läuft nach 90 Tagen ab. Er erscheint im Tab Schlüssel der Entwickler-Workbench als CLI · <Ihr Rechner>, wo Sie ihn widerrufen können.
- Sie arbeiten per SSH ohne Browser?
cord login --no-browsergibt die Adresse aus, damit Sie sie auf einem anderen Gerät öffnen. - Sie möchten lieber einen eigenen Schlüssel einfügen?
cord login --api-key.
Die wichtigsten Befehle
| Befehl | Wofür |
|---|---|
cord setup |
Schlägt die Konfiguration Ihres Kontos anhand Ihrer Website und Ihrer Preisliste vor. Sie bestätigen sie im Browser. |
cord init |
Erkennt Ihr Framework und legt die Webhook-Route mit verifizierter Signatur an. |
cord listen --forward-to http://localhost:3000/api/webhooks/cord |
Leitet die Test-Webhooks an Ihren lokalen Server weiter. |
cord trigger quote.approved |
Löst ein Testereignis aus. |
cord simulate fiscal pac_caido |
Die nächste Testrechnung schlägt fehl, als ob der PAC nicht antworten würde. |
cord events tail |
Zeigt Ereignisse an, sobald sie eintreten. |
cord whoami / cord logout |
Zeigt das verbundene Unternehmen an / löscht den gespeicherten Schlüssel. |
Häufige Probleme
- „Der Code ist abgelaufen“: Der Code gilt 10 Minuten. Führen Sie
cord loginerneut aus. - „Das ist ein Live-Schlüssel“: Die CLI lehnt
sk_live_-Schlüssel absichtlich ab. Verwenden Sie einen Testschlüssel. - Sie sehen den Autorisierungsbildschirm nicht: Ihr Benutzer benötigt im Unternehmen die Berechtigung Einstellungen. Bitten Sie Ihren Administrator darum.
Weitere Details im Leitfaden zur CLI.