첫 번째 API 호출

먼저 Quickstart의 wallet_request 준비를 따라 도구와 Base URL·API Key·HMAC Key 환경 변수, 셸 함수를 설정합니다. 아래 요청은 같은 셸에서 실행합니다.

먼저 인증이 필요 없는 서버 시각 API를 호출합니다.

curl -sS "$WALLET_BASE_URL/time" | jq

success: true인지 확인하고 호출 서버와 시각을 비교합니다. 다음으로 준비한 wallet_request 함수 또는 직접 구현한 HMAC 클라이언트로 보호 API를 호출합니다.

wallet_request GET '/networks?is_active=true&page=1&page_size=20' | jq

성공 응답은 공통 envelope를 사용합니다.

{
  "success": true,
  "data": { "items": [], "page": 1, "page_size": 20, "total": 0 },
  "error": null
}

HTTP 상태와 본문의 success를 모두 확인합니다. 실패 시 자격 증명을 로그에 남기지 않고 error.request_id, error.code, error.action을 기록합니다.

고객 리소스를 만들기 전에 자산 유형과 지원 네트워크를 조회하십시오.

반환 계약 검증

data.items가 배열인지, 숫자 ID를 정밀도 손실 없이 저장할 수 있는지, 활성 상태 boolean이 유지되는지, UTC timestamp를 의도치 않은 로컬 시간으로 바꾸지 않는지 확인합니다.

폐기 가능한 환경에서는 오래된 timestamp를 사용한 실패 테스트를 한 번 실행할 수 있습니다. HTTP 401, INVALID_TIMESTAMP, 시각 동기화를 지시하는 action이 반환되어야 합니다. 조율 없이 운영 환경에서 부정 인증 테스트를 실행하지 않습니다.

안전한 요청 metadata와 upstream request_id를 진단용으로 남기고, ID 또는 금액 문자열을 부정확한 JavaScript number로 변환하지 않으면 첫 호출 연동이 완료된 것입니다.