gemini API 사용법을 알고 있나요?
- User
gemini API 사용법을 알고 있나요?
- Assistant
네, Gemini API 사용법에 대해 설명드리겠습니다. Gemini는 암호화폐 거래소로, 그 API를 통해 여러 가지 기능을 자동화할 수 있습니다. Gemini API는 REST API와 WebSocket API를 제공합니다.
-
API 키 생성하기:
- Gemini에서 API를 사용하기 전에 먼저 계정에 로그인 한 후 'API 키 생성' 메뉴로 가서 API 키를 생성해야 합니다. 키 생성 시 접근 권한을 설정할 수 있습니다.
-
REST API 사용:
- 기본 URL:
https://api.gemini.com - 주요 엔드포인트:
GET /v1/symbols: 사용 가능한 거래 쌍 목록을 가져옵니다.GET /v1/pubticker/:symbol: 특정 거래 쌍에 대한 최신 가격 정보를 가져옵니다.POST /v1/order/new: 새로운 주문을 생성합니다. (인증 필요)- 자세한 내용은 Gemini API 문서를 참조하세요.
- 기본 URL:
-
WebSocket API 사용:
- 웹소켓을 통해 실시간 데이터 스트리밍이 가능합니다. 이를 통해 시장 가격 변동 등을 실시간으로 받을 수 있습니다.
- WebSocket 연결을 통해 주문, 거래, 시장 가격 등의 실시간 이벤트를 구독할 수 있습니다.
-
보안 및 인증:
- REST API 호출 시, 개인 키와 시크릿 키를 사용하여 요청을 인증해야 합니다. 일반적으로 HMAC-SHA384 해시로 서명합니다.
- 요청 시에는 타임스탬프와 페이로드를 함께 전송하여 보안을 강화합니다.
-
Gemini API 문서:
- 전체 기능과 사용 방법은 공식 Gemini API 문서를 참조하세요. 거기에는 각 엔드포인트에 대한 자세한 설명과 예제가 포함되어 있습니다.
API 사용 시 규정된 이용 약관을 준수해야 하며, 수수료나 서비스 제한 등이 적용될 수 있으니 주의하시기 바랍니다.
-
- User
cloudflare workers 환경에서 사용하고 싶습니다. 예제 코드를 작성해주세요.
- Assistant
Cloudflare Workers는 서버리스 환경에서 JavaScript 코드를 실행할 수 있게 해주는 플랫폼입니다. Gemini API를 Cloudflare Workers에서 사용하려면
fetchAPI를 활용하여 HTTP 요청을 보낼 수 있습니다. 아래는 기본적인 예제 코드로, Gemini의GET /v1/symbols엔드포인트를 호출하는 방법을 보여드립니다.// worker.js addEventListener('fetch', event => { event.respondWith(handleRequest(event.request)) }) async function handleRequest(request) { const url = 'https://api.gemini.com/v1/symbols' try { const response = await fetch(url, { method: 'GET', headers: { 'Content-Type': 'application/json', }, }) if (!response.ok) { return new Response(`Error: ${response.statusText}`, { status: response.status }) } const data = await response.json() return new Response(JSON.stringify(data, null, 2), { headers: { 'Content-Type': 'application/json' }, }) } catch (error) { return new Response(`Fetch error: ${error.message}`, { status: 500 }) } }이 코드에 대해:
-
Cloudflare Workers 이벤트 리스너:
addEventListener('fetch', ...)로 HTTP 요청을 감지하면handleRequest함수가 호출됩니다. -
fetchAPI 사용: Cloudflare Workers에서 네트워크 요청을 할 때는 기본 제공하는fetch메서드를 사용합니다. 위 코드는 Gemini에서 거래 가능한 모든 거래 쌍의 목록을 가져오는 예제입니다. -
예외 처리: 네트워크 요청 중 발생할 수 있는 오류를
try-catch블록을 사용해 처리합니다. 오류가 발생하면 500 상태 코드로 응답합니다.
인증이 필요한 API 엔드포인트 사용하기
Gemini에서 인증이 필요한 API를 호출하려면 HMAC-SHA384로 서명된 요청을 보내야 하므로, Node.js 환경과 같은 타 서버리스 환경보다 복잡해질 수 있습니다. Cloudflare Workers는 기본적으로 서버리스 환경에서의 비밀 관리가 까다롭기 때문에, 환경 변수를 관리할 수 있는 방법을 찾아야 합니다.
Cloudflare Workers와의 상호작용은 간단한 공개 API 호출에서 그치고, 비밀이나 키가 필요한 작업은 가능한 다른 서버 환경을 사용하는 것이 보안적으로 더 안전할 수 있습니다.
Secrets를 API 요청에 포함해야 하는 경우 Workers KV나 Secrets 환경을 활용할 수 있습니다. 이러한 방법을 이용하면 키가 안전하게 관리자에 의해 Workers에 주입될 수 있습니다. -