Aller au contenu
NouveauDécouvrir comment

Surveiller les clés API : journaux et utilisation

Inspectez les journaux de requêtes de l'API développeur et les statistiques d'utilisation — nombre de requêtes par clé et par route, taux d'erreur et latence — pour déboguer vos intégrations et repérer les abus.

Tutoriels
Développeur & CLI
min de lecture
6 min
étapes
6 · Intermédiaire

  1. Ce que vous pouvez surveiller

    Les requêtes de chaque clé API Developer : nombres par clé et par route, taux d'erreur, latence, et journaux de requêtes individuelles avec identifiants de requête.

  2. Ouvrir Settings → API

    La section API comporte trois onglets : API Keys, Logs, et Usage. Cette section est réservée aux admins/propriétaires : les autres rôles voient un message indiquant que la gestion des clés est restreinte.

  3. Lire l'onglet Usage

    Des totaux sur une fenêtre glissante (par défaut 7 jours) : nombre total de requêtes et taux d'erreur global, puis une répartition par clé et par route pour voir quelle clé ou quel endpoint génère du trafic et des erreurs.

    Lire l'onglet Usage

  4. Approfondir dans l'onglet Logs

    Chaque ligne de requête affiche la méthode, le schéma de route, le statut HTTP, la latence (ms), le préfixe de clé à l'origine de la requête, un code d'erreur (le cas échéant), et un identifiant de requête pour le support.

  5. Déboguer une intégration défaillante

    Parcourez les Logs à la recherche de valeurs status hors 2xx, lisez le errorCode, et faites correspondre le keyPrefix à la clé responsable. Citez le requestId lorsque vous contactez le support.

  6. Repérer un abus ou un script emballé

    Un pic de requêtes d'une seule clé dans la répartition by key, ou un taux d'erreur qui grimpe dans Usage, est votre signal pour révoquer cette clé dans l'onglet API Keys et en réémettre une correctement délimitée en portée.

Astuces de pro

  • Commencez par Usage, puis descendez dans Logs

    Utilisez Usage pour voir l'ampleur du problème (quelle clé, quelle route, à quel point) puis passez à Logs pour les requêtes individuelles en échec. Une approche descendante est plus rapide que de parcourir des logs bruts.

  • L'identifiant de requête est ce dont le support a besoin

    Copiez l'identifiant de requête d'une ligne de log en échec plutôt que de décrire « une erreur 500 plus tôt aujourd'hui » : c'est le moyen le plus rapide d'obtenir de l'aide.

  • Vérifiez les scopes avant d'accuser l'API

    Un taux d'erreur croissant sur une clé signifie généralement une hypothèse périmée dans cette intégration (champ renommé, scope révoqué) : vérifiez d'abord les scopes de cette clé.

  • Vérifiez le rôle avant de déboguer un accès

    Seuls les admins/propriétaires voient cette section ; si un coéquipier « ne trouve pas les logs API », vérifiez son rôle avant de supposer un problème.

Questions fréquentes

FirstSales expose-t-il les logs des requêtes API ?

Oui : Settings → API → Logs affiche, par requête, la méthode, la route, le statut, la latence, le préfixe de clé, le code d'erreur, et un identifiant de requête.

Où voir à quel point mes clés sont utilisées ?

L'onglet Usage : requêtes totales, taux d'erreur, et répartitions par clé et par route sur une fenêtre glissante (7 jours par défaut).

Qui peut consulter les logs et l'usage de l'API ?

Uniquement les admins et propriétaires de l'organisation. Les autres rôles voient un message indiquant que la gestion des clés est réservée aux admins/propriétaires.

Comment déboguer un appel API en échec ?

Dans Logs, trouvez la requête via un statut hors 2xx, lisez son errorCode, notez le keyPrefix et le requestId, et partagez cet identifiant avec le support.

Une clé semble compromise : que faire ?

Révoquez-la dans l'onglet API Keys et émettez-en une nouvelle avec uniquement les scopes nécessaires ; surveillez les comptages par clé dans Usage pour confirmer que le trafic s'arrête.

Puis-je changer la fenêtre d'usage ?

La vue Usage utilise par défaut les 7 derniers jours. Utilisez l'onglet Logs (avec ses filtres) pour une inspection plus fine, requête par requête.

Développeur & CLI

Une prospection qui continue quand vous vous déconnectez.Leads, emails, relances et réponses, gérés.

Connectez des boîtes illimitées et laissez les agents IA trouver les leads, écrire chaque email et relancer. Ou envoyez vos propres modèles en mode manuel. À partir de $29/mois.

Démarrez votre essai à $1 Voir les tarifs

$1 pour 3 jours · Annulez quand vous voulez · Sans engagement

Installer avec l'IA

Votre agent de code installe la CLI et les skills FirstSales pour vous.

Prompt pour 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 ↗