curl -X POST https://api.bizmori.com/api/v2/orders/wtr-extract \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"idempotencyKey": "8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26",
"file": {
"fileName": "watermarked.jpg"
}
}'const response = await fetch('https://api.bizmori.com/api/v2/orders/wtr-extract', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
idempotencyKey: '8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26',
file: {
fileName: 'watermarked.jpg'
}
})
});
const data = await response.json();import requests
response = requests.post(
'https://api.bizmori.com/api/v2/orders/wtr-extract',
headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
json={
'idempotencyKey': '8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26',
'file': {
'fileName': 'watermarked.jpg'
}
}
)
data = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bizmori.com/api/v2/orders/wtr-extract",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'idempotencyKey' => '2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40',
'file' => [
'fileName' => 'watermarked.jpg'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bizmori.com/api/v2/orders/wtr-extract"
payload := strings.NewReader("{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"file\": {\n \"fileName\": \"watermarked.jpg\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bizmori.com/api/v2/orders/wtr-extract")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"file\": {\n \"fileName\": \"watermarked.jpg\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bizmori.com/api/v2/orders/wtr-extract")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"file\": {\n \"fileName\": \"watermarked.jpg\"\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"orderName": "wtr_extract_2026-02-13",
"orderId": "123456789",
"file": {
"fileId": 1,
"fileName": "watermarked.jpg",
"uploadUrl": "https://s3.amazonaws.com/...",
"fileKey": "123/456/watermarked.jpg",
"fileFormat": "JPG",
"fileType": "IMG",
"role": "watermarked",
"sequence": 1
}
}
}watermark 抽出注文を作成
非推奨。 このエンドポイントは 2026 年 10 月 9 日 09:00 KST(00:00 UTC)にサポートを終了する予定です。POST /api/v3/orders/wtr-extract を使用してください。
このエンドポイントのすべてのレスポンス(認証エラーと 410 レスポンスを含む)には、Deprecation: true、Sunset: Fri, 09 Oct 2026 00:00:00 GMT、Link: </api/v3/orders/wtr-extract>; rel="successor-version" ヘッダーが含まれます。
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 への案内メッセージが含まれ、課金されずクレジットは戻ります。 - 終了時点ですでに処理中の注文は、結果の記録まで完了します。その後に改めて実行されることはありません。
watermark 抽出注文を作成します。
- 注文あたりファイル1つのみ
- 画像(jpg, jpeg, png, webp, bmp, tiff)またはPDFファイルに対応
- 画像の場合、
includeOriginal: trueで元ファイルも一緒にアップロード可能 - PDFは
includeOriginalに非対応
curl -X POST https://api.bizmori.com/api/v2/orders/wtr-extract \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"idempotencyKey": "8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26",
"file": {
"fileName": "watermarked.jpg"
}
}'const response = await fetch('https://api.bizmori.com/api/v2/orders/wtr-extract', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
idempotencyKey: '8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26',
file: {
fileName: 'watermarked.jpg'
}
})
});
const data = await response.json();import requests
response = requests.post(
'https://api.bizmori.com/api/v2/orders/wtr-extract',
headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
json={
'idempotencyKey': '8b3f1d6e-e7a5-424b-b6c9-1e4d5a8c0f26',
'file': {
'fileName': 'watermarked.jpg'
}
}
)
data = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bizmori.com/api/v2/orders/wtr-extract",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'idempotencyKey' => '2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40',
'file' => [
'fileName' => 'watermarked.jpg'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bizmori.com/api/v2/orders/wtr-extract"
payload := strings.NewReader("{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"file\": {\n \"fileName\": \"watermarked.jpg\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bizmori.com/api/v2/orders/wtr-extract")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"file\": {\n \"fileName\": \"watermarked.jpg\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bizmori.com/api/v2/orders/wtr-extract")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"file\": {\n \"fileName\": \"watermarked.jpg\"\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"orderName": "wtr_extract_2026-02-13",
"orderId": "123456789",
"file": {
"fileId": 1,
"fileName": "watermarked.jpg",
"uploadUrl": "https://s3.amazonaws.com/...",
"fileKey": "123/456/watermarked.jpg",
"fileFormat": "JPG",
"fileType": "IMG",
"role": "watermarked",
"sequence": 1
}
}
}POST /api/v3/orders/wtr-extract を使用し、移行方法は 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 ヘッダーが付くだけです。サポート終了後のレスポンス
2026 年 10 月 9 日 09:00 KST(00:00 UTC)から、このエンドポイントに認証済みのリクエストを送ると、次のレスポンスが返されます。HTTP/1.1 410 Gone
Content-Type: application/json; charset=utf-8
Deprecation: true
Sunset: Fri, 09 Oct 2026 00:00:00 GMT
Link: </api/v3/orders/wtr-extract>; rel="successor-version"
{ "code": "WATERMARK_V2_API_SUNSET" }
Link ヘッダーの v3 エンドポイントに新しくリクエストしてください。承認
外部クライアントアクセス用のBearer APIキー。本番キーは sk_ プレフィックスを使用し、テストキーは sk_test_ プレフィックスを使用して、処理やクレジット消費なしに注文ライフサイクルを検証します。
ボディ
冪等性キー
Hide child attributes
Hide child attributes
watermark 付きファイル名(拡張子を含む)
"watermarked.jpg"
元ファイルを含める(画像のみ)
- true: 元ファイルのアップロードURLも発行されます
- PDFファイルでは使用できません
レスポンス
注文が正常に作成されました
Hide child attributes
Hide child attributes
注文名(自動生成)
注文ID
watermark 抽出注文ファイル情報
Hide child attributes
Hide child attributes
ファイルID
ファイル名
アップロードURL(プリサインドURL)
S3ファイルキー
ファイル形式
"JPG"
ファイルタイプ(画像またはPDF)
IMG, DOCUMENT ファイルの役割(メインファイルは常に"watermarked")
watermarked ファイル順序番号(常に1)
1
元ファイル情報(includeOriginalがtrueの場合のみ含まれます)
Hide child attributes
Hide child attributes
ファイルID
ファイル名
アップロードURL(プリサインドURL)
S3ファイルキー
ファイル形式
ファイルタイプ(画像のみ)
IMG ファイルの役割(常に"original")
original ファイル順序番号(常に1)
1