외부 API 연동 클라이언트 코드를 생성하는 프롬프트

언제 사용하나

서드파티 API를 호출하는 클라이언트를 재시도·타임아웃까지 챙겨 만들 때.

요청 전 확인

• API 문서(인증 방식, 요청/응답, 레이트 리밋)를 확보한다.
• 비밀 키는 코드가 아닌 환경변수로 관리할지 정한다.

복사해서 쓰는 프롬프트

{{API_NAME}} 연동 클라이언트를 {{LANGUAGE}}로 작성해줘.

- 인증: {{AUTH}} (키는 환경변수 {{ENV_VAR}}에서 읽어줘, 코드에 하드코딩 금지)
- 타임아웃과 실패 재시도(지수 백오프)를 넣어줘.
- 레이트 리밋(429)과 5xx를 구분해 처리해줘.
- 응답을 우리 도메인 모델로 매핑하고, 실패는 명확한 예외로 변환해줘.
- 네트워크 호출을 목킹한 테스트를 작성해줘.

placeholder 설명

• {{API_NAME}} : 연동 대상 API
• {{AUTH}} : 인증 방식 (예: "Bearer 토큰")
• {{ENV_VAR}} : 키를 담을 환경변수 이름

입력 예시

{{API_NAME}} = "결제 게이트웨이", {{ENV_VAR}} = "PAYMENT_API_KEY"

기대 결과

타임아웃·재시도·429 처리를 갖춘 클라이언트와 목 테스트.

검증 방법

목 서버로 429/5xx 응답을 흉내 내 재시도 동작을 확인한다.

주의사항

• API 키를 코드나 로그에 남기지 않는다.

관련 문서

• MDN Fetch API: https://developer.mozilla.org/ko/docs/Web/API/Fetch_API