> ## Documentation Index > Fetch the complete documentation index at: https://make.edicus.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # 프리뷰 썸네일 URL 목록 > 프로젝트의 프리뷰용 썸네일 이미지 URL 목록을 반환합니다. 각 항목은 jpg 파일 링크입니다. URL 개수는 상품마다 다릅니다. 상품별 썸네일 지원 여부는 Edicus Manager의 **Product → 개별상품 → etc → thumbnail**에서 `all-page`, `front-page`, `none` 중 선택한 값을 따릅니다. 2018년 1월 2일 이후 새로 만들어졌거나 저장된 상품만 지원합니다. 프리뷰가 없거나 프로젝트가 없으면 404가 아니라 200이고 `urls`가 빈 배열입니다. `edicus-uid`가 필요 없습니다. ## OpenAPI ````yaml /api-reference/openapi.json get /v2/projects/{project_id}/preview_urls openapi: 3.1.0 info: title: Edicus Server API version: 1.1.5 description: >- Edicus 편집기 연동에 필요한 서버 API입니다. 토큰 발급, 프로젝트 조회, 주문 처리, 폰트와 상품 정보, 템플릿 등록을 다룹니다. ## 반드시 서버에서만 호출합니다 모든 엔드포인트는 `edicus-api-key` 헤더를 요구합니다. 이 키는 고객사 서버에만 두고 브라우저 코드나 공개 저장소에 넣지 않습니다. 브라우저에는 이 API로 발급받은 토큰만 내려보냅니다. ## 오류 응답 `api.edicus.io`는 실패를 4xx와 5xx 상태 코드로 알리고, body는 언제나 `{"error": {"code", "message", "details", "request_id"}}` 모양입니다. `error.code`로 분기합니다. 같은 `request_id`가 응답 헤더 `x-request-id`에도 실립니다. `resource-dot-edicusbase.appspot.com`은 방식이 다릅니다. 파라미터 누락은 `400`, 인증 실패는 `401`, 그 밖의 모든 실패는 `500`이고, body에 `error` 객체가 없습니다. ## 응답 형식 응답의 `content-type`은 `application/json`입니다. contact: name: 모션원 url: https://edicus.io servers: - url: https://api.edicus.io description: Server API 호스트 security: - edicusApiKey: [] tags: - name: Auth description: 토큰 발급 - name: Projects description: 프로젝트 조회, 삭제, 복제 - name: Orders description: 잠정 주문, 확정 주문, 취소 - name: Fonts description: 폰트 그룹과 폰트 목록 - name: Products description: 상품과 상품 카테고리 정보 - name: Templates description: 리소스 토큰과 템플릿 패키지 등록 - name: Resources description: 리소스 검색과 사용자 이미지 paths: /v2/projects/{project_id}/preview_urls: get: tags: - Projects summary: 프리뷰 썸네일 URL 목록 description: >- 프로젝트의 프리뷰용 썸네일 이미지 URL 목록을 반환합니다. 각 항목은 jpg 파일 링크입니다. URL 개수는 상품마다 다릅니다. 상품별 썸네일 지원 여부는 Edicus Manager의 **Product → 개별상품 → etc → thumbnail**에서 `all-page`, `front-page`, `none` 중 선택한 값을 따릅니다. 2018년 1월 2일 이후 새로 만들어졌거나 저장된 상품만 지원합니다. 프리뷰가 없거나 프로젝트가 없으면 404가 아니라 200이고 `urls`가 빈 배열입니다. `edicus-uid`가 필요 없습니다. operationId: getPreviewUrls parameters: - name: project_id in: path required: true description: 프로젝트 id schema: type: string minLength: 1 example: '-LiBngTbCFYNjcOVcxcY' - name: oem-partner-code in: header required: false description: >- OEM 대행용입니다. 다른 파트너를 대신해 처리할 때 그 파트너의 코드를 넣습니다. 두 파트너 사이에 OEM 관계가 등록돼 있어야 하고, 아니면 `403 oem_not_allowed`입니다. 일반 연동에서는 보내지 않습니다. schema: type: string minLength: 1 responses: '200': description: URL 목록입니다. content: application/json: schema: $ref: '#/components/schemas/ProjectPreviewUrlsResult' example: urls: - https://.../1.jpg - https://.../2.jpg '401': description: >- 인증 실패입니다. `error.code`는 `no_credentials`(자격 증명 헤더가 없음) 또는 `invalid_api_key`(API 키가 틀림)입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' examples: invalid_api_key: summary: invalid_api_key value: error: code: invalid_api_key message: edicus-api-key 값을 확인하세요 request_id: 4bf92f3577b34da6a3ce929d0e0e4736 no_credentials: summary: no_credentials value: error: code: no_credentials message: edicus-api-key 또는 edicus-id-token이 필요합니다 request_id: 4bf92f3577b34da6a3ce929d0e0e4736 '403': description: >- `oem-partner-code`의 파트너를 대행할 권한이 없습니다. `error.code`는 `oem_not_allowed`입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: error: code: oem_not_allowed message: other-partner를 대행할 권한이 없습니다 request_id: 4bf92f3577b34da6a3ce929d0e0e4736 components: schemas: ProjectPreviewUrlsResult: type: object properties: urls: type: array items: type: string format: uri description: 썸네일 URL 목록. 없으면 빈 배열입니다 required: - urls ErrorBody: type: object description: '`api.edicus.io`의 모든 4xx와 5xx 응답 body입니다. 클라이언트는 `error.code`로 분기합니다.' properties: error: type: object properties: code: type: string description: snake_case 오류 코드. 이 값으로 분기합니다 example: project_not_found message: type: string description: 사람이 읽는 설명입니다. 파싱하지 않습니다 details: type: object additionalProperties: true description: 선택. 검증 실패면 `issues`에 어긋난 항목 목록이, 상태 충돌이면 현재 상태가 들어 있습니다 request_id: type: string description: 요청 id입니다. 응답 헤더 `x-request-id`와 같은 값이고, 문의할 때 함께 알려 줍니다 required: - code - message - request_id required: - error example: error: code: project_not_found message: 프로젝트가 없습니다 request_id: 4bf92f3577b34da6a3ce929d0e0e4736 securitySchemes: edicusApiKey: type: apiKey in: header name: edicus-api-key description: 모션원에서 발급받는 API 키입니다. 외부에 유출되지 않도록 각별히 주의합니다. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.