Publishing
게시자 사용량
기간 내 게시 App 호출: 합계와 일·시간·App·채널 등 내역.
GET
게시자 사용량
GET https://api-datahub.octoparse.com/v1/publisher/usage
인증: API 키 필요(Authorization: Bearer <API Key>).
기간 동안 내 App이 어떻게 호출되었는지: 기간 합계와 함께 일별(짧은 기간은 시간별), App별, 호출 채널별 분석(임의의 두 가지를 교차 가능), 또는 최종 상태·버전·오류 코드별 진단 분석을 제공합니다. 청구 집계의 게시자 측 대응 기능으로, 용어가 같습니다(created_from / created_to는 실행 시작 시각 기준이며 시작은 포함, 끝은 제외. tz_offset은 날짜 경계만 옮김. data_app / triggered_by로 범위를 좁힘). 다만 소유 기준이 “내가 시작한 실행”에서 “내가 소유한 App”(Release가 0개인 App 포함)으로 바뀝니다.
일/시간/App/채널별 분석은 최종 상태에 도달할 때 누적되는 시간 단위 버킷에서 나오므로, 어떤 기간과 정시 단위 오프셋이든 정확하고 저렴하게 계산됩니다. 상태/버전/오류별 분석은 실행 상세에서 필요할 때 계산되므로 시작과 끝 경계가 모두 필요하며 기간은 최대 92일입니다(400 range-too-wide). 오류 그룹은 오류가 있는 실행만 포함하며, 각 그룹에는 최신 오류 메시지가 sample_message로 들어갑니다. 작성자의 디버그 실행은 기본적으로 제외되며, 플랫폼 상태 점검(probe)은 절대 집계되지 않습니다. 성공에는 부분 성공이 포함되고, 취소된 실행은 성공률 분모에서 제외되며, 최종 상태 실행이 없는 지표는 null입니다. amount는 호출자가 이 실행들에 지불한 데이터 요금이며, 게시자의 정산 수익이 아닙니다.
일/시간 그룹은 오름차순입니다(hour 키는 tz_offset 기준 현지 시각 YYYY-MM-DDTHH:00이며 시간대 접미사가 없음). 다른 그룹은 실행 수 내림차순입니다. data_app에 알 수 없는 App이나 다른 사람의 App을 지정하면 404를 반환합니다.
totals.callers는 기간 내 고유 호출 사용자 수로, 실행 상세에서 계산되며 기간이 제한되고 최대 92일일 때만 설정됩니다. group_by=caller는 단일 private 또는 shared App을 호출자별로 나눕니다: 작성자(caller_kind=owner)와 현재 grant 목록에 있는 사용자(grantee)는 현재 사용자 이름으로 표시되고, 나머지(이전 grantee, 공개 기간의 호출자)는 모두 하나의 other 그룹으로 합쳐집니다. 공개 App이나 여러 App은 400 caller-group-unavailable을 반환합니다: 공개 App의 호출자는 익명으로 유지되며 수만 집계됩니다.
요청
쿼리 파라미터
string
기본값:"day"
하나 또는 두 개의 차원을 쉼표로 구분해 지정:
day / hour / data_app / triggered_by / state / version / error / caller(예: day,data_app). day와 hour는 함께 쓸 수 없습니다. state / version / error / caller는 최대 92일의 제한된 기간이 필요합니다. caller는 추가로 private 또는 shared App을 정확히 하나 지정해야 합니다. 기본값은 day입니다.string[]
이 App들로 제한합니다(
<username>/<app_name>, 반복 지정 가능). 기본값: 내 모든 App.string
시작(포함).
string
끝(제외).
integer
기본값:"0"
일/시간 버킷의 시간대 오프셋(분). 중국 표준시는
480을 사용합니다. 버킷은 시간 단위이므로 30분 단위 오프셋은 시간 단위로 반올림됩니다.범위는 -720~840입니다.string
하나의 호출 채널로 제한합니다(
api / sdk / mcp / web 등).boolean
기본값:"False"
작성자의 디버그 실행을 포함할지 여부.
boolean
기본값:"False"
created_from 바로 앞의 같은 길이 기간에 대한 previous_totals도 반환합니다. 시작과 끝 경계가 모두 필요합니다.요청 예시
응답
200 성공
data로 감쌉니다. 필드:
object
필수
실제로 사용된 범위와 오프셋.
string
통화.
object
필수
기간 합계.
object
compare=true일 때 직전 같은 길이 기간의 합계.string
실제로 사용된 차원.
object[]
그룹 행. 각 행은
totals와 같은 지표에 차원 키(day / hour / namespace + app_name / channel / state / version / error_code + error_category + sample_message + last_seen_at / username + caller_kind)가 더해집니다. 사용되지 않는 키는 null입니다.오류
오류 응답은
{"error": {code, category, message, retryable}}입니다. 오류 참고.