API 요청
/rest/draw_watermark_pdf요청 파라미터 9개 · 필수 2
pdfwm- 예시
CONFIDENTIAL
font_sizecoloropacityangledensitywidthheight응답 필드 파일
정상 응답은 파일 본문입니다. 실패 시 JSON 오류가 올 수 있으므로 HTTP 상태와 Content-Type을 먼저 확인하세요.
PDF 파일의 모든 페이지에 지정한 글자를 반복 무늬로 비스듬히 새긴 PDF를 돌려줍니다. 응답은 JSON이 아닌 PDF 파일입니다.
https://apick.app/rest/draw_watermark_pdf왜 PDF 워터마크 삽입인가
외부로 나간 제안서·교재 PDF가 어디서 새는지 모르면 막을 방법도 없습니다. PDF 파일에 워터마크를 넣어 소유와 용도를 분명히 하고 무단 배포를 망설이게 만듭니다.
REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.
내부 문서·견적서·시안 PDF에 "대외비", "SAMPLE", 열람자 이름처럼 보이는 표시를 넣어 유출을 막을 때 사용합니다. PDF 형식만 받습니다.
글자는 각 페이지의 width × height 영역 안에 angle 각도로 반복해서 찍힙니다. 기본값(550 × 800)은 A4 한 장을 덮는 크기입니다. 글자가 너무 진하면 opacity를 낮추고, 간격이 넓으면 density를 높이세요.
성공한 건당 10P이며 페이지 수와 관계없습니다. 실패 응답은 과금되지 않습니다.
/rest/draw_watermark_pdfpdfwmCONFIDENTIALfont_sizecoloropacityangledensitywidthheight정상 응답은 파일 본문입니다. 실패 시 JSON 오류가 올 수 있으므로 HTTP 상태와 Content-Type을 먼저 확인하세요.
POST https://apick.app/rest/draw_watermark_pdfAuthorization: Bearer 내 계정의 API 인증키multipart/form-data상황별로 보내는 값과 응답에서 확인할 값을 모았습니다. 언어 탭에서 그대로 복사해 쓸 수 있습니다.
글자만 정하고 나머지는 기본값(옅은 회색, 35도)으로 모든 페이지에 넣습니다.
/rest/draw_watermark_pdfcurl --fail-with-body --request POST 'https://apick.app/rest/draw_watermark_pdf' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form 'pdf=@./report.pdf' \
--form-string 'wm=CONFIDENTIAL' \
--dump-header response.headers --output result.bin
# response.headers의 Content-Type을 확인한 뒤 파일을 사용하세요.import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("pdf", new Blob([await readFile("./report.pdf")]), "report.pdf");
form.append("wm", "CONFIDENTIAL");
const response = await fetch("https://apick.app/rest/draw_watermark_pdf", {
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()}`);
if ((response.headers.get("content-type") || "").includes("json")) {
throw new Error(JSON.stringify(await response.json()));
}
const { writeFile } = await import("node:fs/promises");
await writeFile("result.bin", new Uint8Array(await response.arrayBuffer()));import os
import requests
parts = [
("pdf", ("report.pdf", open("./report.pdf", "rb"))),
("wm", (None, "CONFIDENTIAL")),
]
response = requests.request("POST", "https://apick.app/rest/draw_watermark_pdf",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120), stream=True)
response.raise_for_status()
if "json" in response.headers.get("Content-Type", ""):
raise RuntimeError(response.json())
with open("result.bin", "wb") as output:
for chunk in response.iter_content(65536):
output.write(chunk)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'pdf' => new CURLFile('./report.pdf'),
'wm' => 'CONFIDENTIAL',
];
$curl = curl_init('https://apick.app/rest/draw_watermark_pdf');
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);
$type = curl_getinfo($curl, CURLINFO_CONTENT_TYPE) ?: "";
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
if (strpos($type, "json") !== false) { throw new RuntimeException($body); }
file_put_contents('result.bin', $body);Content-Type이 application/pdf이면 output.pdf로 저장합니다.유출 추적용으로 열람자 이름을 더 잘 보이게 넣습니다.
/rest/draw_watermark_pdfcurl --fail-with-body --request POST 'https://apick.app/rest/draw_watermark_pdf' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form 'pdf=@./report.pdf' \
--form-string 'wm=홍길동 열람용' \
--form-string 'font_size=16' \
--form-string 'color=888888' \
--form-string 'opacity=0.2' \
--form-string 'angle=45' \
--form-string 'density=180' \
--dump-header response.headers --output result.bin
# response.headers의 Content-Type을 확인한 뒤 파일을 사용하세요.import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("pdf", new Blob([await readFile("./report.pdf")]), "report.pdf");
form.append("wm", "홍길동 열람용");
form.append("font_size", "16");
form.append("color", "888888");
form.append("opacity", "0.2");
form.append("angle", "45");
form.append("density", "180");
const response = await fetch("https://apick.app/rest/draw_watermark_pdf", {
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()}`);
if ((response.headers.get("content-type") || "").includes("json")) {
throw new Error(JSON.stringify(await response.json()));
}
const { writeFile } = await import("node:fs/promises");
await writeFile("result.bin", new Uint8Array(await response.arrayBuffer()));import os
import requests
parts = [
("pdf", ("report.pdf", open("./report.pdf", "rb"))),
("wm", (None, "홍길동 열람용")),
("font_size", (None, "16")),
("color", (None, "888888")),
("opacity", (None, "0.2")),
("angle", (None, "45")),
("density", (None, "180")),
]
response = requests.request("POST", "https://apick.app/rest/draw_watermark_pdf",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120), stream=True)
response.raise_for_status()
if "json" in response.headers.get("Content-Type", ""):
raise RuntimeError(response.json())
with open("result.bin", "wb") as output:
for chunk in response.iter_content(65536):
output.write(chunk)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'pdf' => new CURLFile('./report.pdf'),
'wm' => '홍길동 열람용',
'font_size' => '16',
'color' => '888888',
'opacity' => '0.2',
'angle' => '45',
'density' => '180',
];
$curl = curl_init('https://apick.app/rest/draw_watermark_pdf');
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);
$type = curl_getinfo($curl, CURLINFO_CONTENT_TYPE) ?: "";
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
if (strpos($type, "json") !== false) { throw new RuntimeException($body); }
file_put_contents('result.bin', $body);color는 # 없이 6자리로 보냅니다.… 값만 허용됩니다. 문구로 거절되며 과금되지 않습니다.가로로 긴 페이지는 워터마크 영역 크기를 페이지에 맞춰 늘립니다.
/rest/draw_watermark_pdfcurl --fail-with-body --request POST 'https://apick.app/rest/draw_watermark_pdf' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form 'pdf=@./slides.pdf' \
--form-string 'wm=SAMPLE' \
--form-string 'width=800' \
--form-string 'height=550' \
--dump-header response.headers --output result.bin
# response.headers의 Content-Type을 확인한 뒤 파일을 사용하세요.import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("pdf", new Blob([await readFile("./slides.pdf")]), "slides.pdf");
form.append("wm", "SAMPLE");
form.append("width", "800");
form.append("height", "550");
const response = await fetch("https://apick.app/rest/draw_watermark_pdf", {
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()}`);
if ((response.headers.get("content-type") || "").includes("json")) {
throw new Error(JSON.stringify(await response.json()));
}
const { writeFile } = await import("node:fs/promises");
await writeFile("result.bin", new Uint8Array(await response.arrayBuffer()));import os
import requests
parts = [
("pdf", ("slides.pdf", open("./slides.pdf", "rb"))),
("wm", (None, "SAMPLE")),
("width", (None, "800")),
("height", (None, "550")),
]
response = requests.request("POST", "https://apick.app/rest/draw_watermark_pdf",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120), stream=True)
response.raise_for_status()
if "json" in response.headers.get("Content-Type", ""):
raise RuntimeError(response.json())
with open("result.bin", "wb") as output:
for chunk in response.iter_content(65536):
output.write(chunk)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'pdf' => new CURLFile('./slides.pdf'),
'wm' => 'SAMPLE',
'width' => '800',
'height' => '550',
];
$curl = curl_init('https://apick.app/rest/draw_watermark_pdf');
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);
$type = curl_getinfo($curl, CURLINFO_CONTENT_TYPE) ?: "";
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
if (strpos($type, "json") !== false) { throw new RuntimeException($body); }
file_put_contents('result.bin', $body);width·height는 0~2000입니다. 기본값 550×800은 세로 A4 기준입니다.HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
성공하면 워터마크가 들어간 PDF 본문이 바로 옵니다. 내려받기 파일명은 output.pdf입니다.
1이면 처리에 성공한 것입니다.application/pdf응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
실패하면 PDF 대신 JSON이 옵니다. HTTP 상태와 Content-Type을 먼저 확인하고, JSON이면 data.error 문구를 기록하세요. 실패 응답의 api.cost는 0입니다.
wm에 글자를 넣으세요.wm을 30자 이하로 줄이세요.pdf로 보냈는지 확인하세요.FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.
같은 요청을 JavaScript와 Python으로 옮긴 예시입니다. 키는 환경변수 APICK_API_KEY 에서 읽습니다.