# Context pack: Probleemoplossing Source: https://nordvec.com/nl/docs/guides/troubleshooting Pack: https://nordvec.com/nl/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. [Fouten en snelheidslimieten](https://nordvec.com/nl/docs/guides/errors-and-rate-limits) (builds on) 2. [Probleemoplossing](https://nordvec.com/nl/docs/guides/troubleshooting) (this guide) 3. [Verbind een connector opnieuw](https://nordvec.com/nl/docs/guides/troubleshooting/reconnect-integration) (linked from this guide) 4. [Verleen ontbrekende machtigingen](https://nordvec.com/nl/docs/guides/troubleshooting/insufficient-scopes) (linked from this guide) 5. [Documentlimiet bereikt](https://nordvec.com/nl/docs/guides/troubleshooting/document-limit) (linked from this guide) 6. [Dagelijkse verwerkingslimiet bereikt](https://nordvec.com/nl/docs/guides/troubleshooting/daily-processing-limit) (linked from this guide) --- # Fouten en snelheidslimieten Source: https://nordvec.com/nl/docs/guides/errors-and-rate-limits De foutenvelop die elke mislukte aanvraag retourneert, de snelheidslimiet-headers en hoe je een schrijfopdracht veilig opnieuw kunt proberen. Elke endpoint faalt op dezelfde manier, dus een client handelt fouten, snelheidslimieten en pogingen opnieuw af door die code één keer te schrijven en overal te hergebruiken, ook via [MCP](/docs/guides/mcp). ## De foutenvelop [#de-foutenvelop] Elke niet-2xx-respons is één JSON-object: ```json { "defined": false, "code": "TOO_MANY_REQUESTS", "message": "Too many requests", "data": { "reason": "rate_limit.exceeded", "retryAfterMs": 12000 } } ``` * `code` is de fout op HTTP-niveau, bijvoorbeeld `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `BAD_REQUEST` of `TOO_MANY_REQUESTS`. * `data.reason`, indien aanwezig, is een preciezere machineleesbare reden zoals `auth.key_not_found` of `rate_limit.exceeded`. Baseer je hierop in plaats van op `message`, dat voor mensen is en kan veranderen. * `defined` is `true` wanneer de bewerking die fout vermeldt in de [API-referentie](/docs/api), en `false` voor fouten die elke aanvraag kan tegenkomen (authenticatie, snelheidslimieten, een onbekende route). * Een validatiefout antwoordt met `BAD_REQUEST` en de problemen in `data.formErrors` en `data.fieldErrors`. Elke respons bevat ook een `X-Request-ID`. Vermeld deze wanneer je contact opneemt met support, zodat we die exacte aanvraag kunnen terugvinden. ## Gangbare statussen [#gangbare-statussen] | Status | Code | Wat te doen | | ------ | ----------------------- | ------------------------------------------------------------------------------ | | `400` | `BAD_REQUEST` | Corrigeer de aanvraag; `data.fieldErrors` benoemt de velden | | `401` | `UNAUTHORIZED` | Verstuur een geldige sleutel of sessie | | `403` | `FORBIDDEN` | De sleutel heeft niet de vereiste scope of rol voor de bewerking | | `404` | `NOT_FOUND` | De resource bestaat niet, of je hebt geen toestemming om deze te zien | | `409` | `CONFLICT` | Een dubbele schrijfbewerking is nog bezig; probeer het kort daarna opnieuw | | `413` | `PAYLOAD_TOO_LARGE` | De aanvraagbody is groter dan 1 MB; splits een bulkpush op in kleinere batches | | `422` | `UNPROCESSABLE_CONTENT` | De aanvraag is correct gevormd maar kan niet worden toegepast | | `429` | `TOO_MANY_REQUESTS` | Wacht `Retry-After`, probeer het dan opnieuw | ## Snelheidslimieten [#snelheidslimieten] Elke respons geeft de limiet aan waartegen deze is geteld, in twee vormen: * de `X-RateLimit-*` headers; * de IETF gestructureerde velden `RateLimit` (live status: `r` is het aantal resterende aanvragen, `t` de seconden tot het venster reset) en `RateLimit-Policy` (de quota: `q` is de limiet, `w` het venster in seconden). Een `429` bevat ook `Retry-After` in seconden en `data.retryAfterMs`. Wacht minstens zo lang voordat je de volgende aanvraag doet; eerder opnieuw proberen wordt geteld en opnieuw geweigerd. ## Schrijfbewerkingen veilig opnieuw proberen [#schrijfbewerkingen-veilig-opnieuw-proberen] Een schrijfbewerking die een `Idempotency-Key` header vermeldt in de [API-referentie](/docs/api), kan opnieuw worden geprobeerd zonder het werk dubbel uit te voeren. Verstuur één sleutel per logische schrijfbewerking en herhaal dezelfde sleutel bij elke poging opnieuw: * dezelfde sleutel met dezelfde body binnen 24 uur speelt de opgeslagen respons opnieuw af; * dezelfde sleutel met een andere body wordt geweigerd met `422`; * een duplicaat dat aankomt terwijl de eerste nog loopt, krijgt `409`. Een bewerking zonder de header is niet idempotent, dus probeer deze alleen opnieuw als je zeker weet dat de eerste poging niet is geland. --- # Probleemoplossing Source: https://nordvec.com/nl/docs/guides/troubleshooting Oplossingen voor de synchronisatiefouten en planlimieten die je kunt tegenkomen, elk beginnend bij het bericht dat je ziet. Elke pagina begint met het bericht dat Nordvec jou toont, legt uit waarom het verschijnt en loopt door de oplossing heen. Voor fouten die een API-verzoek retourneert, zie [Fouten en snelheidslimieten](/docs/guides/errors-and-rate-limits). - [Verbind een connector opnieuw](https://nordvec.com/nl/docs/guides/troubleshooting/reconnect-integration): Los syncfouten zoals "authenticatie is verlopen" en "toegang is ingetrokken" op door de betreffende connector opnieuw te verbinden. - [Verleen ontbrekende machtigingen](https://nordvec.com/nl/docs/guides/troubleshooting/insufficient-scopes): Los sync-fouten met "ontbrekende vereiste machtigingen" op door de connector opnieuw te verbinden en elke gevraagde machtiging goed te keuren. - [Documentlimiet bereikt](https://nordvec.com/nl/docs/guides/troubleshooting/document-limit): Wat er gebeurt als de documentlimiet van jouw abonnement het synchroniseren pauzeert, en hoe je ruimte vrijmaakt of upgradet om weer verder te gaan. - [Dagelijkse verwerkingslimiet bereikt](https://nordvec.com/nl/docs/guides/troubleshooting/daily-processing-limit): Wat er gebeurt als de dagelijkse verwerkingslimiet van jouw werkruimte het synchroniseren pauzeert, en wanneer het hervat wordt. --- # Verbind een connector opnieuw Source: https://nordvec.com/nl/docs/guides/troubleshooting/reconnect-integration Los syncfouten zoals "authenticatie is verlopen" en "toegang is ingetrokken" op door de betreffende connector opnieuw te verbinden. Wanneer een synchronisatie de melding **"Je authenticatie is verlopen"** of **"Je toegang is ingetrokken"** rapporteert, kan Nordvec niet langer namens jou handelen bij de provider. De verbinding zelf moet worden vernieuwd; het opnieuw proberen van de synchronisatie zonder opnieuw te verbinden helpt niet. ## Waarom dit gebeurt [#waarom-dit-gebeurt] * De provider heeft het langlopende inloggegeven dat Nordvec bewaart, verlopen. Sommige providers doen dit volgens een vast schema, andere na een periode van inactiviteit. * Je hebt jouw wachtwoord bij de provider gewijzigd, wat vaak alle verbonden apps intrekt. * Jij (of een beheerder van de werkruimte) hebt de toegang van Nordvec ingeschakeld via de instellingen voor verbonden apps of beveiliging van de provider. * De provider heeft het beveiligingsbeleid gewijzigd (bijvoorbeeld na verdachte activiteit op jouw account) en bestaande machtigingen ongeldig gemaakt. ## Hoe dit op te lossen [#hoe-dit-op-te-lossen] 1. Open **Connectors** in Nordvec. 2. Zoek de betreffende connector. Deze toont de foutstatus van de laatste synchronisatie en een **Opnieuw verbinden**-knop op de kaart. 3. Kies **Opnieuw verbinden** en meld je aan bij de provider met **hetzelfde account** waarmee je oorspronkelijk verbonden hebt. Geef alle machtigingen goed die de provider opsomt; het weigeren van één ervan leidt tot een [foutmelding voor ontbrekende machtigingen](/docs/guides/troubleshooting/insufficient-scopes). Opnieuw verbinden is ook beschikbaar via de details van de connector, op elk moment, niet alleen na een fout. Het opnieuw verbinden behoudt alles wat al gesynchroniseerd is. Gebruik **Verbinding verbreken** niet om een verlopen aanmelding op te lossen: het verbreken van de verbinding verwijdert permanent elk document dat de connector gesynchroniseerd heeft. Als je je aanmeldt met een ander account dan degene waarmee de connector is ingesteld, weigert Nordvec de herverbinding en verandert niets. Om van account te wisselen, verbreek je de connector en verbind je het andere account opnieuw. ### Connectors die niet ter plekke opnieuw verbonden kunnen worden [#connectors-die-niet-ter-plekke-opnieuw-verbonden-kunnen-worden] Guru, Notion, Zendesk, Freshdesk, Trello en e-conomic bieden geen **Opnieuw verbinden**, omdat Nordvec niet kan bevestigen dat een nieuwe aanmelding bij hetzelfde account hoort. Voor deze diensten verbreek je de connector en verbind je hem opnieuw. Het verbreken van de verbinding verwijdert de documenten die het gesynchroniseerd heeft, en de volgende synchronisatie importeert ze opnieuw vanaf het begin. ## Wat gebeurt er na het opnieuw verbinden [#wat-gebeurt-er-na-het-opnieuw-verbinden] De nieuwe aanmelding vervangt de oude en de foutmelding verdwijnt. Er start meteen een synchronisatie, en documenten die mislukten terwijl de verbinding verbroken was, worden opnieuw geprobeerd. De items onder **"Items die niet konden worden geïmporteerd"** verdwijnen naarmate ze succesvol worden geïmporteerd. Connectors zijn per gebruiker verbonden: het opnieuw verbinden vernieuwt *jouw* verbinding en heeft geen invloed op die van anderen. Alleen de persoon die een connector heeft verbonden, kan deze opnieuw verbinden, en dat geldt ook voor beheerders van de werkruimte: een beheerder kan de connector van een collega niet opnieuw verbinden. --- # Verleen ontbrekende machtigingen Source: https://nordvec.com/nl/docs/guides/troubleshooting/insufficient-scopes Los sync-fouten met "ontbrekende vereiste machtigingen" op door de connector opnieuw te verbinden en elke gevraagde machtiging goed te keuren. Wanneer een synchronisatie rapporteert **"Je account mist vereiste machtigingen"**, werkt de verbinding met de provider wel, maar zijn er minder machtigingen (OAuth-scopes) verleend dan de connector nodig heeft om jouw content te lezen. Dit is een eigenschap van de verlening zelf, dus de enige oplossing is om de verbinding opnieuw uit te voeren met de volledige set machtigingen. ## Waarom dit gebeurt [#waarom-dit-gebeurt] * Tijdens het oorspronkelijke verbindingsproces is een machtiging geweigerd. Sommige providers laten je toe om individuele machtigingen uit te schakelen op het toestemmingsscherm. * De connector heeft een nieuwe mogelijkheid gekregen die een extra machtiging vereist, en jouw oudere toestemming dateert van vóór deze wijziging. * Een beheerder van de werkruimte heeft beperkingen ingesteld voor welke machtigingen apps van derden mogen hebben, of de provider vereist goedkeuring door een beheerder voor sommige ervan. ## Hoe dit op te lossen [#hoe-dit-op-te-lossen] 1. Open **Connectors** in Nordvec. 2. Zoek de betreffende connector en kies **Opnieuw verbinden** op de kaart. 3. Meld je aan met hetzelfde account dat je oorspronkelijk hebt verbonden, en keur op het toestemmingscherm van de provider **alle** gevraagde machtigingen goed. Elke machtiging komt overeen met een concrete behoefte, meestal het lezen van de documenten, bestanden of berichten die de connector synchroniseert; er staan geen optionele extra's in de lijst. Opnieuw verbinden behoudt de reeds gesynchroniseerde documenten. Guru, Notion, Zendesk, Freshdesk, Trello en e-conomic kunnen niet op hun plaats opnieuw verbonden worden; voor deze diensten moet je de verbinding verbreken en opnieuw tot stand brengen, wat de gesynchroniseerde documenten verwijdert en ze opnieuw vanaf het begin importeert. Als het toestemmingsscherm aangeeft dat een beheerder de app moet goedkeuren, stuur het verzoek dan door naar jouw werkruimtebeheerder. Providers met een beheerderstoestemmingsstroom (bijvoorbeeld Google Workspace- en Microsoft 365-organisaties, of Slack-werkruimtes met app-goedkeuring) blokkeren de toestemming totdat een beheerder deze toestaat. Opnieuw verbinden vóór deze goedkeuring levert dezelfde foutmelding op. ## Wat gebeurt er na het opnieuw verbinden [#wat-gebeurt-er-na-het-opnieuw-verbinden] De nieuwe verlening vervangt de oude, de fout wordt opgelost en een synchronisatie start meteen. Items die eerder mislukten door machtigingsfouten, worden opnieuw geprobeerd. --- # Documentlimiet bereikt Source: https://nordvec.com/nl/docs/guides/troubleshooting/document-limit Wat er gebeurt als de documentlimiet van jouw abonnement het synchroniseren pauzeert, en hoe je ruimte vrijmaakt of upgradet om weer verder te gaan. Wanneer een synchronisatie rapporteert **"Je hebt de documentlimiet van jouw abonnement bereikt"**, is de verbinding in orde en is er niets misgegaan bij de provider. Jouw corpus bevat simpelweg het maximale aantal documenten dat jouw abonnement toestaat, dus het importeren is gepauzeerd in plaats van dat content stilzwijgend wordt genegeerd. ## Wat de limiet omvat [#wat-de-limiet-omvat] De limiet telt documenten die in jouw corpus zijn opgeslagen, afkomstig van alle bronnen: connector-syncs, uploads en documenten die via de API zijn toegevoegd. Deze limiet bestaat om de indexerings- en zoekkosten voorspelbaar te houden; het is een toelage per werkruimte, niet per connector. ## Hoe je het synchroniseren hervat [#hoe-je-het-synchroniseren-hervat] Doe een van de volgende dingen: * **Maak ruimte vrij.** Verwijder documenten die je niet meer nodig hebt, of ontkoppel een bron waarvan je de content niet wilt laten indexeren. Het verwijderen van een document verwijdert het direct uit de index. * **Upgrade jouw abonnement of voeg zitplaatsen toe.** De toelage is ingesteld per zitplaats, en hogere abonnementen staan meer documenten per zitplaats toe. Er is daarna geen handmatige herstart nodig: de volgende geplande synchronisatie detecteert de vrijgekomen capaciteit en hervat waar deze was gebleven. Je kunt ook handmatig een synchronisatie starten vanuit de kaart van de connector zodra er ruimte beschikbaar is. ## Wat er gebeurt met documenten die niet pasten [#wat-er-gebeurt-met-documenten-die-niet-pasten] Er gaat niets verloren bij de bron; de provider blijft het systeem van record. Documenten die niet konden worden geïmporteerd, worden opgepikt door de volgende succesvolle synchronisatie zodra er capaciteit beschikbaar is. --- # Dagelijkse verwerkingslimiet bereikt Source: https://nordvec.com/nl/docs/guides/troubleshooting/daily-processing-limit Wat er gebeurt als de dagelijkse verwerkingslimiet van jouw werkruimte het synchroniseren pauzeert, en wanneer het hervat wordt. Wanneer een synchronisatie rapporteert **"Jouw werkruimte heeft de verwerkingslimiet van vandaag bereikt"**, is de verbinding gezond en is er niets misgegaan bij de provider. Jouw werkruimte heeft zoveel nieuwe inhoud verwerkt op één dag als de limiet toestaat, dus het importeren is gepauzeerd in plaats van dat items één voor één worden afgewezen. ## Wat de limiet omvat [#wat-de-limiet-omvat] De limiet telt de inhoud die voor indexering is verwerkt over alle bronnen (connector-synchronisaties, uploads, documenten die via de API worden gepusht) in één kalenderdag, gemeten in UTC. Deze bestaat om te voorkomen dat een eerste synchronisatie van een grote bron onbeperkt doorloopt op één dag. Ongewijzigde inhoud telt nooit opnieuw mee, dus na de initiële import komt een werkruimte er zelden in de buurt. De limiet is een toewijzing per werkruimte die schaalt met het aantal zitplaatsen. Elk lid kan dagelijks een deel ervan gebruiken, zodat één persoon met een grote import niet de hele toewijzing van de werkruimte kan opgebruiken. ## Hoe synchroniseren hervat wordt [#hoe-synchroniseren-hervat-wordt] Er hoef je niets voor te doen. De connector is gepland om na middernacht UTC opnieuw uit te voeren, wanneer de dagelijkse toewijzing reset, en gaat verder waar hij gestopt was. De statusmelding verdwijnt bij die uitvoering. Je kunt ook handmatig een synchronisatie starten vanuit de kaart van de connector. Deze pakt op waar de vorige gestopt was zodra de toewijzing beschikbaar is. ## Wat er gebeurt met inhoud die niet verwerkt is [#wat-er-gebeurt-met-inhoud-die-niet-verwerkt-is] Er gaat niets verloren bij de bron; de provider blijft het systeem van record. Items die vandaag niet verwerkt konden worden, worden opgepikt door de volgende uitvoering.