k-skill/docs
Jeffrey (Dongkyu) Kim 49bf262bb9 Route shared key APIs through the proxy
Move KOSIS general lookups and Kakao Local geocoding behind k-skill-proxy so users do not need to manage those API keys for common skill flows. Keep KOSIS bigdata/direct calls user-keyed because userStatsId is account-specific.

Constraint: Free API proxy policy allows proxying upstreams that require API keys while keeping routes narrow, cache-backed, and public.

Rejected: Proxy ODsay transit routing | Basic quota is low, time-limited, and IP-whitelist-bound, so centralizing it would create quota and operations risk.

Confidence: high

Scope-risk: moderate

Directive: Keep KOSIS bigdata direct unless a per-user credential design is added; do not route broad Kakao surfaces without explicit allowlists and rate limits.

Tested: npm run ci; local KOSIS proxy smoke via /v1/kosis/search and /v1/kosis/meta; local Kakao proxy smoke via /v1/kakao-local/geocode q=서울역.

Not-tested: Production proxy deployment after main merge/cron update.
2026-05-13 16:31:29 +09:00
..
assets Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
features Route shared key APIs through the proxy 2026-05-13 16:31:29 +09:00
adding-a-skill.md Merge dev into main (#197) 2026-05-02 23:51:59 +09:00
install-manus.md feat: Manus.ai 호환 import 경로 추가 (GitHub URL + rolling .skill 번들) (#227) 2026-05-11 12:12:44 +09:00
install.md Route shared key APIs through the proxy 2026-05-13 16:31:29 +09:00
releasing.md Align Changesets release flow with generated package changelogs 2026-03-30 22:27:07 +09:00
roadmap.md Add court-auction-notice-search skill and package (#167) 2026-04-29 16:36:55 +09:00
security-and-secrets.md Route shared key APIs through the proxy 2026-05-13 16:31:29 +09:00
setup.md Route shared key APIs through the proxy 2026-05-13 16:31:29 +09:00
sources.md Route shared key APIs through the proxy 2026-05-13 16:31:29 +09:00