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

홈

소개

이용 가이드

표준적합성 시험

Open API

빠른 시작 — 처음이라면 이 순서로

명세서 확인 → 토큰 준비 → 호출까지, 세 단계면 충분합니다.

1. 명세서 확인

명세서에서 API 경로·메서드·요청 형식을 확인합니다.

Open API › Open API 명세서

2. 토큰 준비

발급을 신청하고, 승인되면 토큰 키를 확인합니다.

계정 관리 › 토큰 관리

3. 호출하고 확인

Authorization 헤더로 요청하고 응답을 확인합니다.

API 요청 › JSON 응답

1 / 4

이용 흐름

명세서에서 제공 범위를 확인하고, 토큰을 준비한 뒤, 인증 헤더로 데이터를 조회하거나 저장하는 흐름으로 이용합니다.

명세서 확인

Open API

제공 API와 요청 형식을 확인합니다.

토큰 준비

사용자

발급 신청과 승인 이력을 확인합니다.

API 요청

외부 시스템

경로·파라미터·인증 헤더를 구성합니다.

결과 확인

Open API

JSON 응답과 접근 로그가 남습니다.

여기서 시작합니다

Open API › Open API 명세서

명세서 열기

확인할 것

✓ 제공 범위 — 참조 데이터·인증 시험·시험 결과 등 어떤 자원을 다루는지
✓ 호출 기준 — HTTP 메서드와 URL 경로
✓ 토큰 필요 여부 — 대부분의 호출에 인증 토큰이 필요합니다

API 호출 및 응답

토큰 인증, 요청 형식 확인, 데이터 조회 또는 저장, 응답 반환, 접근 로그 저장 순서로 처리됩니다.

첫 API 호출해 보기

시험 시나리오 목록 조회

발급받은 토큰 키를 설정한 뒤 아래 예제를 사용하세요.

GET


                  /api/v1/scenarios/

1. 토큰 설정 Bash / WSL

export OPEN_API_TOKEN='발급받은_토큰_키'

따옴표 안을 실제 토큰 키로 바꿔 주세요.

2. 요청 예제

curl -X GET \
  https://conformancetest.itskorea.kr/api/v1/scenarios/ \
  -H "Authorization: Token $OPEN_API_TOKEN"

import json
import os
from urllib.request import Request, urlopen

request = Request(
    "https://conformancetest.itskorea.kr/api/v1/scenarios/",
    headers={
        "Authorization": f"Token {os.environ['OPEN_API_TOKEN']}",
    },
)
with urlopen(request, timeout=15) as response:
    print(json.load(response))

Python 3 · 추가 패키지 설치 없이 사용할 수 있습니다.

서버 주소는 실제 호출 환경에 맞게 바꿔 주세요.

3. 응답 확인 200 OK · 샘플

응답 JSON 보기

[
  {
    "id": 1,
    "name": "DEMO-001",
    "title": "연동 확인용 시나리오",
    "description": "설명 예시",
    "category": "샘플 범주",
    "standards": ["샘플 표준"],
    "created_at": "2026-09-28T00:00:00Z",
    "updated_at": "2026-09-28T00:00:00Z"
  }
]

샘플 데이터입니다. 실제 필드와 응답은 명세서를 확인해 주세요.

호출 전 확인

Authorization: Token <토큰 키>

확인할 것

✓ 인증 헤더 — 토큰 키를 정확한 형식으로 포함
✓ 요청 데이터 — 명세서의 타입·필수 여부에 맞춰 입력
✓ 접근 로그 — 호출 이력은 자동으로 저장됩니다

호출이 거부된다면

토큰이 없거나 만료·회수된 경우 거부됩니다. 응답 코드와 메시지로 원인을 먼저 확인하세요.

응답이 예상과 다르다면

응답 코드를 선택하면 먼저 확인할 내용을 볼 수 있습니다.

200 정상 처리

반환된 JSON을 확인하세요. 목록이 비어 있다면 조회 조건에 맞는 데이터가 있는지 확인해 주세요.

400 요청 값 확인

응답 메시지에 표시된 필드의 값과 형식을 확인하세요. 이 예제의 category·standard 필터는 양의 정수 ID를 사용합니다.

401 토큰 확인

Authorization 헤더에 Token과 토큰 키가 포함되어 있는지 확인하세요. 만료·회수된 토큰이나 비활성 계정으로는 호출할 수 없습니다.

403 접근 권한 확인

인증 후 해당 API에 필요한 권한이 있는지 확인하세요. 관리자용 토큰 관리 API는 별도의 내부 DRF 토큰과 활성 관리자 권한이 필요합니다.

404 주소와 ID 확인

명세서의 경로와 실제 요청 주소를 비교하세요. {id}와 같은 자리표시자를 실제 값으로 바꾸었는지, 대상 데이터가 존재하는지 확인해 주세요.

API별 응답 명세 확인 ↗

알아두면 좋은 용어

화면에서 자주 만나는 다섯 가지입니다.

토큰(Token) Open API 호출에 사용하는 인증 키로, 발급 신청 후 승인되면 확인할 수 있습니다.

API 인증 Authorization 헤더에 토큰을 담아 호출 사용자를 확인하는 절차입니다.

RESTful API HTTP 메서드와 URL 경로로 필요한 자원을 요청하는 방식입니다.

API 호출 인증 확인부터 응답 반환, 접근 로그 저장까지 이어지는 처리 과정입니다.

JSON 요청과 응답 데이터를 주고받을 때 사용하는 표준 데이터 형식입니다.

추가로 확인이 필요한 내용은 Q&A로 남겨 주세요.

사용 신청 · 문의

한국지능형교통체계협회 주관연구기관 신영섭 선임연구원 · diosix@itskorea.kr

㈜지슨 공동연구기관 김건명 프로 · gmkim@gitsn.com

빠른 시작 — 처음이라면 이 순서로

1. 명세서 확인

2. 토큰 준비

3. 호출하고 확인

이용 흐름

명세서 확인

토큰 준비

API 요청

결과 확인

확인할 것

토큰 신청 및 확인

확인할 것

명세서 확인

확인할 것

API 호출 및 응답

첫 API 호출해 보기

확인할 것

응답이 예상과 다르다면

알아두면 좋은 용어

코드 직접 복사