# Context pack: Dépannage Source: https://nordvec.com/fr/docs/guides/troubleshooting Pack: https://nordvec.com/fr/docs/packs/troubleshooting This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow. ## Contents 1. [Erreurs et limites de débit](https://nordvec.com/fr/docs/guides/errors-and-rate-limits) (builds on) 2. [Dépannage](https://nordvec.com/fr/docs/guides/troubleshooting) (this guide) 3. [Reconnecter un connecteur](https://nordvec.com/fr/docs/guides/troubleshooting/reconnect-integration) (linked from this guide) 4. [Accordez les autorisations manquantes](https://nordvec.com/fr/docs/guides/troubleshooting/insufficient-scopes) (linked from this guide) 5. [Limite de documents atteinte](https://nordvec.com/fr/docs/guides/troubleshooting/document-limit) (linked from this guide) 6. [Limite quotidienne de traitement atteinte](https://nordvec.com/fr/docs/guides/troubleshooting/daily-processing-limit) (linked from this guide) --- # Erreurs et limites de débit Source: https://nordvec.com/fr/docs/guides/errors-and-rate-limits L'enveloppe d'erreur unique que chaque requête échouée retourne, les en-têtes de limite de débit, et comment réessayer une écriture en toute sécurité. Chaque point de terminaison échoue de la même manière, donc un client gère les erreurs, les limites de débit et les nouvelles tentatives une seule fois et réutilise ce code partout, y compris via [MCP](/docs/guides/mcp). ## L'enveloppe d'erreur [#lenveloppe-derreur] Chaque réponse non-2xx est un objet JSON unique : ```json { "defined": false, "code": "TOO_MANY_REQUESTS", "message": "Too many requests", "data": { "reason": "rate_limit.exceeded", "retryAfterMs": 12000 } } ``` * `code` est l'erreur au niveau HTTP, par exemple `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `BAD_REQUEST` ou `TOO_MANY_REQUESTS`. * `data.reason`, lorsqu'il est présent, est une raison plus précise lisible par machine, comme `auth.key_not_found` ou `rate_limit.exceeded`. Effectuez une branche sur celui-ci plutôt que sur `message`, qui est destiné aux utilisateurs et peut changer. * `defined` est `true` lorsque l'opération répertorie cette erreur dans la [référence de l'API](/docs/api), et `false` pour les erreurs que toute requête peut rencontrer (authentification, limites de débit, une route inconnue). * Un échec de validation répond `BAD_REQUEST` avec les problèmes dans `data.formErrors` et `data.fieldErrors`. Chaque réponse comporte également un `X-Request-ID`. Citez-le lorsque vous contactez le support, et nous pourrons retrouver cette requête exacte. ## Statuts courants [#statuts-courants] | Statut | Code | Que faire | | ------ | ----------------------- | ----------------------------------------------------------------------------------- | | `400` | `BAD_REQUEST` | Corrigez la requête ; `data.fieldErrors` nomme les champs | | `401` | `UNAUTHORIZED` | Envoyez une clé ou une session valide | | `403` | `FORBIDDEN` | La clé ne dispose pas de l'étendue ou du rôle requis par l'opération | | `404` | `NOT_FOUND` | La ressource n'existe pas, ou vous n'êtes pas autorisé à la voir | | `409` | `CONFLICT` | Une écriture en double est toujours en cours ; réessayez sous peu | | `413` | `PAYLOAD_TOO_LARGE` | Le corps de la requête dépasse 1 Mo ; divisez un envoi en masse en lots plus petits | | `422` | `UNPROCESSABLE_CONTENT` | La requête est bien formée mais ne peut pas être appliquée | | `429` | `TOO_MANY_REQUESTS` | Attendez `Retry-After`, puis réessayez | ## Limites de débit [#limites-de-débit] Chaque réponse indique la limite contre laquelle elle a été comptabilisée, sous deux formes : * les en-têtes `X-RateLimit-*` ; * les champs structurés IETF `RateLimit` (état en direct : `r` est le nombre de requêtes restantes, `t` le nombre de secondes avant la réinitialisation de la fenêtre) et `RateLimit-Policy` (le quota : `q` est la limite, `w` la fenêtre en secondes). Une réponse `429` comporte également `Retry-After` en secondes et `data.retryAfterMs`. Attendez au moins ce délai avant la requête suivante ; une nouvelle tentative plus tôt est comptabilisée et refusée à nouveau. ## Réessayer les écritures en toute sécurité [#réessayer-les-écritures-en-toute-sécurité] Une opération d'écriture qui répertorie un en-tête `Idempotency-Key` dans la [référence de l'API](/docs/api) peut être réessayée sans effectuer le travail deux fois. Envoyez une clé par écriture logique et répétez la même clé à chaque nouvelle tentative : * la même clé avec le même corps dans les 24 heures rejoue la réponse stockée ; * la même clé avec un corps différent est refusée avec `422` ; * un doublon qui arrive alors que la première tentative est toujours en cours reçoit `409`. Une opération sans cet en-tête n'est pas idempotente, donc ne la réessayez que lorsque vous savez que la première tentative n'a pas abouti. --- # Dépannage Source: https://nordvec.com/fr/docs/guides/troubleshooting Solutions pour les erreurs de synchronisation et les limites de votre plan que vous pouvez rencontrer, chacune commençant par le message que vous voyez. Chaque page commence par le message que Nordvec vous affiche, explique pourquoi il apparaît et vous guide à travers la solution. Pour les erreurs renvoyées par une requête API, consultez [Erreurs et limites de débit](/docs/guides/errors-and-rate-limits). - [Reconnecter un connecteur](https://nordvec.com/fr/docs/guides/troubleshooting/reconnect-integration): Résolvez les erreurs de synchronisation « l'authentification a expiré » et « l'accès a été révoqué » en reconnectant le connecteur concerné. - [Accordez les autorisations manquantes](https://nordvec.com/fr/docs/guides/troubleshooting/insufficient-scopes): Résolvez les erreurs de synchronisation « autorisations requises manquantes » en reconnectant le connecteur et en approuvant chaque autorisation demandée. - [Limite de documents atteinte](https://nordvec.com/fr/docs/guides/troubleshooting/document-limit): Ce qui se passe lorsque la limite de documents de votre formule met en pause la synchronisation, et comment libérer de l'espace ou effectuer une mise à niveau pour la reprendre. - [Limite quotidienne de traitement atteinte](https://nordvec.com/fr/docs/guides/troubleshooting/daily-processing-limit): Ce qui se passe lorsque la limite quotidienne de traitement de votre espace de travail met en pause la synchronisation, et quand elle reprend. --- # Reconnecter un connecteur Source: https://nordvec.com/fr/docs/guides/troubleshooting/reconnect-integration Résolvez les erreurs de synchronisation « l'authentification a expiré » et « l'accès a été révoqué » en reconnectant le connecteur concerné. Lorsque une synchronisation signale **« Votre authentification a expiré »** ou **« Votre accès a été révoqué »**, Nordvec ne peut plus agir en votre nom auprès du fournisseur. La connexion elle-même doit être renouvelée ; relancer la synchronisation sans reconnecter le connecteur ne résoudra pas le problème. ## Pourquoi cela se produit [#pourquoi-cela-se-produit] * Le fournisseur a expiré le justificatif de longue durée que Nordvec détient. Certains fournisseurs le font selon un calendrier fixe, d'autres après une période d'inactivité. * Vous avez modifié votre mot de passe auprès du fournisseur, ce qui révoque généralement toutes les applications connectées. * Vous (ou un administrateur de l'espace de travail) avez révoqué l'accès de Nordvec depuis les paramètres de sécurité ou des applications connectées du fournisseur. * Le fournisseur a modifié sa politique de sécurité (par exemple, après une activité suspecte sur votre compte) et a invalidé les autorisations existantes. ## Comment résoudre le problème [#comment-résoudre-le-problème] 1. Ouvrez **Connecteurs** dans Nordvec. 2. Trouvez le connecteur concerné. Il affiche l'état d'erreur signalé par la dernière synchronisation, ainsi qu'un bouton **Reconnecter** sur sa carte. 3. Choisissez **Reconnecter** et connectez-vous au fournisseur avec le **même compte** que celui que vous aviez initialement connecté. Approuvez toutes les autorisations listées par le fournisseur ; en refuser une entraîne une [erreur de permissions manquantes](/docs/guides/troubleshooting/insufficient-scopes) à la place. La reconnexion est également disponible à tout moment depuis les détails du connecteur, pas seulement après une erreur. Reconnecter conserve tout ce qui a déjà été synchronisé. N'utilisez pas **Déconnecter** pour résoudre une authentification expirée : la déconnexion supprime définitivement tous les documents que le connecteur a synchronisés. Si vous vous connectez avec un compte différent de celui avec lequel le connecteur a été configuré, Nordvec refuse la reconnexion et ne modifie rien. Pour changer de compte, déconnectez le connecteur et connectez l'autre compte à la place. ### Connecteurs qui ne peuvent pas être reconnectés sur place [#connecteurs-qui-ne-peuvent-pas-être-reconnectés-sur-place] Guru, Notion, Zendesk, Freshdesk, Trello et e-conomic n'offrent pas l'option **Reconnecter**, car Nordvec ne peut pas confirmer qu'une nouvelle connexion appartient au même compte. Pour ceux-ci, déconnectez le connecteur et reconnectez-le. La déconnexion supprime les documents qu'il a synchronisés, et la synchronisation suivante les importe à nouveau depuis le début. ## Ce qui se passe après la reconnexion [#ce-qui-se-passe-après-la-reconnexion] La nouvelle connexion remplace l'ancienne et l'erreur disparaît. Une synchronisation démarre immédiatement, et les documents qui ont échoué pendant que la connexion était inactive sont réessayés ; les éléments listés sous **« Éléments qui n'ont pas pu être importés »** disparaissent au fur et à mesure qu'ils sont importés avec succès. Les connecteurs sont connectés par utilisateur : la reconnexion renouvelle *votre* connexion et n'affecte pas celles des autres. Seul la personne qui a connecté un connecteur peut le reconnecter, et cela inclut les administrateurs de l'espace de travail : un administrateur ne peut pas reconnecter le connecteur d'un collègue. --- # Accordez les autorisations manquantes Source: https://nordvec.com/fr/docs/guides/troubleshooting/insufficient-scopes Résolvez les erreurs de synchronisation « autorisations requises manquantes » en reconnectant le connecteur et en approuvant chaque autorisation demandée. Lorsqu'une synchronisation signale **« Votre compte ne dispose pas des autorisations requises »**, la connexion au fournisseur fonctionne, mais elle a été accordée avec moins d'autorisations (étendues OAuth) que le connecteur n'en a besoin pour lire votre contenu. Cette situation est une propriété de l'autorisation elle-même, donc la seule solution consiste à refaire la connexion avec l'ensemble complet des autorisations. ## Pourquoi cela se produit [#pourquoi-cela-se-produit] * Une autorisation a été refusée lors du flux de connexion d'origine. Certains fournisseurs vous permettent de décocher des autorisations individuelles sur l'écran de consentement. * Le connecteur a acquis une nouvelle fonctionnalité nécessitant une autorisation supplémentaire, et votre ancienne autorisation est antérieure à cette mise à jour. * Un administrateur d'espace de travail a restreint les autorisations que les applications tierces peuvent détenir, ou le fournisseur exige une approbation de l'administrateur pour certaines d'entre elles. ## Comment résoudre le problème [#comment-résoudre-le-problème] 1. Ouvrez **Connecteurs** dans Nordvec. 2. Repérez le connecteur concerné et choisissez **Reconnecter** sur sa carte. 3. Connectez-vous avec le même compte que celui utilisé à l'origine, et sur l'écran de consentement du fournisseur, approuvez **toutes** les autorisations demandées. Chacune d'entre elles correspond à un besoin concret, généralement la lecture des documents, fichiers ou messages que le connecteur synchronise. Il n'y a pas d'options supplémentaires dans la liste. La reconnexion conserve les documents déjà synchronisés. Guru, Notion, Zendesk, Freshdesk, Trello et e-conomic ne peuvent pas être reconnectés directement. Pour ceux-ci, déconnectez puis reconnectez le connecteur, ce qui supprimera les documents synchronisés et les importera à nouveau depuis le début. Si l'écran de consentement indique qu'un administrateur doit approuver l'application, transmettez la demande à votre administrateur d'espace de travail. Les fournisseurs avec des flux de consentement administrateur (par exemple, les organisations Google Workspace et Microsoft 365, ou les espaces de travail Slack avec approbation des applications) bloquent l'autorisation jusqu'à ce qu'un administrateur l'approuve. Une reconnexion avant cette approbation produira la même erreur. ## Que se passe-t-il après la reconnexion [#que-se-passe-t-il-après-la-reconnexion] La nouvelle autorisation remplace l'ancienne, l'erreur disparaît et une synchronisation démarre immédiatement. Les éléments qui avaient précédemment échoué en raison d'erreurs d'autorisation sont réessayés. --- # Limite de documents atteinte Source: https://nordvec.com/fr/docs/guides/troubleshooting/document-limit Ce qui se passe lorsque la limite de documents de votre formule met en pause la synchronisation, et comment libérer de l'espace ou effectuer une mise à niveau pour la reprendre. Lorsque une synchronisation affiche **« Vous avez atteint la limite de documents de votre abonnement »**, la connexion est saine et aucune erreur ne s'est produite chez le fournisseur. Votre corpus a simplement atteint le nombre maximal de documents autorisé par votre abonnement, ce qui a mis en pause l'importation plutôt que de supprimer du contenu silencieusement. ## Ce que couvre la limite [#ce-que-couvre-la-limite] La limite comptabilise les documents stockés dans votre corpus, toutes sources confondues : synchronisations de connecteurs, téléversements et documents envoyés via l'API. Elle existe pour maintenir les coûts d'indexation et de recherche prévisibles. Il s'agit d'une allocation par espace de travail, et non par connecteur. ## Comment reprendre la synchronisation [#comment-reprendre-la-synchronisation] Effectuez l'une des actions suivantes : * **Libérez de l'espace.** Supprimez les documents dont vous n'avez plus besoin, ou déconnectez une source dont le contenu ne doit pas être indexé. La suppression d'un document le retire immédiatement de l'index. * **Passez à un abonnement supérieur ou ajoutez des postes.** L'allocation est définie par poste, et les abonnements supérieurs autorisent plus de documents par poste. Aucun redémarrage manuel n'est nécessaire par la suite : la prochaine synchronisation planifiée détecte l'espace libéré et reprend là où elle s'était arrêtée. Vous pouvez également déclencher manuellement une synchronisation depuis la carte du connecteur une fois l'espace disponible. ## Que deviennent les documents qui n'ont pas pu être importés [#que-deviennent-les-documents-qui-nont-pas-pu-être-importés] Aucune donnée n'est perdue à la source, le fournisseur reste le système de référence. Les documents qui n'ont pas pu être importés sont récupérés lors de la prochaine synchronisation réussie, dès que la capacité le permet. --- # Limite quotidienne de traitement atteinte Source: https://nordvec.com/fr/docs/guides/troubleshooting/daily-processing-limit Ce qui se passe lorsque la limite quotidienne de traitement de votre espace de travail met en pause la synchronisation, et quand elle reprend. Lorsque une synchronisation affiche **« Votre espace de travail a atteint la limite de traitement quotidienne »**, la connexion est saine et aucun échec n'est survenu chez le fournisseur. Votre espace de travail a traité autant de nouveau contenu en une journée que sa limite le permet, donc l'importation s'est mise en pause plutôt que de continuer à rejeter les éléments un par un. ## Ce que couvre la limite [#ce-que-couvre-la-limite] La limite comptabilise le contenu traité pour l'indexation, toutes sources confondues (synchronisations de connecteurs, téléversements, documents envoyés via l'API) sur une journée civile, mesurée en UTC. Elle existe pour éviter qu'une première synchronisation d'une source volumineuse ne s'exécute sans limite sur une seule journée. Le contenu inchangé n'est jamais comptabilisé à nouveau, donc après l'importation initiale, un espace de travail atteint rarement cette limite. La limite est une allocation par espace de travail qui s'adapte au nombre de postes. Chaque membre peut utiliser une partie de cette allocation par jour, de sorte qu'une seule personne ne peut pas épuiser toute l'allocation de l'espace de travail. ## Reprise de la synchronisation [#reprise-de-la-synchronisation] Aucune action n'est nécessaire. Le connecteur est programmé pour s'exécuter à nouveau après minuit UTC, lorsque l'allocation quotidienne est réinitialisée, et il reprend là où il s'était arrêté. Le message d'état disparaît lors de cette exécution. Vous pouvez également déclencher une synchronisation manuellement depuis la carte du connecteur. Elle reprendra là où la précédente s'était arrêtée une fois l'allocation disponible. ## Que devient le contenu non traité [#que-devient-le-contenu-non-traité] Aucune donnée n'est perdue à la source, le fournisseur reste le système de référence. Les éléments qui n'ont pas pu être traités aujourd'hui seront pris en charge par la prochaine exécution.