본문으로 건너뛰기

데이터 모델 ​

Open API가 다루는 리소스예요. 모두 스페이스에 속해요.

Organization ── Space ─┬─ ContentType ── ContentEntry
                       ├─ ContentAsset
                       ├─ Inquiry   (인바운드)
                       └─ Outbound  (아웃바운드)

Space (스페이스) ​

데이터의 격리 단위예요. 조직(Organization)에 속해요. API 키는 스페이스 하나에 묶여 발급되므로, 요청에서 스페이스를 따로 지정하지 않아요.

ContentType (콘텐츠 타입) ​

콘텐츠의 구조(스키마)를 정의해요. 콘솔의 콘텐츠 종류가 이것이에요.

속성설명
name표시 이름
api_idAPI 경로에 쓰는 식별자(슬러그). ^[a-zA-Z0-9_]+$, 스페이스 안에서 유일
fields필드 정의 배열 — { id, name, type, required, is_title }

필드 타입은 text, rich text, media 등을 지원해요. 필드의 id가 API 응답 values의 키로 그대로 쓰여요.

ContentEntry (엔트리) ​

콘텐츠 타입의 구조를 따르는 실제 콘텐츠예요. 콘텐츠 조회로 가져와요.

속성설명
valuesfield_id → 값 맵. rich text는 문서(JSON), media는 에셋 id
statusdraft · scheduled · published · changed · archived — 발행된 것만 API로 나가요
published_at발행 시각

ContentAsset (미디어) ​

이미지 등 미디어 파일이에요. url, filename, alt, width, height, size를 가지며 엔트리의 media 필드에서 id로 참조돼요. 미디어 조회로 url을 가져와요.

Inquiry (문의 · 인바운드) ​

고객이 먼저 연락해 온 건이에요. 인바운드 등록으로 만들면 통합문의함에 website 채널의 신규(new) 문의로 들어가요. 이메일·전화가 같은 연락처가 있으면 그 연락처에, 회사명이 같은 거래처가 있으면 그 거래처에 묶여요.

Outbound (아웃바운드) ​

우리가 먼저 컨택하는 건이에요. 아웃바운드 등록으로 만들면 아웃바운드 목록에 첫 상태(기본 미접촉)·미배정으로 들어가요. 상태는 스페이스마다 콘솔에서 편집할 수 있고, 반응이 오면 콘솔에서 영업 기회나 딜로 전환해요.