公开接口读取指南

本文介绍如何读取公开文档中的结构化内容。调用方先读取接口说明，再判断返回内容是否完整，最后保留来源链接作为核对依据。网页提取器应该保留正文段落、列表、表格和代码块之间的关系，让读者能够直接理解示例的执行过程。

一、准备请求

示例使用只读请求获取服务的版本号。代码中的缩进属于语法的一部分，转换成文本时需要完整保留。参数名称使用行内代码 version 标记，完整参数表见接口文档。如果服务暂时无法访问，可以稍后重试，不能把错误提示解释为接口返回的业务数据。

def read_version(client):
    response = client.get("/public/version")
    if response.ok:
        return response.json()["version"]
    return None

二、核对证据

公开页面可能包含导航栏、推荐内容和订阅表单。这些内容与正文同时出现在页面中，但不应混入接口说明。正文中的相对链接需要依据当前页面地址解析，否则保存到本地后将无法定位原始资料。读取结果还应保留发布时间，便于判断文档与当前版本是否对应。

1. 确认请求对象是公开文档。
2. 保留代码缩进和段落结构。
3. 核对原文链接与发布时间。

测试结果只说明文档转换过程保留了这些结构，不代表目标服务本身的行为已经得到验证。引用页面时仍然需要检查正文是否完整，以及是否存在登录提示或访问限制。对于只有加载提示的页面，应继续寻找原始文档或其他公开来源。

危险链接示例