Gemini API 통합 프롬프트 - REST API, GraphQL, 웹훅

간단 버전

{{API_이름}} API를 통합해주세요.
기능: {{필요_기능}}, 언어: {{언어}}
클라이언트 코드와 에러 처리를 포함해주세요.

입력값 가이드

인풋 필드

[API 이름]
▼ 텍스트 입력
placeholder: "예: Slack, Stripe, GitHub"
설명: 연동할 외부 서비스 이름을 입력하세요

[필요 기능]
▼ 텍스트 영역 입력
placeholder: "예: 메시지 전송, 결제 처리"
설명: 구현할 주요 기능을 입력하세요

[인증 방식]
▼ 드롭다운 선택
옵션: OAuth 2.0, API Key, JWT, Basic Auth, 없음
placeholder: "예: OAuth 2.0, API Key, JWT"
설명: API가 요구하는 인증 방식을 선택하세요

[웹훅 필요]
▼ 드롭다운 선택
옵션: 필요함, 불필요
placeholder: "예: 필요함, 불필요"
설명: 웹훅 수신 여부를 선택하세요

[언어]
▼ 드롭다운 선택
옵션: TypeScript, Python, Node.js, Java, Go
placeholder: "예: TypeScript, Python, Node.js"
설명: 개발 언어/프레임워크를 선택하세요

인증 방식별 구현

API Key

const client = new APIClient({
  baseUrl: 'https://api.example.com',
  headers: { 'X-API-Key': process.env.API_KEY }
});

OAuth 2.0

// 1. 인증 URL 생성 → 2. 콜백 처리 → 3. 토큰 저장
const authUrl = oauth.getAuthorizationUrl(state);
const tokens = await oauth.exchangeCodeForToken(code);

JWT

const token = jwt.sign({ userId }, secret, { expiresIn: '1h' });
headers: { 'Authorization': `Bearer ${token}` }

Rate Limiting 대응

class RateLimiter {
  async waitForToken(): Promise<void> {
    if (this.tokens < 1) {
      await this.sleep(this.calculateWaitTime());
    }
    this.tokens--;
  }
}

에러 핸들링

재시도 정책

const retryPolicy = {
  maxRetries: 3,
  backoffStrategy: 'exponential',
  baseDelay: 1000,
  retryableStatusCodes: [429, 500, 502, 503, 504]
};

체크리스트

• 인증 구현 (OAuth/APIKey/JWT)
• Rate Limiting 대응
• 재시도 로직
• 에러 핸들링
• 웹훅 서명 검증 (필요시)