고객용 조회 API 계약

공개 데모와 고객용 API를 구분합니다

이 페이지는 승인형 Private Preview의 고객용 OpenAPI 계약을 설명합니다. 가상 회사 기반 금융 참조 응답과 국내 클라우드 리전의 로컬 인프라 후보도 검토할 수 있습니다. 고객용 운영 API 주소, 즉시 발급 자격증명과 배치 완료된 고객 Sandbox는 제공하지 않습니다. 별도의 공개 데모에서는 금융 자료 검토와 산업 공급망의 버전 고정 합성 자료로 GET API를 호출할 수 있습니다.

조직, 사용자, 처리 목적, 기능 범위와 대상 데이터 범위를 요청마다 제한하고 감사 가능하게 남기는 것은 실제 고객 환경이 충족해야 할 통제 조건입니다. 클라우드 기준선은 기명 사용자의 ID 그룹을 기능 권한과 대상 데이터 권한으로 분리하고, 배포 코드를 저장소의 특정 객체 버전에 결박합니다. 공개 문서 자체가 그 운영 통제의 배치 완료를 증명하지는 않습니다.

• READ_ONLY CONTRACT — 공개 계약에는 조회 경로만 정의
• APPROVAL GATED — 실제 접근은 계약과 별도 환경 준비 이후에만 가능
• PURPOSE BOUND — 모든 실제 요청은 승인된 처리 목적에 결박되어야 함
• CANDIDATE ONLY — 사실 확정·추천·승인·명령·실행 권한 없음

조회할 수 있는 다섯 가지 정보

• 대상과 근거가 결박된 관계 후보
• 출처와 시간이 결박된 관측
• 이전 관측과 현재 관측 사이의 변화
• 원문으로 돌아갈 수 있는 근거 좌표
• 확정할 수 없거나 접근 범위 밖에 있는 정보 공백

Preview 계약의 버전과 변경 원칙을 공개합니다

현재 문서 계약 버전은 `2026-08-27.preview`, 경로 세대는 `/v1`입니다. Preview 단계에서는 검토 결과에 따라 필드와 오류 의미가 달라질 수 있으므로 운영 호환성을 약속하지 않습니다.

선택 필드 추가처럼 기존 소비자를 깨뜨리지 않는 변경은 같은 경로 세대에 반영할 수 있습니다. 필수 필드, 권한 의미, 리소스 식별 또는 기존 응답 해석을 깨뜨리는 변경은 새 경로 세대나 새 계약 버전으로 분리하고 변경 기록에 남깁니다.

• OpenAPI `info.version`으로 문서 계약을 식별
• Breaking change는 새 경로 세대 또는 명시적 계약 버전으로 분리
• Preview 종료·운영 지원 기간·이전 정책은 실제 고객 계약에서 별도 확정
• 체결된 주문서와 데이터·보안 부속서가 공개 문서보다 우선

운영 환경이 승인되면 인증과 처리 목적을 함께 보냅니다

아래 요청은 계약 형식을 보여주는 비실행 예제입니다. 실제 환경이 준비되는 경우에만 환경 주소와 자격증명을 승인된 조직 관리자에게 별도 보안 채널로 전달합니다. 문서의 주소 패턴이나 예제 토큰은 접근 권한이 아닙니다.

curl --fail-with-body \
  -H 'Authorization: Bearer $HARBINGER_PREVIEW_TOKEN' \
  -H 'Harbinger-Data-Purpose: <approved-purpose>' \
  'https://<issued-environment-host>/v1/subjects/<approved-subject-id>/changes'

curl --fail-with-body "${CALAMOPHYTON_DEVELOPER_DOCS_ORIGIN}/openapi.json"