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

인증

Authorization
string
header
필수

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

쿼리 매개변수

q
string

이름에 이 텍스트가 포함된 태그만 반환합니다(대소문자 무시, 최대 100자). 일반 텍스트로 비교하므로 %, _는 와일드카드가 아닙니다. NUL 문자(%00)가 포함되면 VALIDATION_ERROR로 거부됩니다.

Maximum string length: 100
limit
integer
기본값:20

페이지당 태그 수. 100을 넘는 값은 100으로 처리됩니다.

필수 범위: x >= 1
cursor
string

이전 페이지의 nextCursor 값.

Maximum string length: 512

응답

태그 한 페이지.

data
object[]
필수

이 페이지의 태그 또는 그룹 목록이며, 각각 연락처 수를 포함합니다.

nextCursor
string | null
필수

다음 페이지를 가져오려면 cursor로 전달하세요. 마지막 페이지에서는 null입니다.