[DEMO] 文章正文

文章链接正文与发布时间提取

GET /news/fetchcontent/demo

业务说明

根据文章链接提取标题、正文和发布时间；

支持纯文本正文和保留 HTML 标签两种格式；

可按需返回原始 HTML 内容；

适合资讯聚合、内容归档和素材整理；

此公开操作无需 AppKey。

返回契约

HTTP 200：业务码 100 成功。
application/json

{
  "type": "object",
  "required": [
    "DataStatus",
    "Data"
  ],
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，此接口返回 1"
        }
      }
    },
    "Data": {
      "type": "object",
      "required": [
        "Url",
        "Title",
        "Content",
        "HTMLSourceContent",
        "PublishDate"
      ],
      "properties": {
        "Url": {
          "type": "string",
          "description": "文章 Url"
        },
        "Title": {
          "type": "string",
          "description": "文章标题"
        },
        "Content": {
          "type": "string",
          "description": "智能分析出的文章正文部分（包含 HTML 标签时，标签为 Unicode 编码）"
        },
        "HTMLSourceContent": {
          "type": "string",
          "description": "文章的原始 HTML 内容（HTML 标签为 Unicode 编码）"
        },
        "PublishDate": {
          "type": "string",
          "description": "文章发表时间"
        }
      },
      "description": "文章结果对象。"
    }
  }
}

HTTP 400：业务码 501：参数缺失、非法、重复或冲突。
application/json

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，此接口返回 1"
        }
      }
    },
    "Data": {
      "type": "null",
      "description": "文章结果对象。"
    }
  }
}

HTTP 503：业务码 901：处理、依赖失败或超时。
application/json

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，此接口返回 1"
        }
      }
    },
    "Data": {
      "type": "null",
      "description": "文章结果对象。"
    }
  }
}

业务状态与 HTTP 状态

业务码	含义	说明
100	成功	HTTP 200；仍应检查业务状态。
501	参数错误	HTTP 400
901	依赖失败	HTTP 503

接口详情：https://www.gugudata.com/api/details/fetchcontent
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

返回响应

🟢200成功

application/json

业务码 100 成功。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"url=https://cdn.gugudata.com/demo/fetchcontentimages/v1/article-e65ee1f448ca5233.html\u0026contentwithhtml=false\u0026htmlsourcecontent=false","StatusCode":100,"StatusDescription":"请求成功。","ResponseDateTime":"2026-11-02 15:26:32.785","DataTotalCount":1},"Data":{"Url":"https://cdn.gugudata.com/demo/fetchcontentimages/v1/article-e65ee1f448ca5233.html","Title":"文章正文图片整理示例","Content":"文章正文图片整理示例\n文章整理工作需要将文字与插图对应起来。编辑收到材料后，先阅读正文，确认每张图表达的内容，再决定是否保留。这篇演示文章使用项目自行制作的两张说明图，分别放在正文中不同的位置。图片不是页面导航、站点标志或联系方式，也不是根据文章标题推测出来的内容。核对素材时，应查看真实图片与附近段落的关系。\n第一张说明图用于展示材料整理中的基本步骤。读者可以先列出文章涉及的主题，再将需要保留的图片放入素材清单。清单里的地址用于定位图片，图片标签则方便核对说明文字等属性。素材的使用还需要确认来源和使用权限。能够通过链接访问某张图片，不代表它可以直接用于任何公开文章。\n\n文件大小与图片分辨率是两个不同的筛选条件。前者关注图片文件实际包含的字节数量，后者关注宽度和高度。压缩方式不同的两张图片，即使分辨率相同，文件大小也可能不同。准备发布素材时，需要根据展示位置分别考虑这些条件，不能将较大的文件直接等同于更适合阅读的图片。\n第二张说明图放在文章后半部分，用来说明复核环节。编辑完成初步整理后，可以将图片地址和正文段落交给另一位同事检查。检查内容包括图片是否属于正文、是否重复、尺寸是否满足展示需求，以及说明文字是否与图片内容相符。对于临时无法访问的图片，应记录核对状态并稍后复查。\n\n正文中重复引用同一张图片时，素材清单通常只需要保留一个地址。保留首次出现的顺序，可以帮助审阅者沿着文章阅读顺序查找素材。图片地址有时使用相对路径，因此核对时还要考虑文章所在页面的位置。本文的图片都由项目持有，并保留对应源文件，以便在演示结果与页面之间进行核验。\n整理后的结果可以用于文章归档和人工审核。归档时保存图片地址集合，能够帮助后续编辑查看原文使用了哪些素材；人工审核时则结合正文、标签和实际图片作出判断。这些信息只是整理材料，不替代编辑的最终决定。页面更新后，图片内容可能变化，使用时应同时确认采样时间与当前来源状态。\n材料交接时，建议把原文地址与对应图片清单一起提供。审阅者可以对照上下文查看图像内容，确认图表、说明文字与段落描述是否一致。即使图片属于同一主题，也需要根据原文中的实际位置作出判断。明确记录修改时间和素材来源，有助于在后续修订中找到需要更新的内容。\n如果文章同时用于桌面和移动页面，图片的展示宽度通常需要分别检查。较宽的图表可能在窄屏上难以阅读，较小的插图放大后也可能模糊。因此，尺寸筛选只是初步整理步骤，不能代替最终页面中的阅读体验检查。编辑应在素材整理完成后，再查看实际页面效果。\n对于暂时无法下载的图片，应避免凭空补充文件大小和尺寸。来源地址可能已经失效，也可能受到访问限制。核实这些情况时，可以先处理已经能够确认的材料，再记录剩余图片的状态。无法核实的数据与确认不满足筛选条件的图片，应分别理解和处理。\n网页原始内容可以帮助说明图片最初出现的位置。保存这些内容时，需要注意网页中也可能包含导航、广告和其他与正文无关的部分。本文只用于演示正文素材整理，不代表所有网页都能够用相同方式识别。实际使用结果时，应结合来源页面进行检查。\n文章修改可能同时影响文字和插图。删除某段文字后，原先配套的图片也需要复核；替换一张图后，附近说明文字可能需要调整。将图片清单作为整理材料，有助于发现这些对应关系，但是否发布、替换或删除，仍由编辑根据文章用途作出决定。\n本演示文章和两张插图均由项目持有，供公开样例核验使用。读者可以查看相同输入页面，逐一对照返回的图片地址和完整标签。演示数据记录了生成时间及来源，以便区分固定样例与网页后续变化。示例说明了素材整理过程，不承诺自动完成内容审核。","HTMLSourceContent":"","PublishDate":""}}

🟠400业务码 501：参数缺失、非法、重复或冲突。

🔴503业务码 901：处理、依赖失败或超时。

业务说明#

返回契约#

业务状态与 HTTP 状态#

请求参数

请求示例代码

返回响应

业务说明

返回契约

业务状态与 HTTP 状态