ask-cli について
ask-cli は App StoreKit API を照会するコマンドラインツールです。アプリ内課金や取引データを扱う開発者向けに、商品、サブスクリプション、通知などを操作できます。
主な機能
- 01アプリ内課金商品の管理
- 02サブスクリプションとグループの確認
- 03取引の照会と検証
- 04顧客の状態と権利の照会
- 05通知とイベントの一覧表示
活用シーン
- 01アプリ商品の履歴を確認
- 02取引の検証や返金
- 03顧客のサブスクリプション状態を確認
- 04最近の通知やイベントを確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ dl-alexandre/ skills --skill ask-cliインストール後、Claude Code で/ask-cliを入力して読み込まれたか確認します。
詳細
App StoreKit CLI
ask コマンドラインツールを使用して App StoreKit API をクエリします。
前提条件
ask --version
export ASK_ISSUER_ID='your-issuer-id'
export ASK_PRIVATE_KEY_PATH='/path/to/key.p8'
ask auth status
認証
- App Store Connect の発行者 ID と秘密鍵
- 環境変数:
ASK_ISSUER_ID、ASK_PRIVATE_KEY_PATH - または:対話形式でセットアップするには
ask auth login
アプリ内課金
製品
ask products list --app APP_ID
ask products get PRODUCT_ID --app APP_ID
ask products history --app APP_ID --product PRODUCT_ID
サブスクリプション
ask subscriptions list --app APP_ID
ask subscriptions get SUBSCRIPTION_ID --app APP_ID
ask subscriptions groups list --app APP_ID
ask subscriptions status --app APP_ID --customer CUSTOMER_ID
トランザクション
ask transactions history --app APP_ID --customer CUSTOMER_ID
ask transactions verify --app APP_ID --transaction-id TX_ID
ask transactions refund --app APP_ID --transaction-id TX_ID --reason "Customer request"
消費状況とステータス
ask consumption report --app APP_ID --date 2024-06-01
ask status --app APP_ID --customer CUSTOMER_ID --product PRODUCT_ID
ask entitlements --app APP_ID --customer CUSTOMER_ID
通知とイベント
ask notifications list --app APP_ID --days 7
ask events list --app APP_ID --type SUBSCRIBED --days 30
エージェントのベストプラクティス
- 顧客 ID:匿名化した識別子を使用します
- ページネーション:結果が多い場合は
--cursorを使用します - 日付範囲:必要な期間にクエリを限定します
- サンドボックス:テスト環境では
--sandboxを使用します
コメント
Markdown 対応