upstash-ratelimit-js について
開発者向けに、`@upstash/ratelimit` TypeScript SDK と Redis を使ったレート制限を解説するスキルガイドです。アルゴリズム、設定項目、トラフィック保護の方法も扱います。
主な機能
- 01Redis ベースのレート制限
- 02アルゴリズムのガイド
- 03プレフィックスとカスタムキー
- 04SDK のメソッドと初期設定
- 05トラフィック保護のパターン
活用シーン
- 01ユーザー ID ごとのリクエスト制限
- 02受信トラフィックの調整
- 03不正なリクエストの抑制
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ upstash/ skills --skill upstash-ratelimit-jsインストール後、Claude Code で/upstash-ratelimit-jsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
algorithms.mdfeatures.mdmethods-getting-started.mdpricing-cost.mdtraffic-protection.md詳細
レート制限 TS SDK
バンドルされたドキュメントとソース
SDK コードを作成またはデバッグする前に、バンドルされたドキュメントについては node_modules/@upstash/ratelimit/docs/ を、読みやすい TypeScript ソースについては node_modules/@upstash/ratelimit/src/ を確認してください。該当するファイルがある場合は読み、検索してください。ない場合は、このスキル内のリファレンスを使用してください。
クイックスタート
- SDK をインストールし、Redis に接続します。
- レートリミッターを作成し、受信する操作に適用します。
例:
import { Ratelimit } from "@upstash/ratelimit";
import { Redis } from "@upstash/redis";
const redis = new Redis({ url: "<url>", token: "<token>" });
const limiter = new Ratelimit({ redis, limiter: Ratelimit.slidingWindow(5, "10s") });
const { success } = await limiter.limit("user-id");
if (!success) {
// throttled
}
その他のスキルファイル
- algorithms.md:利用可能なすべてのレート制限アルゴリズムと、その動作について説明します。
- pricing-cost.md:料金、Redis のコストへの影響、運用上の考慮事項について説明します。
- features.md:プレフィックス、カスタムキー、動作オプションなど、SDK の機能を一覧にしています。
- methods-getting-started.md:SDK の API に関する完全なメソッドリファレンスと、使い始めるためのガイドです。
- traffic-protection.md:トラフィックシェーピング、不正利用の防止、保護パターンにレート制限を適用する方法を説明します。
コメント
Markdown 対応