API Fetch Wrapper
Referanse TypeScript-mønster for å pakke inn en ekstern HTTP API: env-hemmeligheter, begrenset gjenforsøk
Bestått
Hva den gjør
Et kjørbart TypeScript-eksempel som pakker inn en offentlig HTTP API (nøkkelløs Open-Meteo demo) med env-basert legitimasjonshåndtering, ett begrenset gjenforsøk ved midlertidige feil, og feilnormalisering som aldri gjenspeiler oppstrøms-kroppen. Utløses når du ber om å bygge en ferdighet eller klient som kaller en ekstern tjeneste med riktig gjenforsøk og hemmelighetshygiene. Gjenbruk gjenforsøks-/feilskjelettet og bytt URL pluss process.env-nøkkel for en autentisert API.
Testrapport
Kjørte den medfølgende koden live mot det virkelige Open-Meteo-endepunktet: lykkelig sti returnerte 16.5C / 17.4 km/t, feilformet input produserte en strukturert {error} med exit 1, og en uoppnåelig vert utløste gjenforsøket (en 500ms forsinkelse ble observert i veggtid) og returnerte deretter {error,cause} uten at oppstrøms-kroppen lekket. Mot en naiv grunnlinje-wrapper legger den til tre ikke-åpenbare detaljer en gjennomsnittlig implementasjon hopper over: feilkartlegging uten lekkasje ved feil, tømming av respons-kroppen for gjenbruk av socket, og et bevisst kun-midlertidig (408/429/5xx) gjenforsøksfilter. Eksemplet er lite, men hver påstand i frontmatter holdt stand under utførelse.
Testet på: 2026-07-20 · Claude Code 2.x (agent harness)
Installer
git clone https://github.com/ChronoAIProject/Ornn mkdir -p ~/.claude/skills cd Ornn && cp -r examples/api-fetch-wrapper ~/.claude/skills/api-fetch-wrapper
Kommandoer og eksempelprompter
/api-fetch-wrapperReferanse TypeScript-mønster for å pakke inn en ekstern HTTP API: env-hemmeligheter, begrenset gjenforsøk
Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):
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