Zum Inhalt springen
NeuSo funktioniert es

API-Schlüssel überwachen: Protokolle & Nutzung

Untersuchen Sie Entwickler-API-Anfrageprotokolle und Nutzungsstatistiken — Anfragenzahlen pro Schlüssel und Route, Fehlerraten und Latenz —, um Integrationen zu debuggen und Missbrauch zu erkennen.

Tutorials
Entwickler & CLI
Min. Lesezeit
6 min
Schritte
6 · Fortgeschritten

  1. Was Sie überwachen können

    Die Anfragen jedes Developer API Keys: Zählungen pro Key und pro Route, Fehlerquote, Latenz und einzelne Anfrage-Logs mit Request-IDs.

  2. Settings → API öffnen

    Der API-Bereich hat drei Tabs: API Keys, Logs und Usage. Dieser Bereich ist nur für Admins/Owner zugänglich: andere Rollen sehen einen Hinweis, dass die Key-Verwaltung eingeschränkt ist.

  3. Den Tab Usage lesen

    Summen über ein rollierendes Zeitfenster (Standard 7 Tage): Gesamtanzahl der Anfragen und die allgemeine Fehlerquote, dann eine Aufschlüsselung nach Key und nach Route, damit Sie sehen können, welcher Key oder Endpunkt Traffic und Fehler verursacht.

    Den Tab Usage lesen

  4. In den Tab Logs eintauchen

    Jede Anfragezeile zeigt die Methode, das Routen-Muster, den HTTP-Status, die Latenz (ms), das Key-Präfix, das die Anfrage ausgelöst hat, einen Fehlercode (falls vorhanden) und eine Request-ID für den Support.

  5. Eine fehlerhafte Integration debuggen

    Durchsuchen Sie Logs nach Nicht-2xx-status-Werten, lesen Sie den errorCode und ordnen Sie den keyPrefix dem verantwortlichen Key zu. Geben Sie die requestId an, wenn Sie den Support kontaktieren.

  6. Missbrauch oder ein außer Kontrolle geratenes Skript erkennen

    Ein Anstieg der Anfragen eines einzelnen Keys in der Aufschlüsselung by key oder eine steigende Fehlerquote in Usage ist Ihr Signal, diesen Key im Tab API Keys zu widerrufen und einen korrekt eingeschränkten neu auszustellen.

Profi-Tipps

  • In Usage beginnen, dann in Logs eintauchen

    Nutzen Sie Usage, um das Ausmaß des Problems zu erkennen (welcher Key, welche Route, wie schlimm) und springen Sie dann zu Logs für die einzelnen fehlgeschlagenen Anfragen. Top-down ist schneller, als rohe Logs zu durchscrollen.

  • Die Request-ID ist, was der Support braucht

    Kopieren Sie die Request-ID aus einer fehlgeschlagenen Log-Zeile, statt "einen 500er von heute Vormittag" zu beschreiben: das ist der schnellste Weg zur Hilfe.

  • Scopes prüfen, bevor Sie der API die Schuld geben

    Eine steigende Fehlerquote bei einem Key deutet meist auf eine veraltete Annahme in dieser Integration hin (umbenanntes Feld, widerrufener Scope): prüfen Sie zuerst die Scopes dieses Keys.

  • Rolle prüfen, bevor Sie einen Zugriffsfehler debuggen

    Nur Admins/Owner sehen diesen Bereich; wenn ein Teammitglied "die API-Logs nicht findet", prüfen Sie zuerst dessen Rolle, bevor Sie einen Fehler vermuten.

Häufig gestellte Fragen

Bietet FirstSales API-Request-Logs?

Ja: Settings → API → Logs zeigt pro Anfrage Methode, Route, Status, Latenz, Key-Präfix, Fehlercode und eine Request-ID.

Wo sehe ich, wie viel meine Keys genutzt werden?

Der Tab Usage: Gesamtanzahl der Anfragen, Fehlerquote sowie Aufschlüsselungen nach Key und nach Route über ein rollierendes Zeitfenster (standardmäßig 7 Tage).

Wer kann API-Logs und Usage einsehen?

Nur Organisations-Admins und -Owner. Andere Rollen sehen einen Hinweis, dass die Key-Verwaltung nur Admins/Ownern vorbehalten ist.

Wie debugge ich einen fehlgeschlagenen API-Aufruf?

Finden Sie in Logs die Anfrage anhand eines Nicht-2xx-Status, lesen Sie deren errorCode, notieren Sie keyPrefix und requestId und teilen Sie diese ID dem Support mit.

Ein Key wirkt kompromittiert: was tue ich?

Widerrufen Sie ihn im Tab API Keys und stellen Sie einen neuen mit nur den benötigten Scopes aus; beobachten Sie die Zählungen pro Key in Usage, um zu bestätigen, dass der Traffic stoppt.

Kann ich das Usage-Zeitfenster ändern?

Die Usage-Ansicht zeigt standardmäßig die letzten 7 Tage. Nutzen Sie den Tab Logs (mit seinen Filtern) für engere Untersuchungen auf Anfrageebene.

Entwickler & CLI

Akquise, die weiterläuft, wenn du offline bist.Leads, E-Mails, Follow-ups und Antworten, erledigt.

Verbinde unbegrenzte Postfächer und lass KI-Agenten Leads finden, jede E-Mail schreiben und nachfassen. Oder sende deine eigenen Vorlagen im manuellen Modus. Ab $29/Monat.

Starte deine $1-Testphase Preise ansehen

$1 für 3 Tage · Jederzeit kündbar · Kein Vertrag

Mit KI installieren

Dein Coding-Agent richtet die FirstSales CLI und Skills für dich ein.

Prompt für Claude Code

I'm setting up FirstSales (https://firstsales.io), an AI outbound sales platform: campaigns, contacts, a reply inbox, deliverability and lead signals. Help me get my workspace sending real, good emails end to end, from Claude Code.

Read these first so you know how FirstSales works:
- Developer docs and API: https://developer.firstsales.io
- CLI: https://www.npmjs.com/package/@firstsales.io/cli
- Skills for coding agents: https://github.com/firstsalesio/firstsales-skills (read README.md and GUIDE.md)

Setup
1. Install the CLI: npm install -g @firstsales.io/cli
2. Install the FirstSales skills:
   claude plugin marketplace add firstsalesio/firstsales-skills
   claude plugin install firstsales@firstsales
3. Ask me if I already have a FirstSales account. If not, send me to https://app.firstsales.io to sign up.
4. Ask me to create an API key under Settings → API → API Keys, with only the scopes we need.
   Never ask me to paste the key into this chat. Tell me to run this in my own terminal, so the key stays hidden:
   read -rs FS_KEY && firstsales auth login --api-key "$FS_KEY"; unset FS_KEY
5. Run `firstsales whoami` and tell me which workspace and organisation we are connected to.

Then ask me about my business: what I sell, who I sell to (roles, company size, countries), my best customers, and what I use today for outbound (tools, lists, mailboxes). Walk me through:
1. Teaching FirstSales my business: website, offer, proof points and case studies in the knowledge base, so the AI writes like someone who knows the product.
2. Connecting my sending mailboxes and checking my sending domain: SPF, DKIM, DMARC and warm-up. If anything is unhealthy, tell me the exact DNS record to add.
3. Bringing in contacts: import my CSV or CRM export into a clean list, remove duplicates and bad emails, and block domains I must never email (customers, competitors, my own).
4. Building my first campaign: the right list, senders, steps and timing. Write the sequence with me, show me the drafts, and do not launch until I say yes.
5. Setting up Signals if it fits: find people engaging with LinkedIn posts about topics my buyers care about, and turn them into leads.
6. Inviting my team and giving each person the right access.

Once campaigns run, show me how to work the reply inbox from here: which replies need an answer, draft responses in my voice, and move good conversations into deals. If I use Cal.com, connect it so follow-ups can offer my booking link (not the first email).

Throughout, as you learn about my business, proactively suggest and help create:
- Reply templates for the questions and objections my prospects are likely to raise, based on my product, site and codebase if you can see them.
- Campaign ideas and segments worth testing, with the reason for each.

Safety rules:
- Show every change as a dry run (--dry-run) first and wait for my yes. Never send emails, launch campaigns or delete anything without my yes.
- Tell me before anything that spends credits, and how many.

Be opinionated. If the docs give a sensible default, just use it. Don't make me choose between five options.
Developer docs ↗npm: @firstsales.io/cli ↗GitHub: firstsales-skills ↗