개발자를 위한 UniSat API 키를 얻는 방법은 무엇입니까? (개발자 도구)

UniSat 개발자 포털에 액세스

1. UniSat 공식 웹사이트로 이동하여 기본 탐색 메뉴에서 "개발자" 또는 "API" 섹션을 찾으세요.

2. "개발자 도구" 또는 "API 문서"라고 표시된 링크를 클릭하면 https://dev.unisat.io 와 같은 전용 하위 도메인이나 경로로 리디렉션됩니다.

3. 포털은 계정 생성 및 키 생성을 위해 세션 기반 인증을 사용하므로 브라우저가 타사 쿠키를 차단하지 않는지 확인하세요.

4. UniSat 지갑 확장 프로그램이 아직 설치되어 있지 않은 경우 계속 진행하기 전에 Chrome 웹 스토어 또는 Firefox 추가 기능에서 다운로드하여 설정하세요.

5. UniSat 지갑을 사용하여 로그인하세요. 시스템은 이메일/비밀번호 자격 증명이 아닌 암호화 서명 문제를 통해 소유권을 확인합니다.

애플리케이션 등록

1. 인증이 완료되면 개발자 대시보드 내 '애플리케이션' 탭으로 이동하세요.

2. "+ 새 애플리케이션" 버튼을 클릭하여 등록을 시작합니다.

3. "Bitcoin NFT Explorer" 또는 "Ordinal Indexer Bot"과 같이 프로젝트를 설명하는 이름을 입력합니다.

4. 유효한 콜백 URL을 제공하세요. 이는 UniSat가 비문 확인과 같은 이벤트에 대해 웹훅 알림을 보낼 수 있는 HTTPS 엔드포인트여야 합니다.

5. 애플리케이션에 필요한 권한을 선택하십시오: 블록체인 데이터에 대한 읽기 전용 액세스, 비문 메타데이터 검색 또는 전체 지갑 상호 작용 기능.

API 키 생성 및 관리

1. 신청서를 제출한 후 UniSat는 고유한 클라이언트 ID를 생성하고 이를 일회용 모달 창에 비밀 API 키 와 함께 표시합니다.

2. 두 값을 즉시 복사합니다. 비밀 키는 첫 번째 보기 후에 마스킹되며 인터페이스에서 다시 검색할 수 없습니다.

3. 보안 환경 변수 또는 저장소에 비밀 키를 저장합니다. 이를 프런트엔드 코드나 공개 저장소에 노출하면 애플리케이션의 보안이 손상됩니다.

4. /v1/inscriptions 또는 /v1/transactions 와 같은 엔드포인트에 HTTP 요청을 할 때 클라이언트 ID를 X-Client-ID 헤더로 사용하고 비밀 키를 X-API-Key 헤더로 사용합니다.

5. 애플리케이션 설정에서 "키 취소" 옵션을 통해 손상된 키를 취소합니다. 취소는 모든 UniSat 인프라 노드에서 60초 이내에 적용됩니다.

속도 제한 및 사용 제약

1. 무료 계층 애플리케이션은 시간당 1,000개의 요청 으로 제한되며 버스트는 분당 100개의 요청으로 제한됩니다.

2. 각 API 키는 특정 애플리케이션 ID에 바인딩됩니다. 등록된 여러 앱에서 하나의 키를 사용하려고 하면 자동 조절이 트리거됩니다.

3. HTTP 상태 429를 반환하는 요청은 현재 속도 제한이 초과되었음을 나타냅니다. 응답에는 허용된 다음 호출까지의 시간(초)을 지정하는 Retry-After 헤더가 포함됩니다.

4. 500개 항목을 초과하는 비문 목록 가져오기와 같은 대량 작업에는 페이지 매김 매개변수( limit 및 offset )가 필요합니다. 이를 생략하면 응답이 잘립니다.

5. API에서 반환된 모든 타임스탬프는 UTC 시간대를 포함한 ISO 8601 형식을 따르며, 블록 높이 값은 확인된 Bitcoin 메인넷 블록만 반영합니다.

자주 묻는 질문

Q: 여러 도메인에서 동일한 UniSat API 키를 사용할 수 있습니까? A: 아니요. 각 도메인은 애플리케이션 설정 중에 명시적으로 등록되어야 합니다. 도메인 간 사용은 CORS 거부를 트리거하고 백엔드 서비스에 도달하기 전에 요청을 무효화합니다.

Q: UniSat은 다운타임 없이 API 키 순환을 지원합니까? 답: 그렇습니다. 이전 키가 활성 상태인 동안 새 키를 생성하고, 서비스 구성을 업데이트한 다음, 검증을 통해 안정적인 작동이 확인되면 이전 키를 취소하세요.

Q: 프로덕션 API를 통해 테스트넷 비문에 액세스할 수 있습니까? A: 아니요. 프로덕션 API는 메인넷 데이터만 제공합니다. 별도의 테스트넷 엔드포인트가 https://testnet-api.unisat.io 에 존재하며 자체 애플리케이션 등록 및 키가 필요합니다.

Q: 내 애플리케이션이 일일 할당량 임계값을 초과하면 어떻게 됩니까? A: HTTP 403 Forbidden으로 인해 요청이 실패하고 0을 표시하는 X-RateLimit-Remaining 헤더가 포함됩니다. 할당량은 사용 패턴에 관계없이 UTC 자정에 재설정됩니다.