# 오픈 데이터 API

Tempussit에 게시된 모든 것 — 강좌, 블로그 글, 용어, 자주 묻는 질문 — 을 프로그램과 AI 어시스턴트를 위해 JSON으로 제공합니다. 읽기 전용이며 키나 가입이 필요 없습니다.

## 제공 내용

**`GET /data/v1/index.json`**

목차: 사이트 언어, 강좌 카탈로그, 모든 데이터 파일 링크.

**`GET /data/v1/courses/{languageKey}.json`**

카탈로그 한 언어의 강좌, 페이지당 100개(?page= 매개변수).

**`GET /data/v1/course/{slug}.json`**

게시된 강좌 하나의 카드: 제목, 설명, 저자, 언어, 가격, 커리큘럼, 페이지 주소, 표지.

**`GET /data/v1/{languageCode}/{kind}.json`**

사이트 한 언어의 용어, 자주 묻는 질문, 블로그 섹션과 글.

**`GET /data/v1/openapi.json`**

모든 응답을 OpenAPI 3.1 형식으로 설명한 문서.

## 요청 예시

```
curl https://tempussit.com/data/v1/index.json
curl https://tempussit.com/data/v1/courses/ko.json
curl https://tempussit.com/data/v1/course/{slug}.json
curl -I https://tempussit.com/data/v1/ko/faq.json

fetch("https://tempussit.com/data/v1/ko/glossary.json")
  .then(response => response.json());
```

## 이용 조건

- 읽기 전용: GET과 HEAD 요청만 받습니다.
- IP 주소 하나당 분당 요청 수가 제한됩니다. 한도를 넘으면 Retry-After 헤더와 함께 429로 응답합니다.
- 응답은 5분 동안 캐시할 수 있으며 어떤 사이트의 브라우저에서도 요청할 수 있습니다(Access-Control-Allow-Origin: \*).
- 공개 페이지에 보이는 것만: 초안, 구매, 개인 정보는 없습니다.
- 버전은 주소의 일부입니다(/data/v1/). 버전이 없는 이전 주소도 계속 작동합니다.

2026년 11월 9일 업데이트
