API 요청
/rest/get_watermark요청 파라미터 1개 · 필수 1
image응답 필드 8개
datadata.resultdata.successapiapi.successapi.costapi.msapi.pl_id비가시성 워터마크 삽입으로 이미지에 심은 숫자 코드를 읽어 돌려줍니다.
https://apick.app/rest/get_watermark왜 비가시성 워터마크 조회인가
도용이 의심되는 이미지를 발견해도 우리 것이라는 근거가 없으면 대응조차 못 합니다. 심어 둔 워터마크를 조회해 일부 변형된 사본에서도 높은 확률로 원본임을 확인합니다.
REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.
인터넷에서 발견한 이미지가 내가 배포한 이미지인지, 어느 구매자에게 보낸 이미지인지 확인할 때 사용합니다. PNG·JPEG·WEBP·BMP 이미지를 받습니다.
돌려받은 data.result를 내 쪽에 저장한 코드 목록과 비교하세요. 목록에 있는 코드이면 그 대상에게 배포한 이미지입니다. 목록에 없는 숫자가 나오면 워터마크가 없는 이미지이거나 크게 변형되어 읽지 못한 것으로 판단하세요.
성공한 건당 10P입니다. 실패 응답은 과금되지 않습니다.
/rest/get_watermarkimagedatadata.resultdata.successapiapi.successapi.costapi.msapi.pl_idPOST https://apick.app/rest/get_watermarkAuthorization: Bearer 내 계정의 API 인증키multipart/form-data상황별로 보내는 값과 응답에서 확인할 값을 모았습니다. 언어 탭에서 그대로 복사해 쓸 수 있습니다.
외부에서 발견한 이미지가 내가 배포한 것인지 확인합니다.
/rest/get_watermarkcurl --fail-with-body --request POST 'https://apick.app/rest/get_watermark' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form 'image=@./found_image.png'import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("image", new Blob([await readFile("./found_image.png")]), "found_image.png");
const response = await fetch("https://apick.app/rest/get_watermark", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
body: form,
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);import os
import requests
parts = [
("image", ("found_image.png", open("./found_image.png", "rb"))),
]
response = requests.request("POST", "https://apick.app/rest/get_watermark",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'image' => new CURLFile('./found_image.png'),
];
$curl = curl_init('https://apick.app/rest/get_watermark');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POSTFIELDS => $form,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);data.result가 내가 저장한 코드 목록에 있으면 그 대상에게 배포한 이미지입니다.SNS에 다시 올라오며 압축되거나 일부 잘린 이미지도 먼저 그대로 확인해 봅니다.
/rest/get_watermarkcurl --fail-with-body --request POST 'https://apick.app/rest/get_watermark' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form 'image=@./screenshot.jpg'import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("image", new Blob([await readFile("./screenshot.jpg")]), "screenshot.jpg");
const response = await fetch("https://apick.app/rest/get_watermark", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
body: form,
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);import os
import requests
parts = [
("image", ("screenshot.jpg", open("./screenshot.jpg", "rb"))),
]
response = requests.request("POST", "https://apick.app/rest/get_watermark",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'image' => new CURLFile('./screenshot.jpg'),
];
$curl = curl_init('https://apick.app/rest/get_watermark');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POSTFIELDS => $form,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);알 수 없는 이유로 실패했습니다.이면 코드를 읽지 못한 것입니다. 원본에 더 가까운 이미지로 다시 확인하세요.HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
{
"data": {
"result": 1541577,
"success": 1
},
"api": {
"success": true,
"cost": 10,
"ms": 1034,
"pl_id": 8250799
}
}code와 같은지 비교하세요.1: 성공(과금), 0: 실패, 3: 시간 초과(과금 없음).응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.{
"data": {
"error": "입력값을 확인해 주세요.",
"success": 0
},
"api": {
"success": true,
"cost": 0,
"ms": 5
}
}실패하면 data.error에 문구가 담기고 api.cost는 0입니다.
image로 보냈는지 확인하세요.FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.
같은 요청을 JavaScript와 Python으로 옮긴 예시입니다. 키는 환경변수 APICK_API_KEY 에서 읽습니다.