API
リクエスト先 /api/v1 ヘッダー付き Authorization: Bearer uxp_.... アカウントでキーを作成します。制限は1分あたり60リクエストです。
実行開始
curl -X POST $BASE/api/v1/runs \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"site":"SITE_ID","steps":20,"concurrency":3,"personas":["p01","p03"]}'personasを省略すると、パネルで有効化されているすべてのペルソナが使用されます。レスポンス: {"id":"r...","status":"queued","credits":2}
メソッド
| メソッド | パス | 機能 |
|---|---|---|
| GET | /balance | クレジット残高 |
| GET | /sites | あなたのサイト、そのID、およびパネル |
| GET | /personas | ペルソナライブラリ |
| GET | /runs | 最新のテスト実行 |
| POST | /runs | 実行開始 |
| GET | /runs/{id} | ペルソナごとのステータスと結果 |
| POST | /runs/{id}/cancel | キャンセル。未完了のクレジットは返金されます |
エラー
形式: {"error":{"code":"...","message":"..."}}
| HTTP | コード | 意味 |
|---|---|---|
| 400 | no_personas | ペルソナが選択されていないか、またはこのサイトに該当するIDがありません |
| 400 | not_test_host | テスト決済モードでは、テストホスト上に開始ページが必要です |
| 401 | unauthorized | キーが見つからない、または無効です |
| 402 | insufficient_credits | クレジットが不足しています |
| 403 | domain_not_verified | ドメインが検証されていません |
| 404 | not_found | アカウントにそのようなデータはありません |
| 409 | too_many_runs | キュー内のテスト実行数が多すぎます |
| 429 | rate_limited | リクエスト制限を超えました |
テスト実行がサイトに与える影響
検証済みドメインへのGETリクエストのみ送信されます。フォームは送信されず、パスワードやカード情報のフィールドは空のままなので、テスト実行は登録、ログイン、決済を行いません。例外はテストホスト用に有効にしたテスト決済モードです。注釈はAIモデルが生成するため、修正する前に必ず確認してください。
