본문으로 건너뛰기

QA Agent API 레퍼런스 개요

소개​

QA Agent API 레퍼런스는 dta-wide QA Agent 서비스에서 제공하는 모든 API 엔드포인트에 대한 상세한 정보를 제공합니다.

API 카테고리​

QA Agent API는 다음과 같은 카테고리로 구성되어 있습니다:

1. 로그 수집 API​

모바일 애플리케이션의 로그를 수집하고 분석하는 API입니다.

2. 테스트 자동화 API (준비중)​

  • Test Generation API: AI 기반 테스트 케이스 자동 생성
  • Test Execution API: 테스트 실행 및 모니터링
  • Results Reporting API: 테스트 결과 리포팅

3. MCP 서버 API (준비중)​

  • Claude MCP Protocol: AI 어시스턴트와의 통합을 위한 MCP 프로토콜 지원

API 사용 가이드​

기본 URL​

개발: http://localhost:3003
스테이징: https://dta-wide-agent-qa-stage.welt.care
프로덕션: https://dta-wide-agent-qa.welt.care

인증​

모든 API 요청에는 Bearer 토큰 인증이 필요합니다:

Authorization: Bearer <app-token>

응답 형식​

모든 API는 JSON 형식으로 응답합니다:

{
  "success": true,
  "data": { ... }
}

에러 응답​

에러 발생 시 다음과 같은 형식으로 응답합니다:

{
  "code": 11000,
  "message": "ERROR_CODE",
  "detail": "에러에 대한 상세 설명",
  "metadata": { ... }
}

개발자 도구​

Swagger UI​

개발 환경에서는 Swagger UI를 통해 API를 테스트할 수 있습니다:

http://localhost:3003/api

예제 코드​

각 API 문서에는 다양한 프로그래밍 언어의 예제 코드가 포함되어 있습니다.

버전 관리​

QA Agent API는 URL 경로에 버전을 포함합니다:

/v1/logs/mobile

새로운 버전이 출시되더라도 이전 버전은 일정 기간 동안 유지됩니다.