salla-live-testing について
Salla アプリ開発者向けの実地テストスキルです。公開前にデモストアへインストールし、設定、埋め込みページ、ストアフロントのスニペット、イベントなど、単独のエンドポイントテストでは確認できない動作を検証します。
主な機能
- 01インストール前のデプロイ URL 確認
- 02デモストアリンクからのインストール
- 03設定の保存と永続化の確認
- 04埋め込みページの認証と読み込みテスト
- 05ストアフロント表示と実イベント到達の確認
活用シーン
- 01公開前の Salla アプリ検証
- 02OAuth や webhook URL の不一致調査
- 03テーマ上でのスニペット表示確認
- 04webhook または App Function のイベント受信確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/salla-live-testingを入力して読み込まれたか確認します。
詳細
Salla ライブテスト
ライブゲート：完了と判断する前に、実際のデモストアでマーチャントとしてアプリを操作します。エンドポイント／MCP テストが成功していても、マーチャント向けの連携が壊れている可能性があります。
デモデータのみを使用してください。 機密情報を含まないデータを使い、デモストアでテストしてください。本番環境のシークレット、OAuth／アクセストークン／リフレッシュトークン、Webhook 署名シークレット、実際の顧客の個人識別情報を、サードパーティのキャプチャ／検査ツール（request-bin エンドポイント、画面共有、チャット）に持ち込まないでください。テストで設定を一時的な受信先に向けた場合は、その後、実際の
webhook_url、リダイレクト URL、シークレットを元に戻してください。
ステップ 0 — 設定済みの URL をデプロイ済みドメインに向ける
インストールする前に、設定済みの URL（salla_apps action=get）を取得し、webhook_url、OAuth リダイレクト／コールバック、埋め込みページの URL がそれぞれ、アプリが実際に動作しているドメインを指していることを確認してください。これらは一致している必要があります。一致しない URL は気づかないうちに失敗します（OAuth のリダイレクト先がなく、Webhook は以前のホストで 404 になり、iframe は読み込まれず、エラーも表示されません）。インストールリンクを生成する_前に_、URL（またはデプロイ先）を一致させてください。
ステップ 1 — デモストアにインストールする
app_id を指定して salla_apps action=demo_stores を呼び出し、結果からストアを選びます。インストールリンクの有効期限は短く（約 1 時間）、すぐに期限切れになるため、テストの直前に生成して、すぐに使用してください。インストールが何も行われないように見える場合（期限切れのリンクはエラーなく失敗するか、ログイン画面にリダイレクトされます）、salla_apps action=demo_stores を再実行して新しいリンクを取得してください。
公開前のテストは、必ずデモストアで行い、
salla_apps action=demo_storesのinstall_urlを使用してください。 公開 App-Store リンクhttps://s.salla.sa/apps/install/{app_id}が機能するのは、アプリの公開後のみです。未公開のアプリはインストールできません。テスト用にこのリンクを手作業で作成しないでください。デモストアのinstall_urlを使うと、会社のデモストアにアプリが自動インストールされます。
用途の異なる 3 つの URL：
| フィールド | 指し示す先 | 用途 |
|---|---|---|
install_url | OAuth + インストール | インストールフロー（同意 → app.store.authorize）を開始する |
url | ストアフロント | 商品／カートページでスニペットをテストする（ストアフロントの確認） |
dashboard_url | マーチャント管理画面 | ダッシュボードで埋め込みアプリと設定をテストする（自動ログイン） |
connected: true はすでにインストール済みであることを意味します。それ以外の場合は、ブラウザーで新しい install_url を開いてインストールしてください。フィールド名はツールのコントラクトに基づいています。実際のレスポンスから実際の形式を確認してください。
ステップ 2 — チェックを実行する
| 対象 | チェック | 信頼できる情報源 |
|---|---|---|
| 設定 | アプリの設定ページを開き、値を変更して保存し、再度開きます。値が保持されていることを確認します。 | salla-app-settings（保存のスモークテスト）。また、webhook_url に自動配信される app.settings.updated Webhook ペイロード（アプリイベント — 購読は不要） |
| 埋め込み | ダッシュボードで埋め込みページを開きます。認証が行われ（SDK トークンがサーバー側で検証され、セッションが確立された後にレンダリングされます）、データが読み込まれ、応答が停止しないことを確認します。期限切れトークンをテストし、SDK の更新処理で復旧することを確認します。正確な認証フローは salla-embedded-app で確認してください。 | salla-embedded-app |
| ストアフロント | 商品ページにアクセスし、スニペットがネイティブに（テーマ、アイコン、RTL）レンダリングされることを確認し、スクリーンショットを撮ります。ウィジェットが重複していないことも確認します。ブラウザーの DevTools Console でスニペットが実際に実行されることを確認してください（ロードマーカー、赤いエラーがないこと、イベントペイロード）。salla-snippets のブラウザーテスト手順を参照してください。 | salla-snippets + salla-storefront-ui |
| イベント | 実際のイベント（テスト注文の作成、在庫の変更、設定の保存）を発生させ、Webhook がそれらを受信すること（および salla-webhooks に従って署名／冪等性の処理を通過すること）、または App Function が実行されることを確認します。 | salla-webhooks / salla-app-functions |
| ログ | 上記の操作中にエラーがないか、Partner／Portal のログとブラウザーコンソールを確認します。トークンやシークレットがコンソールやログに出力されていないことを確認します。 | — |
ステップ 3 — 証拠として認められるもの
設定レベルで成功しても、統合が成功したとは限りません。マーチャントに見える動作を確認してください。
- Portal が設定スキーマを受け付ける → インストール済みフォームが保存されることを確認します（ステップ 2）。
- スニペットが実行される → ネイティブに正しく表示されることを確認します（
salla-storefront-uiを参照）。 - 単独でエンドポイントが 200 を返す → Salla が実際のペイロードを送信して呼び出すことを確認します（ステップ 2 のイベント）。
合格条件：「インストール済みのデモストアで、設定が保存・保持され、埋め込みページが認証されて読み込まれ、ストアフロントのスニペットがネイティブにレンダリングされ、実際のイベントが Webhook／App Function に届くことを、すべてスクリーンショット／ログで確認できていますか？」