テスト API キー

​

テスト注文のライフサイクル

curl -X POST https://api.bizmori.com/api/v2/orders/anti-ai \
  -H "Authorization: Bearer $BIZMORI_TEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotencyKey": "2f1c3e4a-8b57-4a6d-9c20-7e5f1a3b6d42",
    "files": [{"fileName": "sample.png"}]
  }'

curl -X PUT "TEST_UPLOAD_URL" \
  --data-binary @sample.png

​

サービスごとのフロー

​

決定的な結果を選択する

​

テスト Webhook

curl -X POST https://api.bizmori.com/api/v2/orders/webhooks \
  -H "Authorization: Bearer $BIZMORI_TEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Integration test webhook",
    "url": "https://example.com/test-webhook",
    "isTest": true
  }'

• テスト API キーでは、同じ所有者のテストエンドポイントの作成、一覧・詳細取得、更新、削除、イベント取得、失敗イベントの再送を実行できます。本番モードと別所有者のリソースは公開されません。
• isTest: true のエンドポイントはテスト注文イベントだけを受信します。
• isTest: false のエンドポイントは本番注文イベントだけを受信します。
• テスト Webhook のイベント名、HMAC-SHA256 署名、再試行動作は本番 Webhook と同じです。
• 結果ファイルを作成しないため、Anti-AI と Watermark Embed のテストイベントでは downloadUrl: null になります。

​

Watermark の結果、ダウンロード、レポート

• ダウンロード URL は、入力形式（PNG、JPG、WEBP、PDF）に合った固定のサンプルファイルを返します。出力が複数ある注文ではサンプル ZIP ファイルを返します。実際に watermark を挿入した結果ファイルではありません。
• 検出結果が detected の場合、watermarkText は MORI TEST WATERMARK、reportSupported は true です。
• レポートは 1 ページのサンプル PDF です。実際の検出結果は含まれず、locale によって内容は変わりません。
• not_detected の注文は REPORT_NOT_AVAILABLE、未完了または失敗した注文は ORDER_NOT_COMPLETED、Watermark Embed の注文は ORDER_TYPE_NOT_MATCH で拒否されます。別所有者の注文と本番注文は ORDER_NOT_FOUND を返します。

• テストのレポートリクエストは即座に 200 completed を返します。202 queued や processing は返さず、クレジットも消費しません。
• テストレポートは保存されないため、注文取得の reports 配列は常に空です。
• 同じ idempotencyKey を再送すると、リクエスト本文を比較せずに既存の注文を返すため、409 は発生しません。

​

API の動作と制限

• 画像またはドキュメントの実処理
• クレジットの予約または消費
• ダウンロード可能な結果ファイルの作成（Watermark のダウンロードおよびレポートのエンドポイントが返す固定サンプルファイルを除く）
• 本番 Webhook エンドポイントへのイベント送信