Tes clés d'API

Créer une clé

1. Ouvre ton avatar › Clés d'API et choisis Nouvelle clé d'API.
2. Nomme-la d'après ce qui l'utilisera, par exemple ton outil de reporting.
3. Choisis Lecture seule ou Lire et modifier.
4. Copie-la maintenant : la clé n'est affichée qu'une fois.

Ce qu'une clé peut faire

Une clé fait ce que tu peux faire dans cet espace de travail, pas plus : la clé d'un Owner voit tout, celle d'un partner manager voit ses propres partenaires, celle d'un partenaire ne voit que ses propres chiffres. Elle ne fait jamais ce que seule une personne connectée peut faire, comme gérer les clés, les mots de passe ou l'équipe.

Chaque modification faite avec une clé porte son nom dans le journal d'activité, par exemple « Clé d'API «BI» (créée par Maria) », pour que tu saches toujours ce qui est passé par l'API.

L'utiliser

Envoie-la à chaque appel à l'adresse de ton espace de travail, dans x-api-key ou en Authorization: Bearer. Les appels sont listés dans La référence de l'API.

Bon à savoir

• Le forfait HitCTRL de ton espace décide si les clés fonctionnent et combien d'appels par minute elles peuvent faire. Au-delà de la limite, la réponse est 429 avec Retry-After.
• Révoque une clé que tu n'utilises plus : elle s'arrête aussitôt et reste listée, pour que ses modifications gardent son nom.
• Les appels de suivi de ton serveur utilisent les clés propres de l'espace : voir Clés d'API.