API

세그먼트 평가

작성일 2026.03.24 | 수정일 2026.04.29

POST/crm-core/v1/segments/{segmentId}/evaluate

지정한 레코드가 세그먼트 조건에 매칭되는지(현재 멤버인지) 실시간으로 평가합니다. 캐시 사용 없이 항상 최신 조건으로 즉시 검증합니다.

lightbulb

**단건 record 의 isMember 평가**입니다. segment 의 캐시(`cachedCount/lastRefreshedAt`)는 갱신되지 않습니다. 캐시 갱신은 별도 refresh endpoint 사용.

lightbulb

존재하지 않거나 삭제된 recordId 입력 시 **404 Not Found** 응답 (백엔드 적용 후).

Path Params

NameTypeRequiredDescription
segmentIdstring*세그먼트 ID (CRMSG1…)

Body Params

NameTypeRequiredDescription
recordIdstring*세그먼트 조건 평가 대상 레코드 ID (CRMRC1…)

Response

NameTypeRequiredDescription
isMemberboolean*해당 레코드가 세그먼트 조건을 만족하는지 여부

Structure

코드 예제

const crypto = require('crypto');

const apiKey = 'NCSXXXXXXXXXXXXX';
const apiSecret = 'YOUR_API_SECRET';
const dateTime = new Date().toISOString();
const salt = crypto.randomBytes(16).toString('hex');
const signature = crypto.createHmac('sha256', apiSecret).update(dateTime + salt).digest('hex');
const authHeader = HMAC-SHA256 apiKey=${apiKey}, date=${dateTime}, salt=${salt}, signature=${signature};

const response = await fetch('https://api.solapi.com/crm-core/v1/segments/CRMSG1260423081530123SGM11122233/evaluate', {
method: 'POST',
headers: { 'Authorization': authHeader, 'Content-Type': 'application/json' },
body: JSON.stringify({ recordId: 'CRMRC1260423081530123REC11122233' })
});
const data = await response.json();

import hmac, hashlib, secrets, requests
from datetime import datetime, timezone

api_key = 'NCSXXXXXXXXXXXXX'
api_secret = 'YOUR_API_SECRET'
date_time = datetime.now(timezone.utc).strftime('%Y-%m-%dT%H:%M:%SZ')
salt = secrets.token_hex(16)
signature = hmac.new(api_secret.encode(), (date_time + salt).encode(), hashlib.sha256).hexdigest()
auth_header = f'HMAC-SHA256 apiKey={api_key}, date={date_time}, salt={salt}, signature={signature}'

response = requests.post('https://api.solapi.com/crm-core/v1/segments/CRMSG1260423081530123SGM11122233/evaluate', headers={
'Authorization': auth_header,
'Content-Type': 'application/json'
}, json={'recordId': 'CRMRC1260423081530123REC11122233'})
data = response.json()

API_KEY="NCSXXXXXXXXXXXXX"
API_SECRET="YOUR_API_SECRET"
DATE=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
SALT=$(openssl rand -hex 16)
SIGNATURE=$(echo -n "${DATE}${SALT}" | openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $NF}')
AUTH="HMAC-SHA256 apiKey=${API_KEY}, date=${DATE}, salt=${SALT}, signature=${SIGNATURE}"

curl -X POST 'https://api.solapi.com/crm-core/v1/segments/CRMSG1260423081530123SGM11122233/evaluate' \
-H "Authorization: ${AUTH}" \
-H "Content-Type: application/json" \
-d '{"recordId":"CRMRC1260423081530123REC11122233"}'

lightbulb

**401 응답**: `{ "errorCode": "Unauthorized", "errorMessage": "권한이 없습니다." }`