로그인 없이: 익명 요청 제한이 무료 도구를 무료로 유지하는 방법

PDF123는 계정 없이 업로드와 다운로드를 하는 경로를 유지합니다. 같은 작업이 /api/v1/ 아래에도 있어서, 스크립트가 사람이 Process를 누르지 않고도 호출할 수 있습니다. 익명 사용에는 API 키가 필요 없습니다. 요청 제한은 그 표면이 무제한 무료 호스트가 되지 않게 막습니다.

익명이 기본 경로입니다

PDF 압축나 PDF 병합 같은 도구 페이지에 파일을 떨어뜨리고 실행하세요. 카탈로그 도구라면 /api/v1/ 아래의 익명 REST도 똑같이 동작합니다. /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/, /api/v1/filter/ 아래 엔드포인트가 익명 도구 접두사이고, 포털의 모든 카탈로그 도구가 이 경로에 매핑됩니다.

로그인이 있는 이유는 자동화용 개인 API 키를 만들기 위해서이지, Process를 유료벽으로 만들기 위해서가 아닙니다. 브라우저 폼과 HTTP 계약은 계속 맞춰져 있습니다. 각 도구 페이지의 “Call this from code” 블록은 폼이 보내는 것과 같은 필드로 curl을 만듭니다.

관리자와 사용자 프로필 등 도구가 아닌 경로는 이 접두사 밖입니다. 익명 호출자가 게이트가 걸린 경로를 두드리면 인증 실패를 받지, API 표면 전체를 무료로 통과하지는 못합니다.

응답 헤더가 말하는 것

모든 호스팅 API 응답은 예산을 알립니다(pdfx-server에 구현돼 있습니다).

• X-RateLimit-Limit: 이 응답에 대해 알리는 기간 상한
• X-RateLimit-Remaining: 현재 기간에 남은 예산
• X-RateLimit-Reset: 창의 리셋 표시(값을 읽으세요. 달력상 하루라고 가정하지 마세요)

HTTP 429에서는 Retry-After가 예의 바른 클라이언트에게 언제 다시 시도할지 알려 줍니다. 할당량 실패는 개발자 오류의 구조화된 rate_limited problem 코드를 쓰고, 다른 API 실패와 같은 application/problem+json 형태입니다. 스크립트는 HTML 오류 페이지를 긁지 않고 코드를 보고 분기할 수 있습니다.

숫자 상한은 배포 설정에 따라 바뀔 수 있습니다. 특정 응답에 붙은 헤더가 사실이고, 블로그 스냅샷이 아닙니다. 이 글의 일일 숫자를 하드코딩한 클라이언트는 운영자가 기간을 다시 조율하는 순간 틀립니다. 호출할 때마다 X-RateLimit-Remaining을 읽고 0에 가까워지면 물러서는 편이 낫습니다.

무료 도구인데도 호출자를 제한하는 이유

상한이 없으면 익명 엔드포인트는 남의 배치 농장이 됩니다. 제한은 일회성 작업을 쓸 수 있게 두면서, 더 무겁거나 사적인 작업량을 키나 자체 호스팅으로 옮기게 합니다.

상한은 정말 비싼 op의 공유 CPU도 보호합니다. 큰 병합, 스캔에서 Markdown을 돌려주는 OCR(text/markdown이고 재층화 PDF가 아닙니다), 여러 단계를 잇는 POST /api/v1/pipeline 실행이 그렇습니다. 제품 선택은 “익명이지만 유한함”이지 “익명이고 무제한”이 아닙니다.

익명 접근도 여전히 임시 처리입니다. 업로드는 그 작업을 위해 다뤄지고 결과가 준비되면 정리됩니다. 요청 제한은 용량의 공정성에 관한 것이지, 무료 로그인 벽 뒤에 장기 문서 저장소를 만드는 일이 아닙니다.

키는 신원을 바꾸지 카탈로그를 바꾸지 않습니다

안정적인 호출자 신원이 필요하거나, 작업을 두 번 실행하면 안 되는 Idempotency-Key 재시도가 필요하거나, 고정 전역 키를 쓰는 자체 호스팅 서버(내 머신의 SECURITY_CUSTOMGLOBALAPIKEY)가 필요하면 개발자에서 키를 만드세요. OpenAPI는 어느 base URL을 치든 /v1/openapi.json에 있습니다.

/mcp의 MCP는 자동화 클라이언트에 같은 카탈로그와 같은 키 규칙을 따릅니다. 호출자가 익명이든 키를 가졌든 연산은 같습니다. 달라지는 것은 인증과 할당량입니다.

한 op에 대한 네 가지 손잡이(브라우저, curl, MCP, CLI)는 같은 연산, 네 개의 클라이언트를 보세요. 상한이나 보존이 부족해 표면 전체를 자체 네트워크로 옮기려면 자체 호스팅이 실제로 사 주는 것을 보세요.