개발자 문서 개요

Edicus는 POD(주문 제작) 상품 편집기를 외부 서비스에 임베드할 수 있도록 두 가지 인터페이스를 제공합니다.

Edicus JS SDK — 브라우저에서 편집기(iframe)를 띄우고 제어하는 자바스크립트 라이브러리
Edicus Server API — 고객사 서버에서 토큰 발급·프로젝트·주문·리소스를 다루는 REST API

빠른 시작 5분 만에 편집기 띄우기

JS SDK 레퍼런스 init · create_project · post_to_editor

Server API 레퍼런스 인증 · 프로젝트 · 주문 · 리소스

VDP 가이드 가변 데이터 인쇄 연동

3-tier 아키텍처

Edicus 연동은 브라우저 ↔ 고객사 서버 ↔ Edicus 서버의 3계층 구조로 동작합니다.

[브라우저]                [고객사 서버]              [Edicus 서버]
 edicus-sdk-v2.js   ──▶   edicus-api-key 보관  ──▶   api-dot-edicusbase.appspot.com
 (편집기 iframe)    ◀──   token(JWT) 중계      ◀──   token 발급 / 주문 / 리소스

핵심 원칙은 edicus-api-key는 절대 브라우저에 노출하지 않는다는 것입니다. 고객사 서버가 API Key로 Edicus 서버에서 사용자 토큰(JWT)을 발급받아 브라우저로 전달하고, 브라우저의 SDK는 그 토큰만으로 편집기를 인증합니다.

인증 모델

요소	설명
`edicus-api-key`	모션원으로부터 발급. 고객사 서버에서만 사용. 외부 유출 금지.
`edicus-uid`	고객사 사용자별 고유 id. 토큰 발급 시 즉시 생성됨(별도 생성 절차 없음).
`token` (JWT)	`edicus-uid` 기반으로 발급되는 JSON Web Token. 유효시간 1시간. 브라우저에서 편집기 인증에 사용.

edicus-uid 규칙

(partner-code 포함) 64 byte 이내의 hash 형태 id. 50 byte 이내 권장.
허용 문자: a-z, A-Z, 0-9, @, -, _, +, =
금지 문자: . # $ [ ] 그리고 특히 / \
고객사 사용자 계정과 1:1로 대응되는 변경 불가한 값이어야 합니다.

API 기본 주소

영역	Base URL
Server API / Font API	`https://api-dot-edicusbase.appspot.com`
Resource API	`https://resource-dot-edicusbase.appspot.com`

공통 응답 규약

모든 응답은 application/json.
논리적 오류는 HTTP 200으로 반환하며 본문에 err 객체를 포함합니다.
인증 오류 / 서버 내부 오류는 HTTP 4xx~5xx로 반환합니다.

{
    "err": {
        "code": "string",
        "message": "string",
        "info": {}
    }
}