{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Démarrage rapide"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"quickstart","level":1,"__idx":0},"children":["Démarrage rapide "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les exemples ci-dessous utilisent ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["curl"]}," et une variable d’environnement. Avant de commencer, créez une clé avec les autorisations ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data:read"]}," et ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["leads:write"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"1-store-your-api-key","level":2,"__idx":1},"children":["1. Enregistrer votre clé API "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les clés API ne sont affichées qu’une seule fois, lors de leur création dans ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Préférences → Accès API"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Collez la clé à l’invite ; l’option ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-s"]}," masque la valeur à l’écran et évite de l’inclure dans la commande elle-même."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"read -s INSYDER_API_KEY\nexport INSYDER_API_KEY\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Conservez la clé côté serveur. Ne l’ajoutez jamais à un dépôt, à une URL ou au code exécuté dans le navigateur."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"2-list-accessible-accounts","level":2,"__idx":2},"children":["2. Lister les comptes accessibles "]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n  --url https://api.insyder.io/v1/accounts \\\n  --header \"X-API-Key: $INSYDER_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La réponse contient uniquement les espaces de travail sélectionnés pour la clé dont le propriétaire est toujours membre :"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"data\": [\n    {\n      \"account_id\": \"account_123\",\n      \"username\": \"example_brand\",\n      \"currency\": \"CHF\",\n      \"role\": \"owner\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"req_123\",\n    \"has_more\": false,\n    \"next_cursor\": null\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Conservez l’",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]}," pour les requêtes propres à un compte."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"3-list-leads","level":2,"__idx":3},"children":["3. Lister les prospects "]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n  --url \"https://api.insyder.io/v1/accounts/account_123/leads?limit=50\" \\\n  --header \"X-API-Key: $INSYDER_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lorsque ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["meta.has_more"]}," vaut ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", transmettez ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["meta.next_cursor"]}," sans le modifier dans la requête suivante :"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --get \\\n  --url https://api.insyder.io/v1/accounts/account_123/leads \\\n  --header \"X-API-Key: $INSYDER_API_KEY\" \\\n  --data-urlencode \"cursor=cursor_from_the_previous_response\" \\\n  --data-urlencode \"limit=50\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"4-update-a-lead","level":2,"__idx":4},"children":["4. Mettre à jour un prospect "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Seuls ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone"]}," et ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notes"]}," peuvent être modifiés. Les champs omis restent inchangés ; envoyer ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," efface un champ géré par l’utilisateur qui accepte une valeur nulle."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request PATCH \\\n  --url https://api.insyder.io/v1/accounts/account_123/leads/lead_456 \\\n  --header \"Content-Type: application/json\" \\\n  --header \"X-API-Key: $INSYDER_API_KEY\" \\\n  --data '{\n    \"status\": \"follow_up\",\n    \"notes\": \"Requested a follow-up next week\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"5-handle-limits-and-errors","level":2,"__idx":5},"children":["5. Gérer les limites et les erreurs "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les réponses réussies du routeur incluent ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Request-Id"]}," et les en-têtes de limitation. La limite est de 20 requêtes acceptées par fenêtre fixe d’une seconde UTC, toutes clés d’un même utilisateur confondues. Une requête dépassant cette limite renvoie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429"]}," avec ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Retry-After"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les erreurs utilisent ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/problem+json"]},". Lorsque vous contactez le support, conservez le ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Request-Id"]}," de la réponse, mais ne joignez jamais votre clé API ni de données sensibles de la requête."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Poursuivez avec l’",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/authentication"},"children":["authentification"]}," ou explorez la ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/openapi"},"children":["référence API"]}," complète."]}]},"headings":[{"value":"Démarrage rapide","id":"quickstart","depth":1},{"value":"1. Enregistrer votre clé API","id":"1-store-your-api-key","depth":2},{"value":"2. Lister les comptes accessibles","id":"2-list-accessible-accounts","depth":2},{"value":"3. Lister les prospects","id":"3-list-leads","depth":2},{"value":"4. Mettre à jour un prospect","id":"4-update-a-lead","depth":2},{"value":"5. Gérer les limites et les erreurs","id":"5-handle-limits-and-errors","depth":2}],"frontmatter":{"title":"Démarrage rapide","description":"Effectuez vos premières requêtes vers l’API publique Insyder.","seo":{"title":"Démarrage rapide"}},"lastModified":"2026-09-16T07:19:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}