{"openapi":"3.0.3","info":{"title":"APICK PDF 워터마크 삽입","version":"1.0.0","description":"PDF 파일의 모든 페이지에 지정한 글자를 반복 무늬로 비스듬히 새긴 PDF를 돌려줍니다. 응답은 JSON이 아닌 PDF 파일입니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/draw_watermark_pdf":{"post":{"summary":"PDF 워터마크 삽입","description":"PDF 파일의 모든 페이지에 지정한 글자를 반복 무늬로 비스듬히 새긴 PDF를 돌려줍니다. 응답은 JSON이 아닌 PDF 파일입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"파일 직접 응답","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"pdf":{"type":"string","description":"변환·분석할 PDF 파일입니다. 암호가 설정된 PDF는 실패할 수 있으며, 용량·페이지 제한을 확인하세요. (file)","format":"binary"},"wm":{"type":"string","description":"이미지에 반복 삽입할 워터마크 문구입니다. 최대 30자이며, 한글·영문·숫자를 지원합니다. 너무 길면 잘리거나 밀집도가 낮아집니다. (string)","example":"CONFIDENTIAL"},"font_size":{"type":"string","description":"워터마크 글자 크기 (8 ~ 30, 기본값 10) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)"},"color":{"type":"string","description":"워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE) (string)"},"opacity":{"type":"string","description":"워터마크 투명도 (0 ~ 1, 기본값 0.05) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"angle":{"type":"string","description":"워터마크를 회전할 각도입니다. 0~360도이며, 생략하면 35도입니다. 0이면 가로 방향으로 반복됩니다. (integer)"},"density":{"type":"string","description":"워터마크가 반복되는 간격 계수입니다. 100~200 범위이며, 값이 작을수록 촘촘하게 반복됩니다. 생략하면 150입니다. (integer)"},"width":{"type":"string","description":"워터마크를 적용할 영역의 너비(px)입니다. 0~2000 범위이며, A4 기준 기본값은 550입니다. 원본 이미지보다 크면 잘릴 수 있습니다. (integer)"},"height":{"type":"string","description":"워터마크를 적용할 영역의 높이(px)입니다. 0~2000 범위이며, A4 기준 기본값은 800입니다. 원본 이미지 비율과 맞춰 조정하세요. (integer)"}},"required":["pdf","wm"]}}}}}}},"x-code-tables":[{"title":"오류와 대처","columns":["HTTP","data.error","대처"],"rows":[["400","필수 입력값이 없습니다.","wm에 글자를 넣으세요."],["400","마킹 문자는 최대 30자까지 허용됩니다.","wm을 30자 이하로 줄이세요."],["424","opacity·angle·font_size·density·width·height 값은 … 값만 허용됩니다.","문구에 나온 항목을 위 표의 범위 안으로 고치세요."],["400","파일 유형이 맞지 않습니다. PDF 형식의 파일만 허용됩니다.","실제 PDF 파일인지 확인하세요."],["424","첨부파일이 없습니다.","파일 필드 이름을 pdf로 보냈는지 확인하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}