Dataware

로그인

Datasets API

데이터셋 목록 및 상세 조회 엔드포인트입니다.

모든 엔드포인트는 API Key 인증이 필요합니다. 인증 문서를 참고하세요.

GET /v1/datasets

API 키로 접근 가능한 데이터셋 목록을 반환합니다.

인증

Authorization: Bearer <API_KEY>

요청

파라미터 없음

성공 응답

HTTP 200 OK

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "slug": "tourist-spots",
      "name": "관광지",
      "description": "전국 관광지 데이터셋",
      "status": "active",
      "visibility": "public",
      "accessTier": "free",
      "createdAt": "2025-01-01T00:00:00.000Z",
      "updatedAt": "2025-01-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "total": 5
  }
}

응답 필드 — data[]

필드타입설명
idstring데이터셋 UUID
slugstringURL 슬러그
namestring데이터셋 이름
descriptionstring | null설명
statusstringdraft, active, inactive, archived
visibilitystringpublic, restricted, paid
accessTierstring | null접근 등급
createdAtstring생성 시각 (ISO 8601)
updatedAtstring수정 시각 (ISO 8601)

에러 응답

HTTP 상태에러 코드설명
401UNAUTHORIZED인증 실패

GET /v1/datasets/:datasetId

데이터셋 상세 정보를 반환합니다.

인증

Authorization: Bearer <API_KEY>

Path 파라미터

파라미터타입필수설명
datasetIdstringYesDataset UUID 또는 slug

성공 응답

HTTP 200 OK

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "slug": "tourist-spots",
    "name": "관광지",
    "description": "전국 관광지 데이터셋",
    "visibility": "public",
    "accessTier": "free",
    "attribution": "한국관광공사",
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-01-01T00:00:00.000Z"
  },
  "meta": {}
}

에러 응답

HTTP 상태에러 코드설명
401UNAUTHORIZED인증 실패
403DATASET_ACCESS_DENIED접근 권한 없음
404NOT_FOUND데이터셋 없음