Pour accéder directement à l’API, transmettez une clé API personnelle dans l’en-tête X-API-Key. L’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.
X-API-Key: insyder_live_your_key_hereLes requêtes sans authentification valide renvoient 401. N’envoyez jamais une clé dans une URL ou un paramètre de requête.
Dans Insyder, ouvrez Préférences → Accès API, puis :
- Donnez un nom explicite à la clé.
- Sélectionnez les espaces de travail auxquels elle peut accéder.
- Choisissez un profil d’autorisations ou des autorisations individuelles.
- Choisissez une date d’expiration.
- Créez la clé et copiez-la immédiatement.
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é.
| Autorisation | Accès accordé |
|---|---|
data:read | Consulter les données, statistiques et résultats de connexion expurgés des données sensibles des espaces sélectionnés |
leads:write | Modifier le statut, l’adresse e-mail, le téléphone et les notes d’un prospect existant |
products:write | Créer, modifier et archiver des produits ; le rôle actuel OWNER ou ADMIN est également requis |
purchases:write | Ajouter des achats non modifiables |
exports:create | Créer et annuler des exports ; data:read est également requis |
Les profils Lecture seule et Accès métier complet sélectionnent des combinaisons courantes d’autorisations. Utilisez Personnalisé lorsqu’une intégration nécessite moins d’accès.
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 :
- La clé est active et n’a pas expiré.
- L’espace de travail demandé a été explicitement sélectionné pour cette clé.
- Le propriétaire de la clé est toujours membre de l’espace de travail.
- La clé dispose des autorisations nécessaires à l’opération.
- Le rôle actuel du propriétaire dans l’espace de travail autorise l’opération.
Les ressources situées hors des espaces autorisés pour la clé renvoient la même réponse 404 que les ressources inexistantes. Cela évite de divulguer des informations sur d’autres espaces de travail.
- Stockez les clés dans un gestionnaire de secrets côté serveur ou une configuration d’environnement chiffrée.
- 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.
- Utilisez une clé distincte pour chaque intégration et chaque environnement.
- Renouvelez immédiatement une clé qui a pu être exposée ; l’ancien secret cesse de fonctionner dès la fin du renouvellement.
- Révoquez les clés inutilisées et privilégiez une date d’expiration plutôt qu’une clé permanente.
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.
Utilisez la même clé personnelle pour connecter le MCP natif à Claude Desktop, ChatGPT ou un autre assistant. Le MCP de documentation est un serveur distinct, public, qui n’a jamais besoin de votre clé.
Ensuite, effectuez votre première requête API ou ouvrez la référence API.