API

추적 키 목록 조회

작성일 2026.03.24 | 수정일 2026.04.14

GET/crm-core/v1/tracking-keys

추적 키 목록을 조회합니다. MEMBER 이상 권한이 필요합니다.

추적 키 원본(rawKey)은 목록 조회에 포함되지 않습니다. 키 접두사(keyPrefix)만 표시됩니다.

Response| Name | Type | Required | Description |

| ------ | ------ | ------ | ------ | | trackingKeyId | string | | 추적 키 고유 ID | | accountId | string | | 계정 고유 ID | | name | string | | 추적 키 이름 | | keyPrefix | string | | 키 접두사 | | allowedDomains | Array\ | | 허용 도메인 목록 | | defaultEntityId | string | | 기본 개체 ID | | permissions | Object | | 권한 설정 | | permissions.createRecords | boolean | | 레코드 생성 허용 여부 | | permissions.trackEvents | boolean | | 이벤트 추적 허용 여부 | | isActive | boolean | | 활성 상태 | | lastUsedAt | date | | 마지막 사용 일시 | | dateCreated | date | | 최초 생성 날짜 | | dateUpdated | date | | 최근 수정 날짜 |

Structure

json Response Structure
[
  {
    "trackingKeyId": "TK20260324090000ABCDEFGHIJKLMNOP",
    "accountId": "24010100001234",
    "name": "샘플",
    "keyPrefix": "샘플값",
    "allowedDomains": ["샘플값"],
    "defaultEntityId": "ID_SAMPLE_12345",
    "permissions": {
      "createRecords": true,
      "trackEvents": true
    },
    "isActive": true,
    "lastUsedAt": "2026-03-24T09:00:00.000Z",
    "dateCreated": "2026-03-24T09:00:00.000Z",
    "dateUpdated": "2026-03-24T09:00:00.000Z"
  }
]