PDF Tools API

PDF 가림 처리 API

백엔드, 배치 작업, 제품 워크플로에 PDF 영역 가림 처리을 넣고 별도 PDF 처리 인프라를 줄입니다.

Create API Key Read full API docs

Credits

1 Credit / call

1 Credit per successful API request. Failed processing attempts are refunded automatically.

Pricing

1,000 Credits = $1

Every signed-in user receives 100 free API Credits each month.

Endpoint

/api/external/pdf-tools/pdf-redaction

Use your API Key in the x-api-key header.

Use case

개인정보, 금액, 고객 정보, 내부 메모를 공유 전에 가리는 경우에 적합합니다. 수동 검토는 웹 도구, 반복되는 서버 작업은 API로 나눠 운영할 수 있습니다.

cURL example

curl -X POST https://itextmaster.com/api/external/pdf-tools/pdf-redaction \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"areas":[{"page":1,"x":72,"y":120,"width":180,"height":36,"replacementText":"REDACTED"}],"color":{"r":0,"g":0,"b":0}}' \
  --output redacted.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/pdf-tools/pdf-redaction \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"areas":[{"page":1,"x":72,"y":120,"width":180,"height":36,"replacementText":"REDACTED"}],"color":{"r":0,"g":0,"b":0}}' \
  --output redacted.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/pdf-tools/pdf-redaction \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "file": { "name": "input.pdf", "dataBase64": "JVBERi0xLjcK..." },
    "options": {"areas":[{"page":1,"x":72,"y":120,"width":180,"height":36,"replacementText":"REDACTED"}],"color":{"r":0,"g":0,"b":0}}
  }' \
  --output redacted.pdf

Node.js example

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://itextmaster.com/api/external/pdf-tools/pdf-redaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  file: { name: 'input.pdf', dataBase64: 'JVBERi0xLjcK...' },
  options: {"areas":[{"page":1,"x":72,"y":120,"width":180,"height":36,"replacementText":"REDACTED"}],"color":{"r":0,"g":0,"b":0}}
})
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile('redacted.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/pdf-tools/pdf-redaction',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'file': {'name': 'input.pdf', 'dataBase64': 'JVBERi0xLjcK...'},
        'options': {'areas': [{'page': 1, 'x': 72, 'y': 120, 'width': 180, 'height': 36, 'replacementText': 'REDACTED'}], 'color': {'r': 0, 'g': 0, 'b': 0}}
    },
)
response.raise_for_status()

with open('redacted.pdf', 'wb') as f:
    f.write(response.content)

Error codes

401invalid_api_key

x-api-key가 없거나 유효하지 않거나 교체되었습니다.

402insufficient_credits

계정의 API Credits가 부족합니다.

422pdf_tool_processing_failed

파일, 옵션 또는 PDF 구조를 처리할 수 없습니다. 실패한 처리는 Credits가 자동 환불됩니다.

Limits

정상적으로 열리는 PDF 또는 유효한 입력 데이터가 필요합니다.
API Key는 서버에 보관하고 브라우저에 노출하지 마세요.
대량 처리 전 대표 파일로 결과를 검토하세요.

Response headers

redacted.pdf와 함께 사용 Credits 및 잔여 Credits 응답 헤더가 반환됩니다.

Content-Type: 생성 파일의 MIME 유형입니다. 보통 application/pdf 또는 application/zip입니다.
Content-Disposition: 생성 파일의 다운로드 파일명입니다.
X-Credits-Charged: 성공한 요청에서 차감된 Credits입니다.
X-Credit-Balance: 요청 후 남은 API Credits입니다.

FAQ