게시자 실행 목록

게시자 실행 목록

curl --request GET \
  --url https://api.example.com/v1/publisher/runs

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/publisher/runs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/publisher/runs"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/publisher/runs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "run_id": "<string>",
      "namespace": "<string>",
      "app_name": "<string>",
      "app_version": "<string>",
      "build_id": "<string>",
      "run_kind": "<string>",
      "state": {},
      "partial": true,
      "triggered_by": "<string>",
      "created_at": "<string>",
      "started_at": "<string>",
      "finished_at": "<string>",
      "duration_ms": 123,
      "records": 123,
      "amount": 123,
      "error": {
        "code": "<string>",
        "category": "<string>",
        "message": "<string>",
        "retryable": true
      }
    }
  ],
  "pagination": {
    "offset": 123,
    "limit": 123,
    "count": 123,
    "total": 123,
    "has_more": true
  },
  "currency": "<string>"
}

GET

publisher

runs

게시자 실행 목록

curl --request GET \
  --url https://api.example.com/v1/publisher/runs

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/publisher/runs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/publisher/runs"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/publisher/runs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "run_id": "<string>",
      "namespace": "<string>",
      "app_name": "<string>",
      "app_version": "<string>",
      "build_id": "<string>",
      "run_kind": "<string>",
      "state": {},
      "partial": true,
      "triggered_by": "<string>",
      "created_at": "<string>",
      "started_at": "<string>",
      "finished_at": "<string>",
      "duration_ms": 123,
      "records": 123,
      "amount": 123,
      "error": {
        "code": "<string>",
        "category": "<string>",
        "message": "<string>",
        "retryable": true
      }
    }
  ],
  "pagination": {
    "offset": 123,
    "limit": 123,
    "count": 123,
    "total": 123,
    "has_more": true
  },
  "currency": "<string>"
}

GET https://api-datahub.octoparse.com/v1/publisher/runs 인증: API 키 필요(Authorization: Bearer <API Key>). 내가 게시한 App에 대한 모든 호출(최신순). 게시자 사용량 뒤에 있는 상세 내역으로, 소유권(내가 소유한 App, Release가 0개인 App 포함), 기간 조건, 필터 값이 모두 같으므로 어떤 집계 수치에서도 그 수치에 포함된 실행까지 드릴다운할 수 있습니다. 이것은 화이트리스트 뷰이며 호출자의 실행 객체가 아닙니다: 무슨 일이 있었는지(상태, 타임스탬프, 다시 기록된 레코드, 오류 코드와 메시지, 호출자가 지불한 데이터 요금)는 알 수 있지만, 누가 호출했는지, 무엇을 보냈는지(input 없음), 무엇을 받았는지(dataset_id, 레코드, 자격 증명 ID 없음)는 절대 포함되지 않습니다. 호출자는 여전히 자신의 실행 목록에서 조회합니다. 게시자는 여기서 얻은 run_id로 상대방의 실행을 열 수 없습니다. 작성자의 디버그 실행은 기본적으로 제외되며, status는 쉼표로 구분한 여러 값을 받습니다.

요청

쿼리 파라미터

string[]

이 App들로 제한합니다. 반복 지정 가능.

string

실행 상태. 쉼표로 구분해 여러 값 지정 가능.

string

하나의 호출 채널로 제한합니다.

string

이 Release 버전에 고정된 실행으로 제한합니다.

string

오류 코드가 이 값과 같은 실행으로 제한합니다(게시자 사용량 group_by=error의 error_code).

string

기본값:"production"

production(기본값)은 프로덕션 트래픽만, test는 내 디버그 실행만, all은 둘 다.

string

시작(포함).

string

끝(제외).

integer

기본값:"0"

페이지 오프셋.범위 ≥ 0.

integer

기본값:"50"

페이지 크기.범위는 1~200입니다.

요청 예시

curl \
  -H "Authorization: Bearer $OCTOPARSE_API_KEY" \
  "https://api-datahub.octoparse.com/v1/publisher/runs?data_app=carol/reviews-query&status=FAILED&limit=50"

응답

200 성공

{
  "data": {
    "items": [
      {
        "run_id": "run_3b750088f51c",
        "namespace": "carol",
        "app_name": "probe-b",
        "app_version": "0.1.0",
        "build_id": null,
        "run_kind": "production",
        "state": "SUCCEEDED",
        "partial": false,
        "triggered_by": "api",
        "created_at": "2026-09-15T07:45:41.876601+00:00",
        "started_at": "2026-09-15T07:45:41.883082+00:00",
        "finished_at": "2026-09-15T07:45:42.326823+00:00",
        "duration_ms": 443,
        "records": 20,
        "amount": 0.02,
        "error": null
      },
      "…"
    ],
    "pagination": {
      "offset": 0,
      "limit": 2,
      "count": 2,
      "total": 2,
      "has_more": false
    },
    "currency": "CNY"
  }
}

페이로드는 data로 감쌉니다. 필드:

object[]

필수

실행 목록.

표시 fields

string

필수

실행 id.

string

게시자 사용자 이름.

string

App 이름.

string

고정된 Release 버전.

string

디버그 실행이 고정된 Build 스냅샷. 프로덕션 실행에서는 null.

string

실행 종류(production / test 등).

enum

필수

실행 상태. 값: PENDING / QUEUED / RUNNING / SUCCEEDED / PARTIALLY_SUCCEEDED / FAILED / CANCELLED / EXPIRED.

boolean

실행이 부분적으로 성공했거나 부분 출력과 함께 취소되었는지 여부.

string

호출 채널.

string

실행이 생성된 시각.

string

실행이 시작된 시각.

string

실행이 끝난 시각.

integer

실행 소요 시간(밀리초).

integer

다시 기록된 레코드 수.

number

호출자가 지불한 데이터 요금.

object

실패 시 오류 객체.

표시 fields

string

필수

안정적인 오류 코드.

string

오류 카테고리.

string

개발자용 메시지.

boolean

같은 요청을 재시도하면 성공할 수 있는지 여부.

object

페이징 정보.

표시 fields

integer

요청한 오프셋.

integer

요청한 페이지 크기.

integer

이 페이지의 항목 수.

integer

필터 적용 후 전체 수.

boolean

남은 페이지가 있는지 여부.

string

amount의 통화.

오류

HTTP	`code`	`category`	설명
401	`unauthorized`	`forbidden`	API 키 누락 또는 무효.
400	`invalid-status`	`invalid_input`	`status`에 어휘 밖 값.
400	`invalid-run-kind`	`invalid_input`	`run_kind`가 허용된 값이 아닙니다.
404	`app-not-found`	`not_found`	App이 존재하지 않거나, 이름이 변경되었거나, 현재 자격 증명으로는 보이지 않습니다(private / shared 범위 밖).

오류 응답은 {"error": {code, category, message, retryable}}입니다. 오류 참고.

클라이언트 라이브러리

Python / JavaScript SDK는 아직 이 엔드포인트를 감싸지 않습니다. REST를 직접 호출하세요.

시작하기

빠른 시작

레퍼런스

DATA HUB API

요청

쿼리 파라미터

요청 예시

응답

200 성공

오류

클라이언트 라이브러리

​요청

​쿼리 파라미터

​요청 예시

​응답

​200 성공

​오류

​클라이언트 라이브러리

요청

쿼리 파라미터

요청 예시

응답

200 성공

오류

클라이언트 라이브러리