按页查询技术资讯,支持标签筛选和按需返回正文
按原有来源顺序返回技术文章;DataTotalCount 是本页数量,不是文章库总数。include_content=false 时不返回 content 字段;可用封面缺失时 imageUrl 可能省略,tags 为空数组时表示没有可用标签。发布时间是文章资料时间,ResponseDateTime 是本次响应时间;备用结果可能较旧。不承诺全网覆盖或实时发布。 合法空页时 DataTotalCount 的 0 可能按既有序列化规则省略。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| appkey | string | 是 | 无 | 已开通本商品的 APPKEY;也可使用既有 Header 或 Bearer 鉴权,不同时要求多个载体。 |
| page | int | 否 | 1 | 页码,范围 1–10000。 |
| page_size | int | 否 | 20 | 每页数量,范围 1–50。 |
| tag | string | 否 | 无 | 可选技术标签,去除首尾空白后最多 64 个字符;不传或空白时不按标签筛选。 |
| include_content | bool | 否 | false | 是否返回文章正文;沿用 true/false 的大小写不敏感布尔表达。 |
请求示例(与默认值独立):
{
"page": 1,
"page_size": 3,
"include_content": true
}
| 字段 | 类型 | 必返 | 可为 null | 说明 |
|---|---|---|---|---|
| DataStatus.RequestParameter | string | 是 | 否 | 本次真实、可读的业务请求参数,不含凭据;Demo 与实际示例输入对应。 |
| DataStatus.StatusCode | integer | 是 | 否 | 100 成功;501 参数错误对应 HTTP 400;901 处理或依赖失败对应 HTTP 503,公共鉴权和限流规则保持。 |
| DataStatus.StatusDescription | string | 是 | 否 | 业务处理结果说明。 |
| DataStatus.ResponseDateTime | string | 是 | 否 | 响应生成时间,不代表资料公布、行情交易或净值日期。 |
| DataStatus.DataTotalCount | integer | 否 | 否 | 本页实际文章数;合法空页时 0 可能按既有序列化规则省略,不是资讯库总数。 |
| Data | array | 是 | 否 | 本页文章对象数组;来源确认的合法空页返回空数组。 |
| Data[].id | string | 是 | 否 | 文章标识,便于关联同一文章。 |
| Data[].title | string | 是 | 否 | 文章标题。 |
| Data[].summary | string | 是 | 否 | 文章摘要。 |
| Data[].publishedAt | string | 是 | 否 | 文章发布时间,UTC ISO 8601 字符串。 |
| Data[].url | string | 是 | 否 | 对应文章的 HTTPS 链接。 |
| Data[].imageUrl | string | 否 | 否 | 可用封面链接;无可用封面时该字段可能省略。 |
| Data[].tags | array | 是 | 否 | 可用技术标签;没有标签时为空数组。 |
| Data[].content | string | 否 | 否 | 仅 include_content=true 时返回;来源无正文时可能为空字符串。 |
| 业务码 | 含义 | HTTP 与处理说明 |
|---|---|---|
| 100 | 请求成功 | HTTP 200;请同时检查业务状态与返回数据。 |
| 501 | 参数错误 | HTTP 400;参数缺失、类型错误或参数冲突。 |
| 502 | 请求频率限制 | HTTP 429,沿用公共限流契约。 |
| 503 | 权益过期 | HTTP 403,沿用公共权益契约。 |
| 504 | 凭据或权限错误 | 结合 HTTP 状态区分凭据缺失、无效、无商品权限或鉴权服务不可用。 |
| 505 | 调用额度不足 | HTTP 403,沿用公共额度契约。 |
| 901 | 处理或依赖失败 | HTTP 503;包含目标处理失败、依赖失败和超时。 |
X-GuGuData-Data-Source:techblogs-fresh、techblogs-cache、techblogs-backup。本次结果来源;备用资料可能较早,不改变响应数据字段。
接口详情:https://www.gugudata.com/api/details/techblogs
OpenAPI:https://www.gugudata.com/openapi/gugudata.openapi.3.1.json