관계 유형 목록 조회
작성일 2026.04.23 | 수정일 2026.04.23
GET/crm-core/v1/relationships/types
계정에 정의된 관계 유형 목록을 조회한다. 개체 ID를 지정하면 해당 개체가 소스 또는 대상으로 포함된 관계 유형만 반환한다. 최대 200건. 권한 요구: MEMBER 이상.
Query Params
| Name | Type | Required | Description |
|---|---|---|---|
| entityId | string | 개체 ID로 필터링 (소스 또는 대상 어느 쪽이든 일치) |
Response
| Name | Type | Required | Description |
|---|---|---|---|
| [] | Array | 관계 유형 배열 (최상위) | |
| [].relationshipTypeId | string | 관계 유형 ID | |
| [].name | string | 관계 유형 이름 | |
| [].description | string | 설명 | |
| [].sourceEntityId | string | 소스 개체 ID | |
| [].targetEntityId | string | 대상 개체 ID | |
| [].sourceLabel | string | 소스 방향 레이블 | |
| [].targetLabel | string | 대상 방향 레이블 | |
| [].dateCreated | date | 생성 시각 | |
| [].dateUpdated | date | * | 마지막 수정 시각 |
Structure
코드 예제
const params = new URLSearchParams({ entityId: 'CRMET1260423081530123XYZ11122233' });
const response = await fetch(https://api.solapi.com/crm-core/v1/relationships/types?${params}, {
headers: { 'Authorization': 'Bearer ' + TOKEN }
});
const data = await response.json();
import requests
response = requests.get(
'https://api.solapi.com/crm-core/v1/relationships/types',
headers={'Authorization': f'Bearer {TOKEN}'},
params={'entityId': 'CRMET1260423081530123XYZ11122233'}
)
data = response.json()
curl -G 'https://api.solapi.com/crm-core/v1/relationships/types' \
-H 'Authorization: Bearer YOUR_TOKEN' \
--data-urlencode 'entityId=CRMET1260423081530123XYZ11122233'
lightbulb
`entityId`를 비워 두면 계정 내 모든 관계 유형이 반환된다. 최대 200건까지만 반환되므로 대량 관리가 필요한 경우 프론트엔드에서 이름 기반 검색을 함께 제공하는 것을 권장한다.