[DEMO] 语义化获取站点 JSON 结构内容

固定演示接口：GET /websitetools/url2json/demo，无需 AppKey。返回五字段成功 DataStatus 和有效 JSON Data。正式接口另需 url、prompt 和授权凭据。

当前接口契约

公开 Demo 用于查看调用方式和响应结构，返回范围以示例参数为准。

正常响应

HTTP 200，application/json。

字段	类型	说明
DataStatus	object
DataStatus.RequestParameter	string
DataStatus.StatusCode	integer
DataStatus.StatusDescription	string
DataStatus.ResponseDateTime	string
DataStatus.DataTotalCount	integer
Data	见响应定义	按提取指令返回有效 JSON；0 和 false 是有效值，无有效内容时失败。

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
901	提取服务暂不可用、超时或取消	HTTP 503

常见问题

如何让不同网页返回一致的字段？

在 prompt 中写清要提取的字段名、类型和输出层级。例如要求返回包含 title 和 publish_date 的 JSON 对象，并明确网页缺少日期时使用空字符串。请用接入侧的字段校验确认每次输出。

如何提交网页地址和提取指令？

用 POST 提交可访问的 HTTP 或 HTTPS 网页地址 url 和非空 prompt。请求正文支持 JSON 或表单，网页地址中请勿携带用户名或密码。

返回的数据可以是列表或单个数值吗？

可以。Data 支持 JSON 对象、数组、字符串、数字和布尔值。按业务约定检查 Data 的类型，0 和 false 都是有效结果。

Demo 可以提交自己的网页吗？

Demo 无需 AppKey，提供公开网页及提取指令的样例。要提取指定网页，请向正式接口提交自己的 url 和 prompt。

返回响应

🟢200成功

application/json

请求成功。

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "url=https://www.gugudata.com/contact&prompt=只提取该网页的站点名称与技术支持邮箱。返回 JSON 对象，字段为 site_name 和 support_email；不要添加网页没有的信息。",
    "StatusCode": 100,
    "StatusDescription": "请求成功",
    "ResponseDateTime": "2026-10-26 19:20:50.844",
    "DataTotalCount": 1
  },
  "Data": {
    "site_name": "咕咕数据",
    "support_email": "support@gugudata.com"
  }
}

🔴503提取服务暂不可用、超时或取消

[DEMO] 语义化获取站点 JSON 结构内容

当前接口契约

正常响应

业务状态说明

常见问题

如何让不同网页返回一致的字段？

如何提交网页地址和提取指令？

返回的数据可以是列表或单个数值吗？

Demo 可以提交自己的网页吗？

请求参数

请求示例代码

返回响应

[DEMO] 语义化获取站点 JSON 结构内容

当前接口契约#

正常响应#

业务状态说明#

常见问题#

如何让不同网页返回一致的字段？#

如何提交网页地址和提取指令？#

返回的数据可以是列表或单个数值吗？#

Demo 可以提交自己的网页吗？#

请求参数

请求示例代码

返回响应

当前接口契约

正常响应

业务状态说明

常见问题

如何让不同网页返回一致的字段？

如何提交网页地址和提取指令？

返回的数据可以是列表或单个数值吗？

Demo 可以提交自己的网页吗？