조건 매칭 기반 관계 일괄 연결

지정한 매칭 기준(이름 또는 속성값)으로 소스 레코드와 상대 레코드를 자동 매칭하여 일괄 연결합니다. 동일한 이메일·전화번호 등을 키로 두 개체를 동기화할 때 사용합니다. MEMBER 이상 권한 + relationships.max 한도 적용.

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/relationships/bulk-match', {
  method: 'POST',
  headers: { 'Authorization': authHeader, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "sourceEntityId": "CRMET1260423081530123CUS11122233",
    "relationshipTypeId": "CRMRT1260423091530123RTP11122233",
    "criteria": [
      {
        "myField": {
          "type": "property",
          "propertyId": "CRMPP1260423081530123MAIL1234567"
        },
        "counterField": {
          "type": "property",
          "propertyId": "CRMPP1260423081530124MAIL1234567"
        }
      }
    ],
    "matchMode": "FIRST",
    "sourceFilter": {
      "segmentId": "CRMSG1260423081530123SGM11122233"
    }
  })
});
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/relationships/bulk-match', headers={
    'Authorization': auth_header,
    'Content-Type': 'application/json'
}, json={
    "sourceEntityId": "CRMET1260423081530123CUS11122233",
    "relationshipTypeId": "CRMRT1260423091530123RTP11122233",
    "criteria": [
        {
            "myField": {
                "type": "property",
                "propertyId": "CRMPP1260423081530123MAIL1234567"
            },
            "counterField": {
                "type": "property",
                "propertyId": "CRMPP1260423081530124MAIL1234567"
            }
        }
    ],
    "matchMode": "FIRST",
    "sourceFilter": {
        "segmentId": "CRMSG1260423081530123SGM11122233"
    }
})
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/relationships/bulk-match' \
  -H "Authorization: ${AUTH}" \
  -H "Content-Type: application/json" \
  -d '{"sourceEntityId": "CRMET1260423081530123CUS11122233", "relationshipTypeId": "CRMRT1260423091530123RTP11122233", "criteria": [{"myField": {"type": "property", "propertyId": "CRMPP1260423081530123MAIL1234567"}, "counterField": {"type": "property", "propertyId": "CRMPP1260423081530124MAIL1234567"}}], "matchMode": "FIRST", "sourceFilter": {"segmentId": "CRMSG1260423081530123SGM11122233"}}'