manifest 规范（JSON Schema）

curl --request GET \
  --url https://api-datahub.bazhuayu.com/v1/data-apps/manifest-schema

const options = {method: 'GET'};

fetch('https://api-datahub.bazhuayu.com/v1/data-apps/manifest-schema', 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/manifest-schema', 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/manifest-schema"

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

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

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

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-datahub.bazhuayu.com/v1/data-apps/manifest-schema",
  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/manifest-schema")

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

using RestSharp;


var options = new RestClientOptions("https://api-datahub.bazhuayu.com/v1/data-apps/manifest-schema");
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/manifest-schema")
  .get()
  .build()

val response = client.newCall(request).execute()

GET

data-apps

manifest-schema

manifest 规范（JSON Schema）

curl --request GET \
  --url https://api-datahub.bazhuayu.com/v1/data-apps/manifest-schema

const options = {method: 'GET'};

fetch('https://api-datahub.bazhuayu.com/v1/data-apps/manifest-schema', 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/manifest-schema', 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/manifest-schema"

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

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

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

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-datahub.bazhuayu.com/v1/data-apps/manifest-schema",
  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/manifest-schema")

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

using RestSharp;


var options = new RestClientOptions("https://api-datahub.bazhuayu.com/v1/data-apps/manifest-schema");
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/manifest-schema")
  .get()
  .build()

val response = client.newCall(request).execute()

端点

GET https://api-datahub.bazhuayu.com/v1/data-apps/manifest-schema

认证：无需认证，可匿名调用。 manifest 规范（spec 0.2）的机读形式，JSON Schema 2020-12。返回的就是平台校验时使用的那一份，规范即实现，文档里不再另抄字段表。供编辑器、编码助手和第三方校验器使用。对错判定唯一以校验 manifest 的返回为准。

请求

示例请求

curl \
  "https://api-datahub.bazhuayu.com/v1/data-apps/manifest-schema"

响应

200 成功

{
  "data": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "urn:datahub:spec:manifest:0.2",
    "title": "Data App Manifest — spec 0.2",
    "description": "Machine-readable spec for the Data App manifest (structure and field-level const…",
    "type": "object",
    "additionalProperties": false,
    "required": [
      "spec_version",
      "…"
    ],
    "properties": {
      "spec_version": {
        "const": "0.2"
      },
      "status": {
        "enum": [
          "draft",
          "…"
        ],
        "default": "published"
      },
      "identity": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "…"
        ],
        "properties": {
          "app_name": {
            "type": "string",
            "pattern": "^[a-z0-9][a-z0-9-]{1,63}$",
            "description": "Technical name slug. Consumed only at creation: required for one-step publish (P…"
          },
          "name": {
            "type": "string",
            "minLength": 1
          },
          "summary": {
            "type": "string",
            "minLength": 1
          },
          "type": {
            "enum": [
              "data",
              "…"
            ],
            "default": "data"
          },
          "scope": {
            "enum": [
              "public",
              "…"
            ],
            "default": "public"
          },
          "version": {
            "type": "string",
            "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
            "default": "0.1.0"
          }
        }
      },
      "discovery": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "capability": {
            "enum": [
              "data-acquisition",
              "…"
            ],
            "default": "data-acquisition"
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "boundary": {
            "type": "string"
          }
        }
      },
      "input": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "schema"
        ],
        "properties": {
          "schema": {
            "$ref": "#/$defs/io_schema"
          }
        }
      },
      "output": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id_field",
          "…"
        ],
        "properties": {
          "id_field": {
            "type": "string",
            "pattern": "^[a-z][a-zA-Z0-9_]{0,63}$"
          },
          "schema": {
            "$ref": "#/$defs/io_schema"
          }
        }
      },
      "execution": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "mode",
          "…"
        ],
        "properties": {
          "mode": {
            "enum": [
              "sync",
              "…"
            ]
          },
          "timeout_seconds": {
            "type": "number",
            "exclusiveMinimum": 0
          }
        }
      },
      "knowledge": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "when_to_use": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "when_not_to_use": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "failure_handling": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "pricing": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "events"
        ],
        "properties": {
          "events": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "event",
                "…"
              ],
              "properties": {
                "event": {
                  "$comment": "Built-in events: start (one task submitted, bills 1 at claim) and record (one re…",
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_]{0,31}$"
                },
                "label": {
                  "type": "string"
                },
                "unit_price": {
                  "type": "number",
                  "minimum": 0
                },
                "qty_from": {
                  "$comment": "Quantity rule for custom events: points to a number/integer field in output.sche…",
                  "type": "string",
                  "pattern": "^[a-z][a-zA-Z0-9_]{0,63}$"
                },
                "unit_size": {
                  "$comment": "Billing unit: charges per unit_size units of measure; qty converts to billing un…",
                  "type": "integer",
                  "minimum": 1
                }
              }
            }
          }
        }
      },
      "runtime": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "kind"
        ],
        "properties": {
          "kind": {
            "enum": [
              "api",
              "…"
            ]
          },
          "env": {
            "$comment": "Environment injection: alias -> platform-side environment entry name. Values are…",
            "type": "object",
            "propertyNames": {
              "pattern": "^[a-z][a-z0-9_]{0,31}$"
            },
            "additionalProperties": {
              "type": "string",
              "pattern": "^[A-Z][A-Z0-9_]{0,63}$"
            }
          },
          "api": {
            "$ref": "#/$defs/api_runtime"
          },
          "code": {
            "$ref": "#/$defs/code_runtime"
          }
        },
        "allOf": [
          {
            "$comment": "kind decides which block is required; the other block must be absent (leaving it…",
            "if": {
              "properties": {
                "kind": {
                  "const": "api"
                }
              },
              "required": [
                "kind"
              ]
            },
            "then": {
              "required": [
                "api"
              ],
              "not": {
                "required": [
                  "code"
                ]
              }
            }
          },
          "…"
        ]
      },
      "examples": {
        "type": "array",
        "items": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "id",
            "…"
          ],
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]{0,31}$"
            },
            "goal": {
              "type": "string"
            },
            "input": {
              "type": "object"
            },
            "use_as_test": {
              "type": "boolean",
              "default": true
            }
          }
        }
      },
      "readme": {
        "type": "string"
      },
      "extensions": {
        "type": "object",
        "propertyNames": {
          "pattern": "^[a-z][a-z0-9_-]{0,31}$"
        },
        "additionalProperties": {
          "type": "object"
        }
      }
    },
    "allOf": [
      {
        "$comment": "When a submit stage exists (async interface), execution.mode must be async",
        "if": {
          "required": [
            "runtime"
          ],
          "properties": {
            "runtime": {
              "required": [
                "api"
              ],
              "properties": {
                "api": {
                  "required": [
                    "submit"
                  ]
                }
              }
            }
          }
        },
        "then": {
          "properties": {
            "execution": {
              "properties": {
                "mode": {
                  "const": "async"
                }
              }
            }
          }
        }
      }
    ],
    "$defs": {
      "io_schema": {
        "$comment": "Restricted subset of standard JSON Schema: keyword allowlist + platform extensio…",
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type",
          "…"
        ],
        "properties": {
          "type": {
            "const": "object"
          },
          "properties": {
            "type": "object",
            "minProperties": 1,
            "propertyNames": {
              "pattern": "^[a-z][a-zA-Z0-9_]{0,63}$"
            },
            "additionalProperties": {
              "$ref": "#/$defs/io_field"
            }
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "uniqueItems": true
          }
        }
      },
      "io_field": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "enum": [
              "string",
              "…"
            ]
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "default": true,
          "enum": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50
          },
          "enum_titles": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 50
          },
          "minimum": {
            "type": "number"
          },
          "maximum": {
            "type": "number"
          },
          "pattern": {
            "type": "string"
          },
          "items": {
            "$ref": "#/$defs/io_field"
          },
          "minItems": {
            "type": "integer",
            "minimum": 0
          },
          "maxItems": {
            "type": "integer",
            "minimum": 1
          },
          "properties": {
            "type": "object",
            "propertyNames": {
              "pattern": "^[a-z][a-zA-Z0-9_]{0,63}$"
            },
            "additionalProperties": {
              "$ref": "#/$defs/io_field"
            }
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "uniqueItems": true
          },
          "prefill": true,
          "sensitive": {
            "type": "boolean"
          }
        },
        "allOf": [
          {
            "$comment": "array must declare items (including items.type)",
            "if": {
              "properties": {
                "type": {
                  "const": "array"
                }
              },
              "required": [
                "type"
              ]
            },
            "then": {
              "required": [
                "items"
              ]
            }
          }
        ]
      },
      "request": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "method",
          "…"
        ],
        "properties": {
          "method": {
            "enum": [
              "GET",
              "…"
            ]
          },
          "url": {
            "type": "string",
            "minLength": 1
          },
          "query": {
            "type": "object",
            "additionalProperties": {
              "type": [
                "string",
                "…"
              ]
            }
          },
          "headers": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "body": {
            "type": "object"
          },
          "unset_inputs": {
            "enum": [
              "omit",
              "…"
            ]
          }
        }
      },
      "submit_stage": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "request",
          "…"
        ],
        "properties": {
          "request": {
            "$ref": "#/$defs/request"
          },
          "response": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "task_id_path"
            ],
            "properties": {
              "task_id_path": {
                "type": "string",
                "minLength": 1
              }
            }
          }
        }
      },
      "status_stage": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "request",
          "…"
        ],
        "properties": {
          "request": {
            "$ref": "#/$defs/request"
          },
          "response": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "status_path"
            ],
            "properties": {
              "status_path": {
                "type": "string",
                "minLength": 1
              },
              "done_path": {
                "type": "string",
                "minLength": 1
              },
              "total_path": {
                "type": "string",
                "minLength": 1
              }
            }
          },
          "done_when": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": [
                "string",
                "…"
              ]
            }
          },
          "fail_when": {
            "type": "array",
            "items": {
              "type": [
                "string",
                "…"
              ]
            }
          },
          "every_seconds": {
            "type": "number",
            "exclusiveMinimum": 0,
            "default": 10
          },
          "timeout_seconds": {
            "type": "number",
            "exclusiveMinimum": 0,
            "default": 600
          }
        }
      },
      "cancel_stage": {
        "$comment": "Upstream cancel notification (async form only): sent best-effort once when the u…",
        "type": "object",
        "additionalProperties": false,
        "required": [
          "request"
        ],
        "properties": {
          "request": {
            "$ref": "#/$defs/request"
          },
          "response": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "done_path": {
                "type": "string",
                "minLength": 1
              },
              "total_path": {
                "type": "string",
                "minLength": 1
              }
            }
          }
        }
      },
      "fetch_stage": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "request"
        ],
        "properties": {
          "request": {
            "$ref": "#/$defs/request"
          },
          "response": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "records_path": {
                "type": "string"
              },
              "field_map": {
                "type": "object",
                "propertyNames": {
                  "pattern": "^[a-z][a-zA-Z0-9_]{0,63}(\\.[a-z][a-zA-Z0-9_]{0,63})*$"
                },
                "additionalProperties": {
                  "type": "string",
                  "minLength": 1
                }
              },
              "dedup_by": {
                "type": "string",
                "minLength": 1
              }
            }
          },
          "pagination": {
            "$ref": "#/$defs/pagination"
          }
        }
      },
      "pagination": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "enum": [
              "page",
              "…"
            ]
          },
          "start_page": {
            "type": "integer",
            "default": 1
          },
          "page_size": {
            "type": "integer",
            "minimum": 1
          },
          "cursor_path": {
            "type": "string",
            "minLength": 1
          },
          "stop_when_empty": {
            "type": "boolean",
            "default": true
          },
          "max_pages": {
            "type": "integer",
            "minimum": 1,
            "default": 100
          }
        },
        "allOf": [
          {
            "if": {
              "properties": {
                "mode": {
                  "const": "cursor"
                }
              },
              "required": [
                "mode"
              ]
            },
            "then": {
              "required": [
                "cursor_path"
              ]
            }
          },
          "…"
        ]
      },
      "auth": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type",
          "…"
        ],
        "properties": {
          "type": {
            "enum": [
              "bearer",
              "…"
            ]
          },
          "in": {
            "enum": [
              "header",
              "…"
            ]
          },
          "name": {
            "type": "string",
            "minLength": 1
          },
          "secret": {
            "$comment": "References an alias in runtime.env (the secret value is delivered by the platfor…",
            "type": "string",
            "pattern": "^[a-z][a-z0-9_]{0,31}$"
          }
        },
        "allOf": [
          {
            "if": {
              "properties": {
                "type": {
                  "const": "api_key"
                }
              },
              "required": [
                "type"
              ]
            },
            "then": {
              "required": [
                "in",
                "…"
              ]
            }
          }
        ]
      },
      "api_runtime": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "fetch"
        ],
        "properties": {
          "request_timeout_seconds": {
            "type": "number",
            "exclusiveMinimum": 0,
            "default": 30
          },
          "auth": {
            "$ref": "#/$defs/auth"
          },
          "response_code": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "path",
              "…"
            ],
            "properties": {
              "path": {
                "type": "string",
                "minLength": 1
              },
              "ok_codes": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "type": [
                    "integer",
                    "…"
                  ]
                }
              },
              "message_path": {
                "type": "string"
              }
            }
          },
          "submit": {
            "$ref": "#/$defs/submit_stage"
          },
          "status": {
            "$ref": "#/$defs/status_stage"
          },
          "cancel": {
            "$ref": "#/$defs/cancel_stage"
          },
          "fetch": {
            "$ref": "#/$defs/fetch_stage"
          },
          "fetch_after_cancel": {
            "type": "boolean",
            "default": false
          }
        },
        "dependentRequired": {
          "submit": [
            "status"
          ],
          "status": [
            "submit"
          ],
          "cancel": [
            "submit"
          ]
        }
      },
      "code_runtime": {
        "$comment": "code kind will be finalized with the per-run container design; 0.2 keeps a minim…",
        "type": "object",
        "additionalProperties": false,
        "required": [
          "entrypoint"
        ],
        "properties": {
          "entrypoint": {
            "type": "string",
            "minLength": 1
          },
          "seed_dataset": {
            "type": "string"
          }
        }
      }
    }
  }
}

响应的 data 就是 JSON Schema 文档本身，上面只展示了开头部分。

客户端库

Python 与 JavaScript SDK 暂未封装此端点，请直接调用 REST。

概述

快速入门

MCP 能力参考

DataHub API

manifest 规范（JSON Schema）

端点

请求

示例请求

响应

200 成功

客户端库

​端点

​请求

​示例请求

​响应

​200 成功

​客户端库

端点

请求

示例请求

响应

200 成功

客户端库