Server API 개요 · 인증

Edicus Server API는 토큰 발급, 프로젝트·주문 관리, 리소스 조회를 제공하는 REST API입니다.

Base URL: https://api-dot-edicusbase.appspot.com
모든 응답은 application/json.

공통 헤더

이름	타입	설명
`edicus-api-key` *	`string`	모션원으로부터 발급. 서버에서만 사용.
`edicus-uid`	`string`	고객사 사용자별 고유 id(엔드포인트에 따라 필요)

오류 응답

논리적 오류: HTTP 200 + 본문에 err 객체.
인증/서버 오류: HTTP 4xx~5xx.

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

토큰 발급

사용자 토큰 (uid 기반)

POST /api/auth/token

브라우저에서 SDK로 편집기를 띄울 때 사용할 JWT를 발급합니다. 유효기간 1시간.

edicus-uid는 별도 생성 절차 없이 토큰 요청 시 즉시 생성됩니다. 고객사 user 계정과 1:1 대응되는 값을 사용하세요.

헤더	타입	설명
`edicus-api-key` *	`string`
`edicus-uid` *	`string`

curl -X POST https://api-dot-edicusbase.appspot.com/api/auth/token \
  -H "edicus-api-key: YOUR_API_KEY" \
  -H "edicus-uid: kr46KCD8vWOnOGo8CBO7c6ctSge2"

{ "token": "<JWT>" }

Staff 토큰 (email/password)

POST /api/auth/staff/token

Edicus Manager에 등록된 사용자의 email·password로 로그인해 토큰을 발급합니다. 이 계정으로 로그인하면 편집기에서 리소스 업데이트(템플릿 수정) 가 가능합니다. 토큰에 role이 포함됩니다.

헤더	타입	설명
`edicus-api-key` *	`string`
`edicus-email` *	`string`
`edicus-pwd` *	`string`

{ "token": "<JWT>" }

사용자 토큰 (내부용)

GET /api/auth/user/token

Edicus Manager(edicus-man) 내부에서 편집기를 띄울 때 사용합니다. 헤더로 edicus-uid와 admin/staff 이상 권한의 edicus-id-token을 받습니다.