plaid-fintech について
Plaid を統合する開発者向けのスキルです。Link トークン交換、取引同期、Item エラーへの対処に加え、セキュリティやポーリングの注意点を案内します。
主な機能
- 01Link トークンの作成と交換
- 02取引の差分同期
- 03Item のログインエラー対応
- 04Webhook による更新受信
活用シーン
- 01Plaid Link 認証の実装
- 02口座取引の変更同期
- 03ユーザー再認証への対応
- 04取引更新通知の設計
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ davila7/ claude-code-templates --skill plaid-fintechインストール後、Claude Code で/plaid-fintechを入力して読み込まれたか確認します。
詳細
Plaid Fintech
パターン
Link トークンの作成と交換
Plaid Link 用に link_token を作成し、public_token を access_token に交換します。 Link トークンは短期間で有効な使い捨てのトークンです。アクセストークンには有効期限はありませんが、ユーザーがパスワードを変更した場合に更新が必要になることがあります。
トランザクションの同期
増分のトランザクション更新には /transactions/sync を使用します。/transactions/get より効率的です。ポーリングの代わりに、リアルタイム更新のために Webhook を処理してください。
アイテムのエラー処理と更新モード
ITEM_LOGIN_REQUIRED エラーは、ユーザーを Link の更新モードに誘導して処理します。PENDING_DISCONNECT Webhook をリッスンし、ユーザーに事前に通知してください。
アンチパターン
❌ アクセストークンを平文で保存する
❌ Webhook の代わりにポーリングする
❌ アイテムのエラーを無視する
⚠️ 注意すべき落とし穴
| 問題 | 重大度 | 解決策 |
|---|---|---|
| 問題 | critical | ドキュメントを参照 |
| 問題 | high | ドキュメントを参照 |
| 問題 | high | ドキュメントを参照 |
| 問題 | high | ドキュメントを参照 |
| 問題 | medium | ドキュメントを参照 |
| 問題 | medium | ドキュメントを参照 |
| 問題 | medium | ドキュメントを参照 |
| 問題 | medium | ドキュメントを参照 |
コメント
Markdown 対応