{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Authentification"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"authentication","level":1,"__idx":0},"children":["Authentification "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pour accéder directement à l’API, transmettez une clé API personnelle dans l’en-tête ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-Key"]},". L’",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/zapier"},"children":["intégration Zapier"]}," utilise OAuth : connectez-vous à Insyder, sélectionnez un espace de travail et approuvez les autorisations. Vous n’avez pas besoin de créer ni de coller une clé API dans Zapier."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"X-API-Key: insyder_live_your_key_here\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les requêtes sans authentification valide renvoient ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]},". N’envoyez jamais une clé dans une URL ou un paramètre de requête."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"create-an-api-key","level":2,"__idx":1},"children":["Créer une clé API "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dans Insyder, ouvrez ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Préférences → Accès API"]},", puis :"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Donnez un nom explicite à la clé."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sélectionnez les espaces de travail auxquels elle peut accéder."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choisissez un profil d’autorisations ou des autorisations individuelles."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choisissez une date d’expiration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Créez la clé et copiez-la immédiatement."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le secret complet est affiché une seule fois. Insyder ne l’affiche plus ensuite. Une clé n’obtient jamais automatiquement l’accès aux espaces de travail ajoutés ultérieurement à votre compte. Vous pouvez conserver jusqu’à 10 clés actives et sélectionner jusqu’à 50 espaces de travail par clé."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"scopes","level":2,"__idx":2},"children":["Autorisations "]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Autorisation"},"children":["Autorisation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Accès accordé"},"children":["Accès accordé"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Consulter les données, statistiques et résultats de connexion expurgés des données sensibles des espaces sélectionnés"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["leads:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Modifier le statut, l’adresse e-mail, le téléphone et les notes d’un prospect existant"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Créer, modifier et archiver des produits ; le rôle actuel OWNER ou ADMIN est également requis"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["purchases:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ajouter des achats non modifiables"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["exports:create"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Créer et annuler des exports ; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data:read"]}," est également requis"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les profils ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lecture seule"]}," et ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accès métier complet"]}," sélectionnent des combinaisons courantes d’autorisations. Utilisez ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personnalisé"]}," lorsqu’une intégration nécessite moins d’accès."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"workspace-and-role-checks","level":2,"__idx":3},"children":["Vérification de l’espace de travail et du rôle "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une clé identifie son propriétaire ; l’API n’accepte jamais une identité utilisateur fournie dans les paramètres de la requête. Chaque requête vérifie tous les points suivants :"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La clé est active et n’a pas expiré."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["L’espace de travail demandé a été explicitement sélectionné pour cette clé."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Le propriétaire de la clé est toujours membre de l’espace de travail."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La clé dispose des autorisations nécessaires à l’opération."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Le rôle actuel du propriétaire dans l’espace de travail autorise l’opération."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les ressources situées hors des espaces autorisés pour la clé renvoient la même réponse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}," que les ressources inexistantes. Cela évite de divulguer des informations sur d’autres espaces de travail."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"store-and-rotate-keys-safely","level":2,"__idx":4},"children":["Stocker et renouveler les clés en toute sécurité "]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Stockez les clés dans un gestionnaire de secrets côté serveur ou une configuration d’environnement chiffrée."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ne les ajoutez jamais à un dépôt, ne journalisez pas les en-têtes de requête et n’exposez pas les clés dans du JavaScript côté client ou dans une application mobile."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Utilisez une clé distincte pour chaque intégration et chaque environnement."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Renouvelez immédiatement une clé qui a pu être exposée ; l’ancien secret cesse de fonctionner dès la fin du renouvellement."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Révoquez les clés inutilisées et privilégiez une date d’expiration plutôt qu’une clé permanente."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les modifications d’autorisations ou d’espaces de travail, l’expiration, le renouvellement, la révocation et les changements d’appartenance prennent effet immédiatement."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Utilisez la même clé personnelle pour ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/native-mcp"},"children":["connecter le MCP natif à Claude Desktop, ChatGPT ou un autre assistant"]},". Le ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp"},"children":["MCP de documentation"]}," est un serveur distinct, public, qui n’a jamais besoin de votre clé."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensuite, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/quickstart"},"children":["effectuez votre première requête API"]}," ou ouvrez la ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/openapi"},"children":["référence API"]},"."]}]},"headings":[{"value":"Authentification","id":"authentication","depth":1},{"value":"Créer une clé API","id":"create-an-api-key","depth":2},{"value":"Autorisations","id":"scopes","depth":2},{"value":"Vérification de l’espace de travail et du rôle","id":"workspace-and-role-checks","depth":2},{"value":"Stocker et renouveler les clés en toute sécurité","id":"store-and-rotate-keys-safely","depth":2}],"frontmatter":{"title":"Authentification","description":"Créez et utilisez en toute sécurité des clés API Insyder à autorisations limitées.","seo":{"title":"Authentification"}},"lastModified":"2026-09-16T07:19:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/authentication","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}