Dataware

로그인

요청 예시

아래 예시는 Dataware API 연동 전 가장 자주 참고하는 호출 패턴을 정리한 것입니다.

1. dataset 목록 확인

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://dataware.actibooky.com/v1/datasets?page=1&limit=20"

예상 목적:

  • 현재 접근 가능한 dataset 목록 확인
  • 연동 대상 카탈로그 식별

2. 특정 dataset 범위 조회

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://dataware.actibooky.com/v1/datasets/nolgofarm_experience_sites/items?page=1&limit=20"

예상 목적:

  • 특정 dataset에 포함된 레코드 목록 확인
  • 초기 연동 또는 검증용 샘플 수집

3. 분류 기준 필터링

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://dataware.actibooky.com/v1/datasets/nolgofarm_experience_sites/items?category_code=craft-cooking&status=active&page=1&limit=20"

예상 목적:

  • 특정 분류만 선별 조회
  • 운영 중 필요한 subset만 연결

4. 검색어 기반 조회

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://dataware.actibooky.com/v1/datasets/nolgofarm_experience_sites/items?q=%EC%BA%A0%ED%94%84&page=1&limit=20"

예상 목적:

  • 이름 또는 설명 기준 검색
  • 관리자 검수 또는 내부 QA

5. JavaScript fetch 예시

const response = await fetch(
  "https://dataware.actibooky.com/v1/datasets/nolgofarm_experience_sites/items?page=1&limit=20",
  {
    headers: {
      Authorization: `Bearer ${process.env.DATAWARE_API_KEY}`,
      Accept: "application/json",
    },
  },
);

const data = await response.json();
console.log(data);

6. 실패 시 먼저 확인할 것

  • API 키가 만료되거나 폐기되지 않았는지
  • 신청 상태와 계정 상태가 유효한지
  • 대상 dataset이 현재 계정 접근 범위에 포함되는지
  • 필터 파라미터 이름이 정확한지

7. 응답 예시

{
  "items": [
    {
      "id": "item_123",
      "name": "감말랭이 쿠킹클래스",
      "category_code": "craft-cooking",
      "status": "active"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 162
}

다음 문서