Skip to main content
POST
cURL
非推奨。 この v2 エンドポイントは 2026 年 10 月 9 日 09:00 KST(00:00 UTC)にサポートを終了する予定です。新しく連携する場合は POST /api/v3/orders/wtr-embed を使用し、移行方法は watermark 埋め込みのクイックスタートを参照してください。v2 のサポート終了後の動作(2026 年 10 月 9 日 09:00 KST、00:00 UTC から):
  • 認証・権限の確認はこれまでどおり先に行われるため、401・403 エラーは従来と同じです。
  • 認証を通過した v2 の watermark 埋め込み・抽出リクエストには、本番キーと sk_test_ キーのどちらでも 410 Gone と { "code": "WATERMARK_V2_API_SUNSET" } が返されます。Link ヘッダーが v3 エンドポイントを示すので、v3 で新しくリクエストしてください。
  • その時点までに処理が始まっていない v2 注文は、処理されずに失敗として確定します。注文の詳細(errors.errorCode)と失敗 Webhook には WATERMARK_V2_API_SUNSET と v3 への案内メッセージが含まれ、課金されずクレジットは戻ります。
  • 終了時点ですでに処理中の注文は、結果の記録まで完了します。その後に改めて実行されることはありません。
  • 既存の v2 注文の取得と、作成済みの結果・レポートのダウンロードは、既存の保管期間内であれば引き続き利用できます。v2 レポートの新規作成・再作成はできません。
それまではリクエストとレスポンスの動作は変わらず、これらのエンドポイントのすべてのレスポンスに Deprecation: true、Sunset: Fri, 09 Oct 2026 00:00:00 GMT、Link ヘッダーが付くだけです。
v3 の watermark 抽出では、v2 で埋め込んだ watermark を検出できません。 エンドポイントを v3 に切り替えるだけでは既存の v2 watermark 画像は検出されず、v2 のサポート終了後に v2 の検出を例外的に受け付けることもありません。

サポート終了後のレスポンス

2026 年 10 月 9 日 09:00 KST(00:00 UTC)から、このエンドポイントに認証済みのリクエストを送ると、次のレスポンスが返されます。
Link ヘッダーの v3 エンドポイントに新しくリクエストしてください。

承認

Authorization
string
header
必須

外部クライアントアクセス用のBearer APIキー。本番キーは sk_ プレフィックスを使用し、テストキーは sk_test_ プレフィックスを使用して、処理やクレジット消費なしに注文ライフサイクルを検証します。

ボディ

application/json
idempotencyKey
string
必須

冪等性キー

files
object[]
必須
Required array length: 1 - 100 elements

レスポンス

注文が正常に作成されました

data
object