Files
vexplor/PLAN.MD

2.0 KiB

프로젝트: 외부 REST API 커넥션 관리 확장 (POST/Body 지원)

개요

현재 GET 방식 위주로 구현된 외부 REST API 커넥션 관리 기능을 확장하여, POST, PUT, DELETE 등 다양한 HTTP 메서드와 JSON Request Body를 설정하고 테스트할 수 있도록 개선합니다. 이를 통해 토큰 발급 API나 데이터 전송 API 등 다양한 외부 시스템과의 연동을 지원합니다.

핵심 기능

  1. DB 스키마 확장: external_rest_api_connections 테이블에 default_method, default_body 컬럼 추가
  2. 백엔드 로직 개선:
    • 커넥션 생성/수정 시 메서드와 바디 정보 저장
    • 연결 테스트 시 설정된 메서드와 바디를 사용하여 요청 수행
    • SSL 인증서 검증 우회 옵션 적용 (내부망/테스트망 지원)
  3. 프론트엔드 UI 개선:
    • 커넥션 설정 모달에 HTTP 메서드 선택(Select) 및 Body 입력(Textarea/JSON Editor) 필드 추가
    • 테스트 기능에서 Body 데이터 포함하여 요청 전송

테스트 계획

1단계: 기본 기능 및 DB 마이그레이션

  • DB 마이그레이션 스크립트 작성 및 실행
  • 백엔드 타입 정의 수정 (default_method, default_body 추가)

2단계: 백엔드 로직 구현

  • 커넥션 생성/수정 API 수정 (필드 추가)
  • 커넥션 상세 조회 API 확인
  • 연결 테스트 API 수정 (Method, Body 반영하여 요청 전송)

3단계: 프론트엔드 구현

  • 커넥션 관리 리스트/모달 UI 수정
  • 연결 테스트 UI 수정 및 기능 확인

에러 처리 계획

  • JSON 파싱 에러: Body 입력값이 유효한 JSON이 아닐 경우 에러 처리
  • API 호출 에러: 외부 API 호출 실패 시 상세 로그 기록 및 클라이언트에 에러 메시지 전달
  • SSL 인증 에러: rejectUnauthorized: false 옵션으로 처리 (기존 RestApiConnector 활용)

진행 상태

  • [완료] 모든 단계 구현 완료