테스트 결과 조회 (Open API)

이 섹션은 프로젝트 내 Test Suite 실행 결과를 조회하는 방법을 설명합니다.
단일 Test Suite 실행 조회 API와 복수 Test Suite 실행 조회 API를 모두 다룹니다.

단일 Test Suite 결과 조회 #

지정한 Test Suite 실행 단위로 결과를 조회하는 API입니다.

엔드포인트 #

[GET] /openapi/v3/test-suite-runs/{test_suite_run_id}

인증 (Authorization) #

이 API를 호출하려면 username과 access_key를 조합한 Basic Auth 인증이 필요합니다.

key	type	required	default	description
auth	(username, access_key)	Y	–	암호화된 로그인 정보. API 호출 시 반드시 필요
username	str	Y	–	Ptero 로그인 ID
access_key	str	Y	–	Access Key (비밀번호 아님) 발급 위치: Ptero › 우측 상단 아이콘 › Edit Profile › Access Key

Note
username:access_key 문자열을 base64 인코딩하여 Authorization 헤더에 포함해야 합니다.

경로 파라미터 (Path Parameter) #

API 호출 시 반드시 Test Suite Run ID를 경로에 포함해야 합니다.

key	type	required	default	description
test_suite_run_id	int	Y	–	테스트 생성 API 응답에서 전달된 Test Suite Run ID

Output #

Content-Type: application/json

성공 응답 #

{
  "error_code": 0,
  "reason": "",
  "result": "success",
  "data": {
    "status": "running" | "complete",
    "pid": 123,
    "project_name": "Sample Project",
    "total_test_count": 10,
    "test_run_count": 8,
    "status_detail": {
      "aborted": 0,
      "failed": 1,
      "passed": 6,
      "stopped": 0,
      "warning": 1,
      "running": 0,
      "pending": 0
    }
  }
}

• status: 실행 상태 (running = 진행 중, complete = 완료)
• pid: 프로젝트 ID
• project_name: 프로젝트 이름
• total_test_count: 해당 Test Suite으로 생성될 전체 테스트 수
• test_run_count: 실제 생성된 테스트 수 (status_detail 내 값들의 합)
  
  
• status_detail: 각 상태별 테스트 수
  • aborted: 시스템에 의해 중단된 테스트 수
  • failed: 실패한 테스트 수
  • passed: 성공한 테스트 수
  • stopped: 사용자에 의해 중단된 테스트 수
  • warning: 경고 상태 테스트 수
  • running: 진행 중 테스트 수 (initializing 포함)
  • pending: 실행 대기 중인 테스트 수

오류 응답 #

error_code	reason	description
401	Could not verify your access level	가입되어 있지 않거나 잘못된 유저 정보
V001	Invalid value	잘못된 요청 값 (예: test_suite_run_id에 문자열 전달)
A010	Access denied for test-suite run	존재하지 않는 ID이거나 권한 없음, 또는 실행된 테스트 없음
A007	The service is currently under system maintenance.	서비스 점검 중
E0001	Internal Server Error	서버 내부 오류

오류 응답 형식은 단일 Test Suite 실행 API의 오류 응답 예시를 참고해 주세요.

복수 Test Suite 결과 조회 #

여러 Test Suite을 동시에 실행한 경우, 실행 단위는 Session으로 식별됩니다. 이 API는 지정한 Session ID로 해당 실행 단위의 결과를 조회합니다.

엔드포인트 #

[GET] /openapi/v3/multi-test-suite-runs/{session_id}

인증 (Authorization) #

이 API를 호출하려면 username과 access_key를 조합한 Basic Auth 인증이 필요합니다.

key	type	required	default	description
auth	(username, access_key)	Y	–	암호화된 로그인 정보. API 호출 시 반드시 필요
username	str	Y	–	Ptero 로그인 ID
access_key	str	Y	–	Access Key (비밀번호 아님). 발급 위치: Ptero › 우측 상단 아이콘 › Edit Profile › Access Key

Note
username:access_key 문자열을 base64 인코딩하여 Authorization 헤더에 포함해야 합니다.

경로 파라미터 (Path Parameter) #

API 호출 시 반드시 Session ID를 경로에 포함해야 합니다.

key	type	required	default	description
session_id	int	Y	–	multi-test-suite-runs API 응답에서 전달된 Session ID

Output #

content-type: application/json

성공 응답 #

{
  "error_code": 0,
  "reason": "",
  "result": "success",
  "data": {
    "status": "running" | "complete",
    "pid": 123,
    "project_name": "My Project",
    "total_test_count": 10,
    "test_run_count": 8,
    "status_detail": {
      "aborted": 0,
      "failed": 1,
      "passed": 6,
      "stopped": 0,
      "warning": 1,
      "running": 0,
      "pending": 0
    },
    "test_suite_runs": [
      {
        "status": "complete",
        "test_suite_run_id": 789,
        "test_suite_name": "Login Test Suite",
        "total_test_count": 5,
        "test_run_count": 5,
        "status_detail": {
          "aborted": 0,
          "failed": 0,
          "passed": 5,
          "stopped": 0,
          "warning": 0,
          "running": 0,
          "pending": 0
        }
      }
    ]
  }
}

• status: 실행 상태 (running = 진행 중, complete = 완료)
• pid: 프로젝트 ID
• project_name: 프로젝트 이름
• total_test_count: Session 요청으로 생성될 전체 테스트 수
• test_run_count: 실제 생성된 테스트 수 (status_detail 합계)
  
  
• status_detail: 상태별 테스트 개수
  • aborted: 시스템에 의해 중단된 테스트 수
  • failed: 실패한 테스트 수
  • passed: 성공한 테스트 수
  • stopped: 사용자에 의해 중단된 테스트 수
  • warning: 경고 상태 테스트 수
  • running: 진행 중인 테스트 수
  • pending: 실행 대기 중 테스트 수
    
    
• test_suite_runs: 세부 Test Suite 실행 결과 목록
  • test_suite_run_id: Test Suite 실행 ID
  • test_suite_name: Test Suite 이름
  • total_test_count: 해당 Test Suite로 생성될 테스트 수
  • test_run_count: 실제 생성된 테스트 수
  • status_detail: 해당 Test Suite의 상태별 개수

오류 응답 #

error_code	reason	description
401	Could not verify your access level	잘못된 사용자 정보 또는 Access Key 오류
V001	Invalid value	잘못된 요청 값 (예: session_id에 문자열 전달)
A011	Access denied for session	해당 Session ID가 존재하지 않거나 권한 없음
A007	The service is currently under system maintenance.	서비스 점검 중
E0001	Internal Server Error	서버 내부 오류

오류 응답 형식은 단일 Test Suite 실행 API의 오류 응답 예시를 참고해 주세요.