메인 콘텐츠로 건너뛰기
GET
curl

인증

Authorization
string
header
필수

Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를 가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한 번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된 키는 바로 다음 요청부터 인증에 실패합니다.

경로 매개변수

id
string<uuid>
필수

그룹 id. GET /api/preview/segments나 POST /api/preview/segments의 응답에서 얻습니다.

응답

그룹.

규칙과 실시간 멤버 수를 가진 그룹. 멤버 정보는 절대 반환하지 않습니다.

id
string<uuid>
필수

그룹 id.

name
string
필수

그룹 이름.

filter
object
필수

저장된 규칙을 저장된 그대로 나타내며, GET /api/preview/segments/{id}가 반환하는 값입니다. 보낼 수 있는 규칙인 GroupFilter와 달리 목록 길이에 제한이 없고, 조건은 모든 타입일 수 있습니다(StoredGroupCondition). 저장된 그룹은 API의 규칙을 따르지 않기 때문입니다. 규칙 없이 저장된 그룹은 {}로 반환됩니다.

memberCount
integer
필수

지금 그룹에 속한 연락처의 실시간 수(수신 거부 연락처 제외). 수치만 제공하며 연락처 자체는 반환하지 않습니다.

필수 범위: x >= 0
createdAt
string<date-time>
필수

그룹을 만든 시각. UTC 기준 RFC 3339.