레코드 내보내기 상태 조회
/crm-core/v1/records/export/{jobId}/status비동기 내보내기 작업(POST /crm-core/v1/records/export/request 의 async 응답)의 진행 상태와 다운로드 URL을 조회합니다. 완료(completed) 상태일 때 downloadUrl에 서명 URL이 채워집니다.
Path 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/records/export/9f2c7e8d-3b1a-4d5e-8c4f-2b9a1e7f3d6c/status', {
method: 'GET',
headers: { 'Authorization': authHeader, 'Content-Type': 'application/json' }
});
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.get('https://api.solapi.com/crm-core/v1/records/export/9f2c7e8d-3b1a-4d5e-8c4f-2b9a1e7f3d6c/status', headers={
'Authorization': auth_header,
'Content-Type': 'application/json'
})
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 GET 'https://api.solapi.com/crm-core/v1/records/export/9f2c7e8d-3b1a-4d5e-8c4f-2b9a1e7f3d6c/status' \
-H "Authorization: ${AUTH}" \
-H "Content-Type: application/json"
상태 조회는 3~5초 간격의 폴링 또는 작업 요청 직후의 지연 호출 정도로 충분합니다. 상태 저장소는 성공 이후 24시간, 실패 이후 7일 보존됩니다.
알 수 없는 `jobId`를 전달하면 `{ "status": "failed", "error": "작업을 찾을 수 없습니다." }` 형태로 응답합니다.
**401 응답**: `{ "errorCode": "Unauthorized", "errorMessage": "권한이 없습니다." }`