연동 환경과 Base URL

OOLIN은 HTTPS JSON API를 제공합니다. BPMG가 온보딩 환경별 Base URL을 전달하며 URL 끝에는 /를 붙이지 않습니다.

https://{environment-api-host}

개발·테스트·운영 설정을 분리하십시오. 계정 ID, 자산 ID, 네트워크 ID, 주소, 잔액과 API 자격 증명은 환경별 데이터이며 공통 식별자로 복사해서 사용하면 안 됩니다.

API 환경과 블록체인 네트워크

개발·테스트·운영 API 환경과 블록체인의 메인넷·테스트넷은 별개의 구분입니다. Base URL만으로 사용할 체인을 판단하지 않고 온보딩에서 확인한 네트워크와 자산을 선택합니다.

지원 네트워크에서 메인넷·테스트넷 목록과 고객사 요청에 따른 확장 안내를 확인합니다. 이 문서의 튜토리얼은 Ethereum Sepolia 테스트넷을 사용합니다.

공통 규칙

• 문자 인코딩: UTF-8
• 날짜와 시각: UTC ISO 8601
• 금액: 소수 문자열, *_raw는 자산 최소 단위의 정수 문자열
• 응답 형식: { success, data, error }

GET /health로 프로세스 연결을 확인하고 GET /time으로 서버 시각을 비교합니다. Health 응답은 모든 DB·블록체인 의존성의 정상 상태를 보장하지 않으므로 readiness 확인에는 인증이 필요한 업무 API도 포함합니다.

export WALLET_BASE_URL='https://{environment-api-host}'

URL은 코드가 아닌 환경 설정으로 관리하고 TLS 검증과 명시적인 연결·응답 timeout을 적용합니다.

환경 준비 체크리스트

환경마다 Base URL, 자격 증명 식별자, 지원 네트워크, 활성 자산, 운영 연락처를 기록합니다. 체크리스트에는 비밀 값 자체를 저장하지 않습니다.

변경 요청을 실행하기 전에 다음을 확인합니다.

• 실제 애플리케이션 네트워크에서 DNS와 TLS 검증이 성공합니다.
• /time과 호출 서버 시각의 차이가 인증 허용 범위 이내입니다.
• 의도한 자격 증명으로 서명한 기준정보 요청이 성공합니다.
• 사용할 네트워크, 자산 유형, 실제 Asset 조합이 활성 상태입니다.
• DB가 64-bit 숫자 ID를 손실 없이 저장합니다.
• UTC timestamp와 decimal/raw 금액 문자열이 직렬화 과정에서 바뀌지 않습니다.

HTTP 503은 범위가 있는 이용 불가 신호로 처리합니다. 프로세스 health가 정상이어도 특정 네트워크나 자산은 사용할 수 없을 수 있습니다.