Skip to main content
이 섹션은 Data Hub 공개 REST 엔드포인트를 리소스별로 정리합니다. 각 페이지에는 메서드/경로, 인증, 파라미터, 실제 응답 예시와 필드 설명, 가능 오류, 클라이언트 대응 메서드가 있습니다. 이 페이지는 공통 규약만 다룹니다.

​
베이스 URL

/v1 계약은 추가만 합니다. 새 필드/엔드포인트는 생길 수 있지만 이미 공개된 필드의 이름과 의미는 바뀌지 않습니다. 알 수 없는 필드는 무시하세요.

​
인증

API 키는 Octoparse 계정 센터에서 만듭니다.
Data Hub API는 Authorization: Bearer만 받습니다. 쿼리에 자격 증명을 넣지 마세요. 상단 Octoparse 스크레이퍼 MCP의 x-api-key와 다릅니다.

​
응답 형태

성공은 data, 오류는 error. 동시에 나오지 않습니다.

​
오류

필드: code, category, message, retryable, details. 공통: 401 unauthorized, 404 *-not-found, 400 invalid-input.

​
페이지매김

목록은 offset/limit과 pagination을 사용합니다. has_more이면 offset에 count를 더하세요.

​
시간 파라미터

ISO 8601과 명시적 오프셋을 권장합니다. Unix epoch 초는 받지 않습니다.

​
App 참조

안정 id app_<hex>(권장) 또는 <namespace>/<app_name>.

​
실행 상태

비종료: PENDING, QUEUED, RUNNING. 종료: SUCCEEDED, PARTIALLY_SUCCEEDED, FAILED, CANCELLED, EXPIRED.

​
엔드포인트 그룹

Data App 검색

검색, 상세, 버전, README, 스펙, 번역

실행과 결과

시작, 조회, 목록, 취소, 레코드, 디버그 추적

데이터셋

결과 저장소와 보존 플래그

계정과 청구

누적 지출과 집계

시크릿

작성자용 업스트림 자격 증명

게시와 운영

Draft → Build → Release, 공유, 번역, 분석