데이터 표준적합성 시험 시스템

홈

Open API

Open API 명세서

참조 데이터

인증 시험

환경설정

자체 시험

시험 시나리오

시험 결과

토큰 관리

메서드 경로 설명

GET /api/v1/categories/ 시험 범주 목록 조회

시험 범주 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/categories/" \
  -H "Authorization: $TOKEN"

응답

200 (array)

필드	타입	필수
array items ↓
id	integer	*
name	string	*
description	string	—
depth	integer	*

GET /api/v1/categories/{id}/ 시험 범주 상세 조회

시험 범주 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/categories/{id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	시험 범주을 식별하는 고유한 정수 값.

응답

200 (object)

필드	타입	필수
id	integer	*
name	string	*
description	string	—
depth	integer	*

GET /api/v1/standards/ 표준/규격 목록 조회

표준/규격 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/standards/" \
  -H "Authorization: $TOKEN"

응답

200 (array)

필드	타입	필수
array items ↓
id	integer	*
name	string	*
description	string	—

GET /api/v1/standards/{id}/ 표준/규격 상세 조회

표준/규격 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/standards/{id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	표준/규격을 식별하는 고유한 정수 값.

응답

200 (object)

필드	타입	필수
id	integer	*
name	string	*
description	string	—

GET /api/v1/test-targets/ 대상 시스템 목록 조회

대상 시스템 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/test-targets/" \
  -H "Authorization: $TOKEN"

응답

200 (array)

필드	타입	필수
array items ↓
id	integer	*
name	string	*
description	string	—

GET /api/v1/test-targets/{id}/ 대상 시스템 상세 조회

대상 시스템 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/test-targets/{id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	대상 시스템을 식별하는 고유한 정수 값.

응답

200 (object)

필드	타입	필수
id	integer	*
name	string	*
description	string	—

메서드 경로 설명

GET /api/v1/certified-tests/ 인증 시험 목록 조회

인증 시험 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/certified-tests/?state={value}" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
state	query	string	—	현재 상태명

응답

200 (array)

필드	타입	필수
array items ↓
id	integer	*
title	string	*
current_state	string	*
scenario_name	string \| null	*
requested_at	string (date-time)	*

GET /api/v1/certified-tests/{id}/ 인증 시험 상세 조회

인증 시험 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/certified-tests/{id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	시험 신청을 식별하는 고유한 정수 값.

응답

200 (object)

필드	타입	필수	설명
id	integer	*
title	string	*
current_state	string	*
scenario_name	string \| null	*
requested_at	string (date-time)	*
test_jobs	array	*
array items ↓
↳ id	integer	*
↳ state	string	—	* `INIT` - 초기화 * `JOIN_CTRL` - 컨트롤러 연결 * `JOIN_AG` - 에이전트 연결 * `READY` - 준비 완료 * `SET_CONF` - 설정 적용 * `START` - 시험 실행 * `STOP` - 시험 중지 * `COMPLETE` - 시험 완료 * `SUCCESS` - 시험 성공 * `FAILURE` - 시험 실패 [INIT, JOIN_CTRL, JOIN_AG, READY, SET_CONF, START, STOP, COMPLETE, SUCCESS, FAILURE]
↳ success_count	integer	—
↳ failure_count	integer	—
↳ complete_count	integer	—
request_data	array	*
array items ↓
↳ company_name	string	—
↳ company_phone	string	—
↳ company_address	string	—
actions	array	*
array items ↓
↳ id	integer	*
↳ action	string	*
↳ next_state	string	*
↳ user	string	*
↳ actioned_at	string (date-time)	*
result_attachments	array	*
array items ↓
↳ id	integer	*
↳ is_admin	boolean	—
↳ description	string	—
↳ submitted_by	string \| null	*
↳ submitted_at	string (date-time) \| null	—
↳ is_submitted	boolean	—
↳ files	array	*
array items ↓
↳ id	integer	*
↳ file_name	string	*
↳ file	string	*

GET /api/v1/certified-tests/states/ 인증 시험 상태 목록 조회

인증 시험 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/certified-tests/states/" \
  -H "Authorization: $TOKEN"

응답

200 (array)

필드	타입	필수
array items ↓
name	string	*
state_type	string	*

GET /api/v1/result-attachments/{id}/download/ 시험 결과 첨부파일 다운로드

모든 API 요청·응답을 ApiAccessLog에 기록하는 믹스인

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/result-attachments/{id}/download/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	—

응답

200

메서드 경로 설명

GET /api/v1/configurations/history/{scenario_id}/ 환경설정 기록 조회

시나리오별 마지막 환경설정 입력값 조회 및 갱신 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/configurations/history/{scenario_id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
scenario_id	path	integer	*	—

응답

200 (object)

필드	타입	필수
scenario	integer	*
composition	integer \| null	—
data	string	—
updated_at	string (date-time)	*

PUT /api/v1/configurations/history/{scenario_id}/ 환경설정 기록 저장

시나리오별 마지막 환경설정 입력값 조회 및 갱신 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X PUT \
  "https://conformancetest.itskorea.kr/api/v1/configurations/history/{scenario_id}/" \
  -H "Authorization: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"data": {}}'

파라미터

이름	위치	타입	필수	설명
scenario_id	path	integer	*	—

요청 본문 (object)

필드	타입	필수	설명
data	object	*

응답

200 (object)

필드	타입	필수
scenario	integer	*
composition	integer \| null	—
data	string	—
updated_at	string (date-time)	*

GET /api/v1/configurations/presets/ 환경설정 프리셋 목록 조회

시나리오별 환경설정 프리셋 목록 조회 및 저장 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/configurations/presets/?scenario={value}" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
scenario	query	string	*	시나리오 ID

응답

200 (array)

필드	타입	필수
array items ↓
id	integer	*
scenario	integer	*
name	string	*
data	string	—
created_at	string (date-time)	*
updated_at	string (date-time)	*

POST /api/v1/configurations/presets/ 환경설정 프리셋 저장

시나리오별 환경설정 프리셋 목록 조회 및 저장 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X POST \
  "https://conformancetest.itskorea.kr/api/v1/configurations/presets/" \
  -H "Authorization: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"scenario": 0, "name": "", "data": {}}'

요청 본문 (object)

필드	타입	필수
scenario	integer	*
name	string	*
data	object	*

응답

201 (object)

필드	타입	필수
id	integer	*
scenario	integer	*
name	string	*
data	string	—
created_at	string (date-time)	*
updated_at	string (date-time)	*

DELETE /api/v1/configurations/presets/{preset_id}/ 환경설정 프리셋 삭제

환경설정 프리셋 삭제 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X DELETE \
  "https://conformancetest.itskorea.kr/api/v1/configurations/presets/{preset_id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
preset_id	path	integer	*	—

응답

204 No response body

메서드 경로 설명

GET /api/v1/in-house-tests/ 자체 시험 목록 조회

자체 시험 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/in-house-tests/?state={value}" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
state	query	string	—	현재 상태명

응답

200 (array)

필드	타입	필수
array items ↓
id	integer	*
title	string	*
current_state	string	*
scenario_name	string \| null	*
requested_at	string (date-time)	*

GET /api/v1/in-house-tests/{id}/ 자체 시험 상세 조회

자체 시험 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/in-house-tests/{id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	시험 신청을 식별하는 고유한 정수 값.

응답

200 (object)

필드	타입	필수	설명
id	integer	*
title	string	*
current_state	string	*
scenario_name	string \| null	*
requested_at	string (date-time)	*
test_jobs	array	*
array items ↓
↳ id	integer	*
↳ state	string	—	* `INIT` - 초기화 * `JOIN_CTRL` - 컨트롤러 연결 * `JOIN_AG` - 에이전트 연결 * `READY` - 준비 완료 * `SET_CONF` - 설정 적용 * `START` - 시험 실행 * `STOP` - 시험 중지 * `COMPLETE` - 시험 완료 * `SUCCESS` - 시험 성공 * `FAILURE` - 시험 실패 [INIT, JOIN_CTRL, JOIN_AG, READY, SET_CONF, START, STOP, COMPLETE, SUCCESS, FAILURE]
↳ success_count	integer	—
↳ failure_count	integer	—
↳ complete_count	integer	—
request_data	array	*
array items ↓
↳ company_name	string	—
↳ company_phone	string	—
↳ company_address	string	—
actions	array	*
array items ↓
↳ id	integer	*
↳ action	string	*
↳ next_state	string	*
↳ user	string	*
↳ actioned_at	string (date-time)	*
result_attachments	array	*
array items ↓
↳ id	integer	*
↳ is_admin	boolean	—
↳ description	string	—
↳ submitted_by	string \| null	*
↳ submitted_at	string (date-time) \| null	—
↳ is_submitted	boolean	—
↳ files	array	*
array items ↓
↳ id	integer	*
↳ file_name	string	*
↳ file	string	*

GET /api/v1/in-house-tests/states/ 자체 시험 상태 목록 조회

자체 시험 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/in-house-tests/states/" \
  -H "Authorization: $TOKEN"

응답

200 (array)

필드	타입	필수
array items ↓
name	string	*
state_type	string	*

메서드 경로 설명

GET /api/v1/scenarios/ 시험 시나리오 목록 조회

시험 시나리오 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/scenarios/?category={value}&standard={value}" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
category	query	integer	—	범주 ID
standard	query	integer	—	표준/규격 ID

응답

200 (array)

필드	타입	필수
array items ↓
id	integer	*
name	string	*
title	string	*
description	string	—
category	string	*
standards	array	*
array items ↓
↳	string	—
created_at	string (date-time)	*
updated_at	string (date-time)	*

GET /api/v1/scenarios/{id}/ 시험 시나리오 상세 조회

시험 시나리오 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/scenarios/{id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	시험 시나리오을 식별하는 고유한 정수 값.

응답

200 (object)

필드	타입	필수
id	integer	*
name	string	*
title	string	*
description	string	—
category	string	*
standards	array	*
array items ↓
↳	string	—
created_at	string (date-time)	*
updated_at	string (date-time)	*
compositions	array	*
array items ↓
↳ id	integer	*
↳ title	string	*
↳ source	string	*
↳ destination	string	*
↳ items	array	*
array items ↓
↳ id	integer	*
↳ version	string	*
↳ description	string	—
↳ created_at	string (date-time)	*
↳ updated_at	string (date-time)	*

메서드 경로 설명

GET /api/v1/test-results/ 시험 결과 목록 조회

시험 결과 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/test-results/?request={value}&state={value}" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
request	query	string	—	인증 시험 신청 ID
state	query	string	—	시험 상태

응답

200 (array)

필드	타입	필수	설명
array items ↓
id	integer	*
state	string	—	* `INIT` - 초기화 * `JOIN_CTRL` - 컨트롤러 연결 * `JOIN_AG` - 에이전트 연결 * `READY` - 준비 완료 * `SET_CONF` - 설정 적용 * `START` - 시험 실행 * `STOP` - 시험 중지 * `COMPLETE` - 시험 완료 * `SUCCESS` - 시험 성공 * `FAILURE` - 시험 실패 [INIT, JOIN_CTRL, JOIN_AG, READY, SET_CONF, START, STOP, COMPLETE, SUCCESS, FAILURE]
success_count	integer	—
failure_count	integer	—
request_id	integer	—
request_title	string	*

GET /api/v1/test-results/{id}/ 시험 결과 상세 조회

시험 결과 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/test-results/{id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	시험 작업을 식별하는 고유한 정수 값.

응답

200 (object)

필드	타입	필수	설명
id	integer	*
state	string	—	* `INIT` - 초기화 * `JOIN_CTRL` - 컨트롤러 연결 * `JOIN_AG` - 에이전트 연결 * `READY` - 준비 완료 * `SET_CONF` - 설정 적용 * `START` - 시험 실행 * `STOP` - 시험 중지 * `COMPLETE` - 시험 완료 * `SUCCESS` - 시험 성공 * `FAILURE` - 시험 실패 [INIT, JOIN_CTRL, JOIN_AG, READY, SET_CONF, START, STOP, COMPLETE, SUCCESS, FAILURE]
success_count	integer	—
failure_count	integer	—
request_id	integer	—
request_title	string	*
configuration	string	—
messages	array	*
array items ↓
↳ sequence_number	integer	—
↳ client_type	string	*	* `AGENT` - 에이전트 * `CONTROLLER` - 제어 [AGENT, CONTROLLER]
↳ is_req	boolean	—
↳ message	string \| null	—
↳ created_at	string (date-time)	*

GET /api/v1/test-results/states/ 시험 결과 상태 목록 조회

시험 결과 조회 — ApiToken 인증 필요

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/test-results/states/" \
  -H "Authorization: $TOKEN"

응답

200 (array)

필드	타입	필수
array items ↓
code	string	*
label	string	*

메서드 경로 설명

GET /api/v1/tokens/ 토큰 목록 조회

API 토큰 관리 — 관리자 전용

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/tokens/" \
  -H "Authorization: $TOKEN"

응답

200 (array)

필드	타입	필수
array items ↓
id	integer	*
username	string	*
key	string	*
description	string	—
created_at	string (date-time)	*
expires_at	string (date-time)	*

POST /api/v1/tokens/ 토큰 발급

API 토큰 관리 — 관리자 전용

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X POST \
  "https://conformancetest.itskorea.kr/api/v1/tokens/" \
  -H "Authorization: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user": 0, "description": ""}'

요청 본문 (object)

필드	타입	필수	설명
user	integer	*
description	string	—

응답

201 (object)

필드	타입	필수
id	integer	*
username	string	*
key	string	*
description	string	—
created_at	string (date-time)	*
expires_at	string (date-time)	*

GET /api/v1/tokens/{id}/ 토큰 정보 조회

API 토큰 관리 — 관리자 전용

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X GET \
  "https://conformancetest.itskorea.kr/api/v1/tokens/{id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	API 토큰을 식별하는 고유한 정수 값.

응답

200 (object)

필드	타입	필수
id	integer	*
username	string	*
key	string	*
description	string	—
created_at	string (date-time)	*
expires_at	string (date-time)	*

PATCH /api/v1/tokens/{id}/ 토큰 만료일 수정

API 토큰 관리 — 관리자 전용

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X PATCH \
  "https://conformancetest.itskorea.kr/api/v1/tokens/{id}/" \
  -H "Authorization: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"expires_at": ""}'

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	API 토큰을 식별하는 고유한 정수 값.

요청 본문 (object)

필드	타입	필수	설명
expires_at	string (date-time)	—

응답

200 (object)

필드	타입	필수	설명
expires_at	string (date-time)	*

DELETE /api/v1/tokens/{id}/ 토큰 삭제

API 토큰 관리 — 관리자 전용

요청 예시

$TOKEN 에 발급받은 토큰 키를 입력하세요.

curl -X DELETE \
  "https://conformancetest.itskorea.kr/api/v1/tokens/{id}/" \
  -H "Authorization: $TOKEN"

파라미터

이름	위치	타입	필수	설명
id	path	integer	*	API 토큰을 식별하는 고유한 정수 값.

응답

204 No response body