App 详情
curl --request GET \
--url https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}import requests
url = "https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'GET'};
fetch('https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-datahub.bazhuayu.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))
}HttpResponse<String> response = Unirest.get("https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-datahub.bazhuayu.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;
}require 'uri'
require 'net/http'
url = URI("https://api-datahub.bazhuayu.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_bodyusing RestSharp;
var options = new RestClientOptions("https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}");
var client = new RestClient(options);
var request = new RestRequest("");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
val client = OkHttpClient()
val request = Request.Builder()
.url("https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}")
.get()
.build()
val response = client.newCall(request).execute()false{
"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": {}
}发现 Data App
App 详情
读取一个 Data App 的完整机读说明:输入输出契约、执行剖面、价格、示例与调用示例。
GET
/
v1
/
data-apps
/
{app_id}
App 详情
curl --request GET \
--url https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}import requests
url = "https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'GET'};
fetch('https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-datahub.bazhuayu.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))
}HttpResponse<String> response = Unirest.get("https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-datahub.bazhuayu.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;
}require 'uri'
require 'net/http'
url = URI("https://api-datahub.bazhuayu.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_bodyusing RestSharp;
var options = new RestClientOptions("https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}");
var client = new RestClient(options);
var request = new RestRequest("");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
val client = OkHttpClient()
val request = Request.Builder()
.url("https://api-datahub.bazhuayu.com/v1/data-apps/{app_id}")
.get()
.build()
val response = client.newCall(request).execute()false{
"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.bazhuayu.com/v1/data-apps/{app_id}
version 可读取历史版本的契约。
可见性与运行门相同:公开 App 匿名可读;私有 App 仅作者可读;分享 App 仅授权名单内可读。不可见与不存在都返回 404,不暴露存在性。
请求
路径参数
string
必填
App 引用,
app_<hex> 或 <namespace>/<app_name>。查询参数
string
指定版本号读取历史契约,默认最新版本。
示例请求
curl \
-H "Authorization: Bearer $BAZHUAYU_API_KEY" \
"https://api-datahub.bazhuayu.com/v1/data-apps/carol/probe-b"
响应
200 成功
{
"data": {
"app_id": "app_6dfe4e839ccf",
"namespace": "carol",
"app_name": "probe-b",
"name": "商品评论查询",
"type": "data",
"summary": "按商品编号获取评论列表",
"capability": "data-acquisition",
"keywords": [
"reviews",
"ecommerce"
],
"boundary": "只覆盖公开评论,不含买家秀图片",
"version": "0.1.0",
"published_at": "2026-09-15T07:45:38.633930+00:00",
"status": "published",
"scope": "public",
"accepting_runs": true,
"source_locale": "zh-CN",
"input_schema": {
"type": "object",
"properties": {
"product": {
"type": "string",
"description": "商品编号"
}
},
"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_not_to_use": [
"需要买家图片或视频时"
],
"failure_handling": [
"商品下架时返回空结果而非错误"
]
},
"pricing": {
"events": [
{
"event": "record",
"label": "获取一条",
"unit_price": 0.001,
"qty_from": "",
"unit_size": null
}
]
},
"examples": [
{
"name": "基础查询",
"input": {
"product": "p-9001"
}
}
],
"call_examples": {
"mcp": "…",
"api": "curl -X POST 'https://api-datahub.bazhuayu.com/v1/data-apps/carol/probe-b/runs' …",
"cli": "op run carol/probe-b --input '{\"product\": \"p-9001\"}'",
"sdk": "from bazhuayu_client import Client …"
}
}
}
data 字段中,其内容如下。
string
App 的稳定标识。
string
发布者用户名。
string
应用名。
string
本次返回的契约对应的版本号。
string
生命周期状态。
string
可见范围。
boolean
是否接受新运行。
object
输入契约,标准 JSON Schema;发起运行的请求体必须满足它。
object
输出结构。
id_field 是记录的主键字段,record 是单条记录的 JSON Schema。object
执行剖面。
mode 为 sync / async,timeout_seconds 为单次运行上限。object
使用知识:适用场景、不适用场景、失败处理方式。
object
价格表。
object[]
输入示例,建议以此为起点构造请求体。
object
渲染好的四种调用示例(
mcp / api / cli / sdk)。错误
| HTTP | code | category | 说明 |
|---|---|---|---|
| 401 | unauthorized | forbidden | 缺少或无效的 API Key。 |
| 404 | app-not-found | not_found | App 不存在、已改名,或对当前凭证不可见(私有 / 分享范围之外)。 |
{"error": {code, category, message, retryable}},见错误。
客户端库
detail = client.get_app("carol/probe-b") # 或 app_id
print(detail["input_schema"], detail["pricing"])
const detail = await client.getApp("carol/probe-b"); // 或 app_id
console.log(detail.input_schema, detail.pricing);
