관계 목록 조회

GET/crm-core/v1/relationships/list
관계 목록을 커서 기반으로 조회한다. 관계 유형 또는 개체로 필터링할 수 있으며, 응답에는 소스·대상 레코드의 이름이 함께 포함된다. 권한 요구: MEMBER 이상.

Query Params

Name	Type	Required	Description
relationshipTypeId	string		관계 유형 ID로 필터링
entityId	string		소스 또는 대상이 해당 개체에 속한 관계만 필터링
startKey	string		이전 응답의 nextKey를 넘겨 다음 페이지를 요청
limit	number		페이지당 최대 건수. 기본 50, 최대 100

Response

Name	Type	Required	Description
data	Array		관계 목록
data[].relationshipId	string		관계 ID
data[].sourceEntityId	string		소스 개체 ID
data[].sourceRecordId	string		소스 레코드 ID
data[].sourceRecordName	string		소스 레코드 이름 (없으면 레코드 ID로 대체)
data[].targetEntityId	string		대상 개체 ID
data[].targetRecordId	string		대상 레코드 ID
data[].targetRecordName	string		대상 레코드 이름
data[].relationshipTypeId	string		관계 유형 ID
data[].metadata	Object		관계 메타데이터
data[].dateCreated	date		생성 시각
nextKey	string		다음 페이지 커서. 마지막 페이지면 없음

Structure

코드 예제

const params = new URLSearchParams({
  relationshipTypeId: 'CRMRT1260423091530123RTP11122233',
  limit: '50'
});
const response = await fetch(https://api.solapi.com/crm-core/v1/relationships/list?${params}, {
  headers: { 'Authorization': 'Bearer ' + TOKEN }
});
const data = await response.json();

import requests
response = requests.get(
    'https://api.solapi.com/crm-core/v1/relationships/list',
    headers={'Authorization': f'Bearer {TOKEN}'},
    params={'relationshipTypeId': 'CRMRT1260423091530123RTP11122233', 'limit': 50}
)
data = response.json()

curl -G 'https://api.solapi.com/crm-core/v1/relationships/list' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --data-urlencode 'relationshipTypeId=CRMRT1260423091530123RTP11122233' \
  --data-urlencode 'limit=50'