PDF 워터마크 삽입

기능·제공 범위

인증: Bearer 키
요청: form-data
응답: JSON · 파일
요금·이용 조건: 기본 단가 10P · 건당

빠른 시작

서버의 APICK_API_KEY를 준비하고 입력값을 바꾸세요. 아래에서 경로별 입력·응답·실행 환경을 함께 확인할 수 있습니다.

요청과 응답

API 요청 예제직접 실행하지 않습니다POST /rest/draw_watermark_pdf

POSIX 셸 · APICK_API_KEY 환경변수를 먼저 설정하세요. Windows에서는 Unicode 지원 cURL을 사용하세요.

curl --fail-with-body --request POST 'https://apick.app/rest/draw_watermark_pdf' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form 'pdf=@/C:/Users/user/Desktop/sample_document.pdf' \
  --form-string 'wm=watermark' \
  --form-string 'font_size=10' \
  --form-string 'color=EEEEEE' \
  --form-string 'opacity=0.05' \
  --form-string 'angle=10' \
  --form-string 'density=100' \
  --dump-header response.headers --output result.bin
# response.headers의 Content-Type을 확인한 뒤 파일을 사용하세요.

Node.js 22+ · 서버에서 실행하는 ESM 예제입니다. 키를 브라우저에 넣지 마세요.

import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("pdf", new Blob([await readFile("/C:/Users/user/Desktop/sample_document.pdf")]), "sample_document.pdf");
form.append("wm", "watermark");
form.append("font_size", "10");
form.append("color", "EEEEEE");
form.append("opacity", "0.05");
form.append("angle", "10");
form.append("density", "100");
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()));

Python 3 · requests 설치가 필요합니다. 키는 서버 환경변수로 읽습니다.

import os
import requests
parts = [
    ("pdf", ("sample_document.pdf", open("/C:/Users/user/Desktop/sample_document.pdf", "rb"))),
    ("wm", (None, "watermark")),
    ("font_size", (None, "10")),
    ("color", (None, "EEEEEE")),
    ("opacity", (None, "0.05")),
    ("angle", (None, "10")),
    ("density", (None, "100")),
]
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 8 · cURL 확장이 필요합니다. 키는 서버 환경변수로 읽습니다.

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'pdf' => new CURLFile('/C:/Users/user/Desktop/sample_document.pdf'),
    'wm' => 'watermark',
    'font_size' => '10',
    'color' => 'EEEEEE',
    'opacity' => '0.05',
    'angle' => '10',
    'density' => '100',
];
$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);

POSIX 셸 · APICK_API_KEY 환경변수를 먼저 설정하세요. Windows에서는 Unicode 지원 cURL을 사용하세요.

curl --fail-with-body --request POST 'https://apick.app/rest/draw_watermark_pdf' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --connect-timeout 10 --max-time 120 \
  --form 'pdf=@/C:/Users/user/Desktop/sample_document.pdf' \
  --form-string 'wm=watermark' \
  --form-string 'font_size=10' \
  --form-string 'color=EEEEEE' \
  --form-string 'opacity=0.05' \
  --form-string 'angle=10' \
  --form-string 'density=100' \
  --dump-header response.headers --output result.bin
# response.headers의 Content-Type을 확인한 뒤 파일을 사용하세요.

Node.js 22+ · 서버에서 실행하는 ESM 예제입니다. 키를 브라우저에 넣지 마세요.

import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("pdf", new Blob([await readFile("/C:/Users/user/Desktop/sample_document.pdf")]), "sample_document.pdf");
form.append("wm", "watermark");
form.append("font_size", "10");
form.append("color", "EEEEEE");
form.append("opacity", "0.05");
form.append("angle", "10");
form.append("density", "100");
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()));

Python 3 · requests 설치가 필요합니다. 키는 서버 환경변수로 읽습니다.

import os
import requests
parts = [
    ("pdf", ("sample_document.pdf", open("/C:/Users/user/Desktop/sample_document.pdf", "rb"))),
    ("wm", (None, "watermark")),
    ("font_size", (None, "10")),
    ("color", (None, "EEEEEE")),
    ("opacity", (None, "0.05")),
    ("angle", (None, "10")),
    ("density", (None, "100")),
]
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 8 · cURL 확장이 필요합니다. 키는 서버 환경변수로 읽습니다.

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'pdf' => new CURLFile('/C:/Users/user/Desktop/sample_document.pdf'),
    'wm' => 'watermark',
    'font_size' => '10',
    'color' => 'EEEEEE',
    'opacity' => '0.05',
    'angle' => '10',
    'density' => '100',
];
$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);

API 요청

POST/rest/draw_watermark_pdf

Bearer 인증 · multipart/form-data · 파일 응답

입력 항목

폼 항목·타입

필수

설명·예제

pdffile

필수

PDF 파일

wmstring

필수

워터마크 문자열 (최대 30자)예: watermark

font_sizeinteger

선택

워터마크 글자 크기 (8 ~ 30, 기본값 10)예: 10

colorstring

선택

워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE)예: EEEEEE

opacitynumber

선택

워터마크 투명도 (0 ~ 1, 기본값 0.05)예: 0.05

angleinteger

선택

워터마크 각도 (0 ~ 360, 기본값 35)예: 10

densityinteger

선택

워터마크 글자 밀집도 (100 ~ 200, 기본값 150)예: 100

widthinteger

선택

워터마크 적용 너비 (0 ~ 2000, 기본값 550, A4 기준)

heightinteger

선택

워터마크 적용 높이 (0 ~ 2000, 기본값 800, A4 기준)

응답과 성공 판정

HTTP 성공과 업무 결과를 구분하세요. 아래 서비스별 결과 필드가 실제 성공·실패를 나타냅니다.

파일 직접 응답

application/pdf · 정상 응답의 본문을 파일로 저장하세요. 실패하면 JSON 오류가 올 수 있으므로 HTTP 상태와 Content-Type을 먼저 확인하세요.

추가 입력 조건·전송 규칙

Header

이름

필수

설명

Authorization

O

Bearer 인증키

응답 상세

서비스 고유 응답·필드 상세 설명

Header

이름

필수

설명

success

O

API 서버 정상 응답 여부

cost

O

API 호출 요금

ms

O

API 응답 시간

Content-Type

O

응답 바디 데이터 타입

Content-Disposition

O

파일명
(output 고정)

Body

이름

타입

설명

PDF 형식의 바이너리 데이터

경로별 응답 예시와 필드 명세는 위 API 요청 설명에 붙어 있습니다. JSON을 파일로 저장하기 전에는 Content-Type과 오류를 확인하세요.

상태·오류·재시도

HTTP 상태 → API 처리 여부 → 업무 상태 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.

공통 폼 입력 오류

FORM_DATA_INVALID · HTTP 400: 필드 이름·타입·배열 인덱스를 확인하세요. 인덱스는 0부터 연속으로 사용합니다.

FORM_DATA_FIELD_CONFLICT · HTTP 400: 같은 값과 중첩 경로를 동시에 지정하지 마세요.

MULTIPART_LIMIT_OR_PARSE_ERROR · HTTP 400/413: boundary·파일 크기·필드 개수를 확인하세요. 서비스별 제한이 우선 적용됩니다.

요금·제한·이용 조건

기능·제공 범위·요금·제한 전체 보기

업로드 용량 제한: 1GB
multipart/form-data 요청에 포함된 첨부파일 합계는 최대 1GB입니다. 처리시간은 재생시간, 페이지 수와 파일 형식에 따라 늘어날 수 있습니다.
제한을 초과하면 HTTP 413과 REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.

Method

URL

POST

https://apick.app/rest/draw_watermark_pdf

연동 시 확인할 내용

예제는 경로별로 최소 요청과 오류 처리 포함 모드를 제공합니다. 실제 사용 환경의 시간 제한·취소·업무 성공 판정을 적용하세요.

추가 예제·서비스별 연동 안내

결과 예시

[이미지]

요청 예시

form-data 전체 예제 보기

응답 예시


{PDF 형식의 바이너리 데이터}

기능·제공 범위

빠른 시작

요청과 응답

API 요청

입력 항목

응답과 성공 판정

Header

응답 상세

Header

Body

상태·오류·재시도

요금·제한·이용 조건

연동 시 확인할 내용

결과 예시

요청 예시

응답 예시

개발가이드 검색

AI•LLM

전체상품

API 체험하기

요금정책

고객지원

개발가이드