시작하기
Dataware API는 계정을 만든 직후 바로 호출하는 공개형 구조가 아닙니다.
기본 흐름은 로그인 → API 사용 신청 → 운영 심사 → 승인 → API 키 발급 → 사용량 확인 순서로 진행됩니다.
1. 먼저 확인할 것
- 필요한 dataset이 어떤 카탈로그에 포함되어 있는지
/datasets에서 먼저 확인합니다. - 실제 운영 계정으로 사용할지, 테스트 검토용 계정으로 사용할지 내부에서 먼저 정리합니다.
- 어떤 화면이나 서비스에 데이터를 연결할 예정인지 문장으로 설명할 수 있어야 합니다.
전체 데이터를 한 번에 요청하기보다, 실제로 사용할 dataset을 먼저 확인한 뒤 필요한 범위 기준으로 신청하는 흐름을 권장합니다.
2. 로그인과 신청
/account/sign-in에서 로그인합니다./application에서 API 사용 신청서를 작성합니다.- 담당자 정보, 소속, 연락처, 사용 목적을 제출합니다.
- 제출 후
/application/status에서 진행 상태를 확인합니다.
신청서에 보통 들어가는 내용
| 항목 | 설명 |
|---|---|
| 이름 / 이메일 / 전화번호 | 운영 연락과 신청자 확인에 사용됩니다. |
| 회사명 / 부서 / 직책 | 운영 협의와 권한 조정 시 기준이 됩니다. |
| 사용 목적 | 어떤 서비스나 업무에 데이터를 연결할지 설명합니다. |
3. 심사 상태
신청 상태는 아래와 같이 관리됩니다.
| 상태 | 의미 |
|---|---|
pending | 접수 후 대기 상태 |
under_review | 운영 검토 진행 중 |
needs_more_info | 추가 정보 또는 수정이 필요한 상태 |
approved | API 사용 가능 |
rejected | 승인되지 않은 상태 |
신청 상태와 별도로 계정 상태도 관리됩니다.
실제 API 키 발급과 호출은 신청 상태가 approved이고 계정 상태가 유효한 경우에만 가능합니다.
4. 승인 후 할 일
승인되면 아래 화면을 사용할 수 있습니다.
/dashboard계정 상태와 다음 행동을 확인하는 시작 화면/api-keysAPI 키 발급, 재발급, 폐기/usage키별 사용량과 기간별 호출 현황 확인
5. API 키 발급
API 키는 대시보드에서 발급합니다.
- 발급된 키 원문은 한 번만 표시됩니다.
- 키는 재발급하거나 폐기할 수 있습니다.
- 실제 서버 호출 시에는
Authorization: Bearer <API_KEY>형식을 사용합니다.
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://dataware.actibooky.com/v1/datasets