개체 수정
/crm-core/v1/entities/{entityId}개체의 속성(이름·슬러그·설명·소속 속성 ID 목록·접근 권한·소유자)을 부분 업데이트합니다. 전달된 필드만 갱신되며 나머지는 유지됩니다. 기본 MEMBER 이상 권한이 필요하며 일부 필드는 추가 권한을 요구합니다.
다음 필드는 **CRM OWNER 전용**: - `recordAccess` 변경 - `ownerId` 변경 (새 ownerId 는 유효한 CRM 멤버여야 함)
Path Params
Body Params
Response
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/entities/${entityId}, {
method: 'PATCH',
headers: { 'Authorization': authHeader, 'Content-Type': 'application/json' },
body: JSON.stringify({ description: 'B2B/B2C 통합 고객 개체' })
});
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.patch(f'https://api.solapi.com/crm-core/v1/entities/{entity_id}', headers={
'Authorization': auth_header,
'Content-Type': 'application/json'
}, json={'description': 'B2B/B2C 통합 고객 개체'})
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 PATCH 'https://api.solapi.com/crm-core/v1/entities/CRMET1260423081530123XYZ11122233' \
-H "Authorization: ${AUTH}" \
-H "Content-Type: application/json" \
-d '{"description":"B2B/B2C 통합 고객 개체"}'
`slug` 변경 시 계정 내 다른 개체와 충돌하면 `409 DuplicateEntity` 가 반환됩니다. `propertyIds` 배열 순서는 테이블 뷰의 컬럼 순서로 반영됩니다.
**401 응답**: `{ "errorCode": "Unauthorized", "errorMessage": "권한이 없습니다." }`