데이터 모델
Open API가 다루는 리소스예요. 모두 스페이스에 속해요.
Organization ── Space ─┬─ ContentType ── ContentEntry
├─ ContentAsset
├─ Inquiry (인바운드)
└─ Outbound (아웃바운드)Space (스페이스)
데이터의 격리 단위예요. 조직(Organization)에 속해요. API 키는 스페이스 하나에 묶여 발급되므로, 요청에서 스페이스를 따로 지정하지 않아요.
ContentType (콘텐츠 타입)
콘텐츠의 구조(스키마)를 정의해요. 콘솔의 콘텐츠 종류가 이것이에요.
| 속성 | 설명 |
|---|---|
name | 표시 이름 |
api_id | API 경로에 쓰는 식별자(슬러그). ^[a-zA-Z0-9_]+$, 스페이스 안에서 유일 |
fields | 필드 정의 배열 — { id, name, type, required, is_title } |
필드 타입은 text, rich text, media 등을 지원해요. 필드의 id가 API 응답 values의 키로 그대로 쓰여요.
ContentEntry (엔트리)
콘텐츠 타입의 구조를 따르는 실제 콘텐츠예요. 콘텐츠 조회로 가져와요.
| 속성 | 설명 |
|---|---|
values | field_id → 값 맵. rich text는 문서(JSON), media는 에셋 id |
status | draft · scheduled · published · changed · archived — 발행된 것만 API로 나가요 |
published_at | 발행 시각 |
ContentAsset (미디어)
이미지 등 미디어 파일이에요. url, filename, alt, width, height, size를 가지며 엔트리의 media 필드에서 id로 참조돼요. 미디어 조회로 url을 가져와요.
Inquiry (문의 · 인바운드)
고객이 먼저 연락해 온 건이에요. 인바운드 등록으로 만들면 통합문의함에 website 채널의 신규(new) 문의로 들어가요. 이메일·전화가 같은 연락처가 있으면 그 연락처에, 회사명이 같은 거래처가 있으면 그 거래처에 묶여요.
Outbound (아웃바운드)
우리가 먼저 컨택하는 건이에요. 아웃바운드 등록으로 만들면 아웃바운드 목록에 첫 상태(기본 미접촉)·미배정으로 들어가요. 상태는 스페이스마다 콘솔에서 편집할 수 있고, 반응이 오면 콘솔에서 영업 기회나 딜로 전환해요.