API Fetch Wrapper
Referentie TypeScript-patroon voor het wrappen van een externe HTTP API: env secrets, begrensde herhaling
Getest · Werkt
Wat het doet
Een uitvoerbaar TypeScript-voorbeeld dat een openbare HTTP API (sleutelloze Open-Meteo demo) omwikkelt met omgevingsgebaseerde credential handling, één begrensde herhaling bij tijdelijke storingen, en foutnormalisatie die nooit de upstream body herhaalt. Activeert wanneer je vraagt om een skill of client te bouwen die een externe service aanroept met de juiste herhaling en geheime hygiëne. Hergebruik het retry/error skelet en verwissel de URL plus process.env key voor een geauthenticeerde API.
Testrapport
Voerde de gebundelde code live uit tegen het echte Open-Meteo eindpunt: het happy path retourneerde 16.5C / 17.4 km/h, verkeerd gevormde invoer produceerde een gestructureerde {error} met exit 1, en een onbereikbare host activeerde de herhaling (een vertraging van 500ms werd waargenomen in wall time) en retourneerde vervolgens {error,cause} zonder dat de upstream body lekte. Tegenover een naïeve baseline wrapper voegt het drie niet-voor de hand liggende details toe die een gemiddelde implementatie overslaat: no-leak-on-failure foutmapping, het leegmaken van de response body voor sockethergebruik, en een opzettelijke transient-only (408/429/5xx) retry filter. Het voorbeeld is klein, maar elke claim in zijn frontmatter hield stand onder uitvoering.
Getest op: 2026-07-20 · Claude Code 2.x (agent harness)
Installatie
git clone https://github.com/ChronoAIProject/Ornn mkdir -p ~/.claude/skills cd Ornn && cp -r examples/api-fetch-wrapper ~/.claude/skills/api-fetch-wrapper
Commando's en voorbeeldprompts
/api-fetch-wrapperReferentie TypeScript-patroon voor het wrappen van een externe HTTP API: env secrets, begrensde herhaling
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
Show me a TypeScript pattern for wrapping an external API safelyBuild a fetch wrapper with bounded retry and no leaked error bodiesWrap this authed API client with env secrets and retry logic