Connect 쿡북
Connect 쿡북
섹션 제목: “Connect 쿡북”NextPDF Connect는 Model Context Protocol, REST API, gRPC 서비스를 통해 NextPDF 엔진을 원격 호출자와 AI 시스템에 개방합니다. Connect 쿡북은 이 인터페이스를 다루는 작업 레시피 모음이며, 이 페이지는 그 색인입니다. 각 레시피에 할당된 슬러그와 모든 레시피에 적용되는 티어 및 전송 경계를 기록합니다. 이 문서는 색인이므로, 어떤 레시피의 동작도 단언하지 않습니다. 각 레시피 페이지는 nextpdf/server 저장소의 docs/public/ 아래에서 작성되고, 자체 주장을 책임지며, 출처 정보가 온전히 보존된 상태로 애그리게이터에 의해 이 사이트로 가져와집니다.
모든 Connect 레시피가 따르는 계약을 보려면 레시피 규약을 읽으십시오. 에코시스템 전반의 통합 환경에 대해서는 통합 쿡북을 읽으십시오.
티어가 실행 가능한 작업에 미치는 영향
섹션 제목: “티어가 실행 가능한 작업에 미치는 영향”Connect 배포의 도구 집합은 사전에 고정되지 않고 부팅 시 계산됩니다. 서버의 도구 레지스트리는 코어 도구를 무조건 등록합니다. 그런 다음 class_exists()로 Pro 및 Enterprise 공급자를 탐지하고, nextpdf/premium이 서버와 함께 설치되어 있을 때만 해당 도구를 등록합니다. 따라서 Pro 또는 Enterprise 도구에 의존하는 레시피는 해당 도구가 실제로 등록된 배포에서만 실행됩니다. 오픈 소스 전용 설치에서는 해당 도구가 존재하지 않으며, 호출은 조용히 기능을 낮추는 대신 알 수 없는 도구 오류를 반환합니다. 각 레시피는 자체 티어를 명시하며, 이 색인은 레시피를 티어별로 묶어 특정 배포가 무엇을 지원하는지 한눈에 알 수 있게 합니다.
전체 도구 개수는 배포의 런타임 속성입니다. 어떤 레시피나 이 색인의 어떤 행도 고정된 개수를 단언하지 않습니다. 기준 카탈로그는 서버 자체의 도구 카탈로그이며, 각 레시피가 이를 링크합니다.
전송 및 오류 모델
섹션 제목: “전송 및 오류 모델”MCP tools/call, REST 도구 엔드포인트, gRPC 서비스라는 세 가지 전송에서는 모두 같은 방식으로 레시피를 호출합니다. 이들이 하나의 도구 실행기를 공유하기 때문입니다. HTTP를 통해 원격 서비스에 도달하는 레시피는 전송 실패와 비성공 HTTP 상태를 별개의 두 사례로 취급합니다. PSR-18 클라이언트는 요청을 전혀 전송할 수 없을 때만 타입이 지정된 클라이언트 예외를 발생시킵니다 — PSR-18 §4. 반면 4xx 또는 5xx 응답은 호출자가 검사하는 정상적인 반환 값이며 예외가 아닙니다 — PSR-18 §4.
레시피 슬러그 맵
섹션 제목: “레시피 슬러그 맵”각 레시피는 /cookbook/connect/<recipe>/에 위치합니다. 이 표는 슬러그, 레시피를 읽을 때 적용되는 티어, 그리고 한 줄 범위 설명을 기록합니다. 레시피 페이지는 nextpdf/serverdocs/public/에서 작성된 뒤 여기에 집계됩니다. 페이지가 추가되기 전까지 해당 링크는 전방 참조입니다.
| 레시피 | 티어 | 범위 |
|---|---|---|
hello-world (업스트림에서 계획됨) | 코어 | 첫 Connect 호출: 생성, 콘텐츠 추가, 출력 |
multi-page (업스트림에서 계획됨) | 코어 | Connect를 통한 멀티 페이지 문서 |
image-embedding (업스트림에서 계획됨) | 코어 | Connect를 통한 이미지 임베드 |
html-table (업스트림에서 계획됨) | 코어 | Connect를 통한 HTML 테이블 렌더링 |
font-typography (업스트림에서 계획됨) | 코어 | Connect를 통한 폰트와 타이포그래피 |
exception-aware (업스트림에서 계획됨) | 코어 | 예외 인식 도구 호출 |
environment-diagnostics (업스트림에서 계획됨) | 코어 | 환경 진단 도구 |
layout-inspection (업스트림에서 계획됨) | 코어 | 렌더링 없이 레이아웃 검사 |
worker-safe (업스트림에서 계획됨) | 코어 | 워커 안전 배치 사용 |
output-approval (업스트림에서 계획됨) | 코어 | 휴먼 인 더 루프 출력 게이트 |
event-hooks (업스트림에서 계획됨) | 코어 | 라이프사이클 이벤트 훅 |
fill-pdf-form (업스트림에서 계획됨) | Pro | Connect를 통한 PDF 양식 작성 |
extract-text-content (업스트림에서 계획됨) | Pro | Connect를 통한 텍스트 콘텐츠 추출 |
digital-signature (업스트림에서 계획됨) | Pro | Connect를 통한 PDF 서명 (PAdES B-B 및 B-T) |
accessibility-check (업스트림에서 계획됨) | Pro | PDF/UA 접근성 검사 |
pii-redaction (업스트림에서 계획됨) | Enterprise | 텍스트 레이어에서 감지된 개인 데이터 제거 (파괴적) |
aria-tagged-pdf (업스트림에서 계획됨) | Pro | ARIA 랜드마크 역할을 태그 구조에 매핑 |
figure-caption (업스트림에서 계획됨) | Pro | Caption이 중첩된 접근 가능한 Figure |
aria-noteref-pattern (업스트림에서 계획됨) | Pro | 각주 참조와 본문 패턴 |
compliance-check (업스트림에서 계획됨) | Enterprise | 명명된 표준 검사 실행 |
forensic-analysis (업스트림에서 계획됨) | Enterprise | 서명된 PDF의 포렌식 분석 |
ltv-health-check (업스트림에서 계획됨) | Enterprise | LTV 상태 검사 (B-LT/B-LTA, Enterprise 전용) |
batch-compliance (업스트림에서 계획됨) | Enterprise | 배치 표준 검사 |
ai-ready-certification (업스트림에서 계획됨) | Enterprise | AI 준비도 검사 (인증이 아님) |
page-artifacts (업스트림에서 계획됨) | Enterprise | 페이지네이션 크롬을 아티팩트로 표시 |
conformance-mode (업스트림에서 계획됨) | Enterprise | 준수 모드 선택 (준수를 의도함; 검증기가 결정함) |
cjk-vertical-writing (업스트림에서 계획됨) | Enterprise | CJK 세로쓰기 메트릭 |
opentelemetry (업스트림에서 계획됨) | 코어 | OpenTelemetry로 Connect 관측 |
tagged-pdf-tutorial (업스트림에서 계획됨) | 코어 | 태그된 PDF 튜토리얼 (준수를 의도함; veraPDF가 결정함) |
슬러그는 레시피의 의도를 케밥 케이스로 표현한 값이며 끝에 슬래시 하나가 붙습니다: 숫자 접두사, 버전 번호, 파일 확장자가 없습니다. 레시피 슬러그는 게시된 뒤에는 변경되지 않으며, 이동된 슬러그에는 리디렉션이 따라옵니다.
준수 및 인증 경계
섹션 제목: “준수 및 인증 경계”여러 레시피가 표준(PDF/UA-2, PDF/A-4, PAdES)을 다룹니다. Connect 쿡북에서 표준 지원은 말 그대로 지원을 의미하며, 결코 준수나 인증을 의미하지 않습니다. 엔진은 준수를 의도한 출력을 생성하고, 독립적인 검증기(예: veraPDF)가 준수 여부를 결정합니다. AI 준비도 레시피는 준비도 검사이며 인증이 아닙니다. LTV 레시피의 장기 검증 자료는 Enterprise 전용 기능입니다. 문서에 해당 자료가 있다는 것은 문서가 지닌 기능을 뜻할 뿐, 무기한 서명 유효성을 보장하지 않습니다. 관련된 각 레시피는 이러한 경계를 모두 다시 설명합니다. 이 색인은 그러한 경계가 존재한다는 사실만 언급하고 어디에서 도출되는지를 가리킬 뿐, 여기서 다시 도출하지 않습니다.