Fouten & limieten
Foutcodes, idempotentie, limieten per aanroep en het maximaal aantal acties per minuut.
Technische naslag per actie. Voor gewoon gebruik heb je dit niet nodig. Begin bij Wat kan Claude in Ops Grid?.
Elke actie geeft een leesbare reden van één regel plus een machine-code terug als er iets
misgaat. Claude geeft de reden aan je door.
Foutcodes
| Code | Betekenis | Wat te doen |
|---|---|---|
401 | Niet ingelogd / inlog verlopen | Verbind de connector opnieuw en log opnieuw in. Zie Probleemoplossing. |
403 | Je rol mag dit niet | Schrijfacties vereisen eigenaar of Commander. Vraag hen, of gebruik de leesacties. |
409 | Conflict | Er bestaat al een voorstel-organigram — accepteer of verwijder het eerst. |
422 | Validatieprobleem | De reden noemt het veld/de limiet (bijv. onbekend veldtype, edge naar een ontbrekende node, limiet overschreden). |
429 | Te veel verzoeken | Je hebt het maximaal aantal acties per minuut bereikt; wacht en probeer opnieuw (een retry-after is meegegeven). |
Een herhaalde schrijfactie (zelfde client_reference) is geen fout — die geeft 200
terug met duplicate: true en de id van het bestaande record (zie
Idempotentie). 409 is alleen het organigram-conflict "er bestaat al een
voorstel".
Idempotentie
Elke schrijfactie neemt een client_reference. Komt er een schrijfactie binnen met een
client_reference die al in je organisatie is gebruikt, dan geeft de connector het
bestaande record terug in plaats van een tweede aan te maken:
{ "ok": true, "duplicate": true, "grid_id": "…(de bestaande)" }Hierdoor is elke schrijfactie veilig om opnieuw te proberen — als een aanroep een time-out krijgt, maakt hem opnieuw uitvoeren geen dubbelingen aan.
Limieten per aanroep
Eén aanroep is begrensd zodat één verzoek geen onbeheersbare grid kan aanmaken. Boven een
limiet → 422 met de limiet in het bericht.
| Limiet | Grens |
|---|---|
| Nodes per grid-aanroep | 50 |
| Edges per grid-aanroep | 80 |
| Stappen per SOP | 30 |
| Items per checklist | 40 |
| Personen per organigram | 60 |
| Voorstel-organigram per owner | 1 |
| Grootte request body | 256 KB |
Voor een grote import splitst Claude het werk over meerdere aanroepen (elk met zijn eigen
client_reference).
Maximaal aantal acties per minuut
60 aanroepen per gebruiker per minuut. Daarboven → 429 met een retry-after. Dit
wordt afgedwongen per draaiende instance; het is ruim voldoende voor een normale importsessie.
Atomiciteit
Grid-schrijfacties zijn alles-of-niets. Als een create_value_chain-aanroep op één edge
faalt bij de validatie, wordt er niets aangemaakt — los de reden op en probeer opnieuw.