API 레퍼런스
최종 수정: 2026년 7월 3일
이 레퍼런스는 WEEGLOO를 코드에서 직접 다루는 개발자를 위한 HTTP API 명세입니다. 각 리소스 페이지의 엔드포인트 블록은 경로·헤더·본문을 직접 채워 실제로 호출해 볼 수 있는 콘솔로 렌더링됩니다. 요청이 어떻게 생겼고 응답이 어떤 모양으로 돌아오는지 그 자리에서 확인할 수 있습니다.
AI 에이전트는 이 HTTP API를 직접 호출하지 않고 WEEGLOO MCP 도구를 씁니다. 아래 명세는 프런트엔드·백엔드·스크립트 같은 애플리케이션 코드에서 API를 직접 호출할 때를 위한 것입니다.
API와 Base URL
WEEGLOO는 용도에 따라 나뉜 여러 API를 제공합니다. 호출할 API에 맞는 Base URL을 골라 씁니다. 호스트를 추측하거나 변형하지 않습니다.
| API | 용도 | Base URL |
|---|---|---|
| CMA | 콘텐츠 관리(Weegloo User가 생성·수정·삭제) | https://cma.weegloo.com |
| CDA | 발행 콘텐츠 전달(읽기 전용, 캐시 기반) | https://cda.weegloo.com |
| Upload | 파일 업로드 | https://upload.weegloo.com |
| ACMA | 앱 회원(ServiceUser) 콘텐츠 관리 | https://acma.weegloo.com |
| ACDA | 앱 회원(ServiceUser) 전달(읽기 전용) | https://acda.weegloo.com |
| Auth | ServiceUser OAuth 로그인·토큰 | https://auth.weegloo.com |
경로는 /v1/...을 기준으로 합니다. 예를 들어 Space 안의 Content 목록은 https://cma.weegloo.com/v1/spaces/{spaceId}/contents입니다.
신원과 토큰
WEEGLOO에는 서로 완전히 분리된 두 신원 체계가 있습니다. 어떤 신원이 발급한 토큰인지에 따라 호출할 수 있는 API가 정해집니다.
Weegloo User는 WEEGLOO 플랫폼 계정입니다. 소셜 로그인 등으로 처음 로그인하면 그 자리에서 계정이 만들어집니다(첫 로그인이 곧 가입). 다만 특정 Space의 콘텐츠를 다루려면 그 Space의 멤버여야 하고, 멤버십은 이미 속한 사람의 초대와 SpaceRole 부여로 정해집니다. 즉 계정 자체는 자유롭게 만들지만, 어느 Space에 들어가 무엇을 할 수 있는지는 멤버십과 역할로 통제됩니다. 이 신원의 Bearer 토큰(서버·CI용 PersonalAccessToken 또는 콘텐츠 스튜디오 로그인으로 받은 토큰)은 CMA·Upload·CDA를 인증합니다. 브라우저에 노출하는 공개 전달에는 토큰 대신 권한을 최소로 좁힌 DeliveryAccessToken(CDA)을 씁니다.
ServiceUser는 제품에 가입한 end-user입니다(ServiceLogin을 통해 가입). 가입을 누구에게 열지, 신규 가입에 관리자 승인을 둘지는 ServiceLogin 설정으로 정합니다. 이 신원의 Bearer 토큰(auth.weegloo.com에서 발급)은 ACMA·ACDA와 Upload를 인증합니다. CMA·CDA에는 쓸 수 없습니다.
토큰은 신원 경계를 넘지 않습니다. ServiceUser 토큰을 CMA·CDA에 보내면 안 되고, Weegloo User 토큰은 ACMA·ACDA의 유효한 호출자가 아닙니다. 두 신원이 공유하는 표면은 Upload 하나뿐이며, 업로드 뒤 Media를 만드는 곳은 신원에 따라 CMA(Weegloo User) 또는 ACMA(ServiceUser)로 갈립니다.
공통 규약
아래 네 가지는 특정 리소스에 한정되지 않고 모든 호출에 공통으로 적용됩니다. 개별 리소스 페이지는 이 규약을 따른다고 전제하고 고유 내용만 다룹니다.
- 시스템 속성 (sys): 모든 리소스의
sys메타데이터 구조(id·version·Refer·발행 상태). - 공통 쿼리 파라미터: 목록 조회(
limit·order·filter)와 커서 기반 페이지네이션. - 규약: 응답 미디어 타입·부분 수정(JSON Patch)·동시성 제어(
X-Weegloo-Version). - 에러: 오류 응답 형식과 공통 코드.
리소스 레퍼런스
API별 리소스 명세는 아래 허브에서 다룹니다.