기본 주소

기본 주소

모든 엔드포인트는 이 접두사 아래에 있습니다. 로컬 설치의 기본 주소는 아래 값입니다.

https://api.pdfgine.com/api/v1

목록 엔드포인트 페이지 나누기

페이지 나누기를 지원하는 목록 엔드포인트는 템플릿의 /history, /assets, /marketplace/templates, /templates, /components 다섯 개입니다. 각각 선택 사항인 limit(1-200)와 before를 받으며 응답은 계속 일반 배열이므로 기존 읽기 코드를 변경할 필요가 없습니다.

limit가 없으면 최대 200개 행을 반환하며 더 있으면 응답에 rel="next"가 포함된 Link 헤더가 제공됩니다. 다음 URL을 직접 만들지 말고 이 링크를 따르세요. 커서는 기록에서는 버전 번호, 에셋에서는 에셋 ID, 나머지에서는 불투명한 값이며 헤더만 어떤 값인지 알고 있습니다. /marketplace/templates의 커서는 필터도 포함하므로 검색, 카테고리, locale이 바뀌면 즉시 사용할 수 없게 됩니다. 같은 커서가 다른 목록을 가리키지 않도록 의도한 동작입니다. 나머지 목록 엔드포인트는 이미 크기가 제한된 컬렉션을 반환합니다. 잘린 응답에는 X-PDFgine-List-Truncated: true와 X-PDFgine-List-Limit도 포함되며 마지막 페이지에는 둘 다 없습니다.

기계가 읽을 수 있는 명세

이 페이지들의 모든 내용은 OpenAPI 3.0 문서로도 게시됩니다. 클라이언트 생성기, Postman 또는 편집기에 연결하면 수작업 복사 없이 경로, 요청 본문, 예시 페이로드를 가져올 수 있습니다.

https://api.pdfgine.com/openapi/v1.json

문서는 실행 중인 API에서 생성되므로 누군가 기록해 둔 버전이 아니라 실제 호출하는 버전을 설명합니다.