🌐 NestJS HTTP Module – 외부 API 요청 완전 정복 가이드

🌐 NestJS HTTP Module – 외부 API 요청 완전 정복 가이드

---

NestJS에서 외부 API 서버(REST, JSON-RPC 등)와 통신하려면
@nestjs/axios 기반의 HTTP 모듈(HttpModule) 을 사용하는 것이 가장 간편하고 강력합니다.
Axios 기반으로 작동하므로 익숙한 방식으로 API 요청을 만들 수 있고,
RxJS 스트림과도 자연스럽게 결합됩니다.

이번 글은 NestJS 공식 문서 - HTTP Module을 바탕으로
기본 사용법, 비동기 설정, 전역 등록, RxJS 응답 처리법까지 실무 위주로 안내드립니다.

---

✅ 1. 설치 및 임포트

npm install @nestjs/axios axios

import { HttpModule } from '@nestjs/axios';

@Module({
  imports: [HttpModule],
  providers: [MyService],
})
export class MyModule {}

☑️ HttpService는 @nestjs/axios가 제공하는 의존성입니다.

---

✅ 2. 간단한 GET 요청 예제

반응형

import { Injectable } from '@nestjs/common';
import { HttpService } from '@nestjs/axios';
import { firstValueFrom } from 'rxjs';

@Injectable()
export class MyService {
  constructor(private readonly httpService: HttpService) {}

  async getUser() {
    const response = await firstValueFrom(
      this.httpService.get('https://jsonplaceholder.typicode.com/users/1'),
    );
    return response.data;
  }
}

☑️ firstValueFrom()을 사용하여 RxJS Observable을 Promise로 변환
☑️ response.data에 실제 응답 본문이 들어있습니다.

---

📺 광고

외부 API를 호출하는 서비스 함수는 대부분의 백엔드에서 핵심이 되는 기능입니다.
이 지점은 애드센스 광고가 가장 집중도 있게 노출될 수 있는 위치입니다.

<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-XXXXXX"
     data-ad-slot="YYYYYY"
     data-ad-format="auto"
     data-full-width-responsive="true"></ins>

---

✅ 3. POST 요청 및 헤더 포함

async createPost() {
  const payload = { title: 'New Post', body: '내용', userId: 1 };
  const headers = { 'Authorization': 'Bearer xxx' };

  const response = await firstValueFrom(
    this.httpService.post('https://jsonplaceholder.typicode.com/posts', payload, { headers }),
  );
  return response.data;
}

☑️ headers 옵션으로 인증 토큰 등도 자유롭게 전달 가능

---

✅ 4. 전역 HTTP 설정 (timeout, baseURL 등)

@Module({
  imports: [
    HttpModule.register({
      timeout: 5000,
      maxRedirects: 5,
      baseURL: 'https://api.example.com',
    }),
  ],
})

☑️ 모든 요청에 공통 적용되는 기본 옵션 설정

---

✅ 5. 비동기 등록 (useFactory)

HttpModule.registerAsync({
  useFactory: async (configService: ConfigService) => ({
    timeout: configService.get('HTTP_TIMEOUT'),
    baseURL: configService.get('API_BASE_URL'),
  }),
  inject: [ConfigService],
}),

☑️ .env 설정 파일을 통해 동적으로 구성할 수 있어 실무에서 매우 유용

---

✅ 6. RxJS 연동 예제 (응답 가공)

return this.httpService.get('https://api.example.com/data').pipe(
  map((res) => res.data.items),
  catchError((error) => {
    throw new Error('API 실패: ' + error.message);
  }),
);

☑️ RxJS를 활용하면 스트리밍, 리액티브 처리가 쉬워집니다.

---

✅ 실무 적용 팁 요약

작업 방법

API 응답 Promise 변환	firstValueFrom() 또는 lastValueFrom() 사용
공통 헤더, 타임아웃	register() 또는 registerAsync() 활용
응답 스트림 처리	pipe(map(), catchError())로 RxJS 스트림 변환
인증 처리	Authorization, API-Key 등 헤더 직접 지정
전역 공통 에러 핸들링	interceptors 또는 글로벌 예외 필터 추천

---

 

NestJS HTTP 모듈,NestJS HttpService 사용법,NestJS 외부 API 호출,NestJS axios 연동,NestJS 비동기 API 요청,NestJS HttpModule register,NestJS HttpModule 전역 설정,NestJS firstValueFrom,NestJS REST API 연동,NestJS 실무 외부 요청 처리

---