App-Detail

App-Detail

curl --request GET \
  --url https://api.example.com/v1/data-apps/{app_id}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/data-apps/{app_id}",
  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/data-apps/{app_id}"

	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/data-apps/{app_id}")

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

{
  "app_id": "<string>",
  "namespace": "<string>",
  "app_name": "<string>",
  "version": "<string>",
  "status": "<string>",
  "scope": "<string>",
  "accepting_runs": true,
  "input_schema": {},
  "output_schema": {},
  "execution": {},
  "knowledge": {},
  "pricing": {},
  "examples": [
    {}
  ],
  "call_examples": {}
}

GET

data-apps

{app_id}

App-Detail

curl --request GET \
  --url https://api.example.com/v1/data-apps/{app_id}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/data-apps/{app_id}",
  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/data-apps/{app_id}"

	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/data-apps/{app_id}")

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

{
  "app_id": "<string>",
  "namespace": "<string>",
  "app_name": "<string>",
  "version": "<string>",
  "status": "<string>",
  "scope": "<string>",
  "accepting_runs": true,
  "input_schema": {},
  "output_schema": {},
  "execution": {},
  "knowledge": {},
  "pricing": {},
  "examples": [
    {}
  ],
  "call_examples": {}
}

GET https://api-datahub.octoparse.com/v1/data-apps/{app_id} Authentifizierung: optional. Anonymer Zugriff funktioniert; mit API-Schlüssel freigeschaltete Filter und mehr Inhalt. In sich geschlossene, maschinenlesbare Details: Eingabevertrag und Ausgabestruktur (JSON Schema), Ausführungsmodus, Preise, Nutzungswissen, Eingabebeispiele sowie Aufrufbeispiele für MCP / REST / CLI / SDK. Standardmäßig die neueste Version; übergeben Sie version, um einen historischen Vertrag zu lesen. Sichtbarkeit = Run-Gate: public anonym lesbar; private nur Autor; shared nur Grant-Liste. Unsichtbar und fehlend liefern beide 404 ohne Existenz zu leaken.

Anfrage

Pfadparameter

string

erforderlich

App-Referenz: app_<hex> oder <namespace>/<app_name>.

Abfrageparameter

string

Historischen Vertrag nach Version lesen. Standard: neueste Version.

Beispielanfrage

curl \
  -H "Authorization: Bearer $OCTOPARSE_API_KEY" \
  "https://api-datahub.octoparse.com/v1/data-apps/carol/probe-b"

Antwort

200 Erfolg

{
  "data": {
    "app_id": "app_6dfe4e839ccf",
    "namespace": "carol",
    "app_name": "probe-b",
    "name": "Product review lookup",
    "type": "data",
    "summary": "Fetch a review list by product id",
    "capability": "data-acquisition",
    "keywords": [
      "reviews",
      "ecommerce"
    ],
    "boundary": "Public reviews only; buyer-show images are not included",
    "version": "0.1.0",
    "published_at": "2026-09-15T07:45:38.633930+00:00",
    "status": "published",
    "scope": "public",
    "accepting_runs": true,
    "source_locale": "en-US",
    "input_schema": {
      "type": "object",
      "properties": {
        "product": {
          "type": "string",
          "description": "Product id"
        }
      },
      "required": [
        "product"
      ],
      "additionalProperties": false
    },
    "output_schema": {
      "id_field": "review_id",
      "record": {
        "type": "object",
        "properties": {
          "review_id": {
            "type": "string"
          },
          "content": {
            "type": "string"
          },
          "rating": {
            "type": "integer"
          }
        }
      }
    },
    "execution": {
      "mode": "sync",
      "timeout_seconds": 60,
      "cancel_notify": false,
      "recovers_partial_on_cancel": false
    },
    "knowledge": {
      "when_to_use": [
        "When you need every public review for a product"
      ],
      "when_not_to_use": [
        "When you need buyer images or video"
      ],
      "failure_handling": [
        "Delisted products return an empty result instead of an error"
      ]
    },
    "pricing": {
      "events": [
        {
          "event": "record",
          "label": "One record",
          "unit_price": 0.001,
          "qty_from": "",
          "unit_size": null
        }
      ]
    },
    "examples": [
      {
        "name": "Basic query",
        "input": {
          "product": "p-9001"
        }
      }
    ],
    "call_examples": {
      "mcp": "…",
      "api": "curl -X POST 'https://api-datahub.octoparse.com/v1/data-apps/carol/probe-b/runs' …",
      "cli": "op run carol/probe-b --input '{\"product\": \"p-9001\"}'",
      "sdk": "from octoparse_client import Client …"
    }
  }
}

Die Antwort ist ein freiformiges Objekt (nur additiv, wenn die Manifest-Spec wächst). Die unten gelisteten Felder sind die stabilen. Payload ist in data gewrappt. Felder:

string

Stabile App-ID.

string

Publisher-Benutzername.

string

App-Name.

string

Version, deren Vertrag diese Antwort repräsentiert.

string

Lifecycle-Status.

string

Sichtbarkeits-Scope.

boolean

Ob die App neue Runs annimmt.

object

Eingabevertrag als Standard-JSON-Schema. Der Request-Body zum Starten eines Runs muss ihn erfüllen.

object

Output-Struktur. id_field ist der Record-Primary-Key; record ist das Per-Record-JSON-Schema.

object

Ausführungsprofil. mode ist sync / async; timeout_seconds ist die Per-Run-Obergrenze.

object

Usage-Knowledge: wann nutzen, wann nicht, und Failure-Handling.

object

Preistabelle.

object[]

Eingabebeispiele. Nutzen Sie diese bevorzugt als Ausgangspunkt für Request-Bodys.

object

Gerenderte Aufrufbeispiele für vier Oberflächen (mcp / api / cli / sdk).

Fehler

HTTP	`code`	`category`	Beschreibung
401	`unauthorized`	`forbidden`	Fehlender oder ungültiger API-Schlüssel.
404	`app-not-found`	`not_found`	App existiert nicht, wurde umbenannt oder ist für die aktuelle Credential unsichtbar (private / außerhalb Share-Scope).

Fehlerantworten nutzen {"error": {code, category, message, retryable}}. Siehe Fehler.

Client-Bibliotheken

detail = client.get_app("carol/probe-b")      # or app_id
print(detail["input_schema"], detail["pricing"])

const detail = await client.getApp("carol/probe-b");   // or app_id
console.log(detail.input_schema, detail.pricing);

ERSTE SCHRITTE

SCHNELLSTART

REFERENZ

DATA HUB API

Anfrage

Pfadparameter

Abfrageparameter

Beispielanfrage

Antwort

200 Erfolg

Fehler

Client-Bibliotheken

​Anfrage

​Pfadparameter

​Abfrageparameter

​Beispielanfrage

​Antwort

​200 Erfolg

​Fehler

​Client-Bibliotheken

Anfrage

Pfadparameter

Abfrageparameter

Beispielanfrage

Antwort

200 Erfolg

Fehler

Client-Bibliotheken