Release notes

Veacon API 및 플랫폼의 변경 이력. Breaking change 는 major 버전 증가.

Last updated: 2026-04-23

Veacon 은 Semantic Versioning 을 따릅니다. Breaking change 는 major 버전 증가 (v1 → v2) 로만 도입되며, 최소 90일 deprecation 공지 후 적용됩니다.

Unreleased

2026-04-26 — Docs polish

  • Real Estate API reference 추가 — /real-estate/pulse + /real-estate/dimensions per ADR-014 hybrid data architecture. 응답 envelope (Layer 1-3) 전체 필드 + tier gate (Pro+ for dong precision) 명시.
  • Confidence Score 공식 페이지 추가 (/docs/data/cohort-confidence) — ADR-015 Layer 3 multi-source agreement 정량화. relative_spread × distinct_sources × sample_count 3-tier ladder 결정 가이드 포함.
  • Webhooks reference 추가 (/docs/api/webhooks) — outbound HMAC-SHA256 서명, 7가지 이벤트 타입, Node.js + Python 검증 예시. P10.
  • Sidebar 재구성 — API Reference 가 Real Estate (CRE) / Marketplace / Operations 3개 섹션으로 분리. Data Dictionary 에 Marketplace k-anonymity 와 CRE Layer 3 Confidence Score 가 별도 항목.

P2 진행 중 (2026-04-23)

  • Docs Portal 공개 (/docs/*) — 자체 호스팅 Next.js 기반
    • Quickstart, API Reference, Data Dictionary, SDK 가이드 4종 (curl/JS/Python/Excel)
    • OpenAPI 3.1 공개 다운로드

2026-04-23 — P1 Legal & Trust (Beta)

Added

  • 5개 법률 문서 공개 (Beta 1.0.0)
    • /terms — 이용약관 (B2B SaaS 표준 + k-anonymity 조항)
    • /privacy — 개인정보처리방침 (PIPA 준수)
    • /dpa — Data Processing Agreement (Enterprise preview)
    • /security — 보안 정책 (k-anonymity, 암호화, 취약점 공개)
    • /cookies — 쿠키 정책
  • /api/health — 공개 health check 엔드포인트 (DB + Redis 병렬)
  • Footer 업데이트 — 법인 정보 (사업자번호 515-87-03607, 대표 박진희, 주소, 통신판매업신고) + 5 legal 링크
  • OpenAPI 메타데이터 — contact.email, termsOfService, license.url 실작동

Changed

  • OpenAPI info.contact → hello@veacon.io (이전: sales@veacon.io, 미설정 주소)

2026-04-22 — P0 Security & Revenue Hardening

Added

  • API Key 해시 저장 (SHA-256) — 평문은 발급 직후 1회만 노출 (ADR-008 P0 Security & Revenue Hardening — full spec available on procurement request via hello@veacon.io)
  • 월 쿼터 집행 — 초과 시 HTTP 402 QUOTA_EXCEEDED + 응답 헤더 X-Quota-{Limit,Used,Resets-At}
  • Upstash Redis 기반 Rate Limit — Sliding window 60초, 전역 공유 state (Tokyo 리전)
  • JWT 검증 60초 캐시 — Syncle /auth/v1/user 왕복 ~150ms 제거
  • 응답 헤더 — X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After (429 시)

Fixed

  • CORS 취약점 수정 — *.vercel.app 와일드카드 제거, env-driven regex 로 대체. 공격자 preview 배포를 통한 credentials 탈취 벡터 차단.

Internal

  • intel.api_consumers 스키마 확장: api_key_hash, api_key_prefix, monthly_usage_current, current_period_start
  • 새 RPC: veacon_authenticate_api_key_v2, veacon_log_api_call_v2
  • v1 RPC 는 호환성 위해 유지 (2026-05 경 DROP 예정)

2026-04-21 — v1.0.0 Initial release

Added

  • GET /api/v1/markets/pulse — 시세·수요 집계 엔드포인트
  • GET /api/v1/markets/dimensions — 가능 조합 조회
  • X-API-Key 또는 Syncle SSO 쿠키 인증 (이중)
  • k-anonymity ≥ 3 강제 (DB CHECK constraint)
  • 대시보드 (/dashboard) — API Key 자동 발급
  • 5개 권역 (강남권, 도심권, 서남권, 서울기타, 충청권), 1개 카테고리 (office), 5개 월 데이터

Deprecation Policy

변경 종류통지 기간예시
필드 추가사전 공지 없이새 지표 컬럼
필드 타입 변경90일number → string
필드 제거90일 + Deprecation 헤더booking_conv_rate 제거
Endpoint 제거90일 + Sunset 헤더/markets/pulse → /markets/signals
Major 버전 증가180일 + major announcement/v1/* → /v2/*

이메일 구독: hello@veacon.io 으로 "Subscribe to changelog" 요청 시 breaking change 사전 알림 메일 수신.

RSS Feed

TBD — P7 (Content) 단계에서 /changelog/rss.xml 배포 예정.