PDF Metadata

제목, 작성자, 주제, 키워드 같은 PDF 문서 메타데이터 필드를 읽고 업데이트합니다. 설정을 제공하지 않으면 기존 메타데이터가 수정 없이 반환됩니다.

API Endpoint

POST /api/v1/tools/pdf/pdf-metadata

PDF 파일과 선택적 JSON settings 필드가 포함된 multipart form data를 받습니다.

Parameters

Parameter	Type	Required	Default	Description
title	string	No	-	문서 제목 (최대 500자)
author	string	No	-	문서 작성자 (최대 500자)
subject	string	No	-	문서 주제 (최대 500자)
keywords	string	No	-	문서 키워드 (최대 500자)

모든 매개변수는 선택 사항입니다. 생략된 필드는 변경되지 않습니다.

Example Request

curl -X POST http://localhost:1349/api/v1/tools/pdf/pdf-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@report.pdf" \
  -F 'settings={"title": "Q2 Report", "author": "Finance Team"}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/report.pdf",
  "originalSize": 245000,
  "processedSize": 245200,
  "metadata": {
    "title": "Q2 Report",
    "author": "Finance Team",
    "subject": "",
    "keywords": ""
  }
}

Notes

• 허용되는 입력 형식: .pdf.
• 이 도구는 결과를 직접 반환하는 빠른(동기) 도구입니다.
• 응답의 metadata 필드에는 업데이트 후 결과 메타데이터가 담겨 있습니다.
• 메타데이터를 수정하지 않고 읽으려면 settings 필드를 생략하거나 빈 객체를 보내세요.
• 각 메타데이터 필드는 500자로 제한됩니다.