icon

招中标附件列表

tender-filesPOST
POSThttps://v1.apizero.cn/api/tender-files
获取 API Key工作台购买 / 调试

概述

用 projectId（也可用 id）+ publishTime 取附件。链接可能过期，请及时转存。 怎么用： 1）控制台复制 API Key； 2）POST https://v1.apizero.cn/api/tender-files ，JSON 传参； 3）请求头写 Authorization: Bearer 你的Key。 成功时 data 保留业务字段，并多 fetched_at、api。品牌与调用地址为极数本源。

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/tender-files/raw.md
打开 Markdown

鉴权

必须带 API Key。无匿名、无登录免费、无会员日免、无试用次数。按 0.085 元/次计费。套餐按各档标价，不随按次价变动。

获取 API Key

请求头

Authorizationstring必填

必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

取附件列表

POSTJSON / FORM / QUERY·APPLICATION/JSON

用 projectId（也可用 id）+ publishTime 取附件。链接可能过期。必须带 API Key。成功时 data 保留全部业务字段，并多 fetched_at、api。

https://v1.apizero.cn/api/tender-files?projectId=332064410&publishTime=2026-06-08+14%3A32%3A50

projectIdint必填

项目 ID（也可用 id）

例332064410

publishTimestring必填

发布时间

例2026-06-08 14:32:50

{
  "projectId": "332064410",
  "publishTime": "2026-06-08 14:32:50"
}

返回结果

codeinteger

接口响应状态码

msgstring

解析响应信息

subCodestring

业务侧 code

subMsgstring

业务侧 msg

dataarray

项目附件列表（数组形式，无附件时返回空数组）

projectFileIDinteger

项目信息附件ID

projectIDstring

项目ID

namestring

附件名称（可能含省略号，完整名称需结合实际场景展示）

urlstring

附件下载地址（可直接跳转下载）

proviceCodestring

项目归属地省代码（修正原文档类型错误，实际为地区编码字符串）

cityCodestring

项目归属地市代码

suffixstring

文件后缀（如docx、pdf、jpg等，用于识别文件类型）

sizenumber

附件大小（单位：KB），null表示未获取到大小信息

publishTimestring

项目发布时间（附件关联的项目发布时间）格式 yyyy-MM-dd HH:mm:ss

statestring

附件处理状态： 0=未下载，1=下载正常，2=下载失败， 3=附件太大（超过20M不下载），4=文件已损坏，5=url已失效

createTimestring

附件创建时间 格式 yyyy-MM-dd HH:mm:ss

fetched_atstring

本次查询时间

apistring

本接口 id

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "data": [
      {
        "projectFileID": 183550184,
        "projectID": "332064410",
        "name": "c2211df44339911ae669...",
        "url": "https://cos.woyaobid.com/ztb-collectfiles/2026/06/08/c2211df44339911ae669-183550184.pdf",
        "proviceCode": "230000",
        "cityCode": "230800",
        "suffix": "pdf",
        "size": 199.95,
        "publishTime": "2026-06-08 14:32:50",
        "state": "1",
        "createTime": "2026-06-08 17:41:43"
      }
    ],
    "msg": "ok",
    "count": 0,
    "returnValue": null,
    "returnvalue": null,
    "subCode": "0000000000",
    "subMsg": "成功",
    "code": 200,
    "fetched_at": "2026-09-19T22:20:00+08:00",
    "api": "tender-files"
  },
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/api/tender-files" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "projectId": "332064410",
  "publishTime": "2026-06-08 14:32:50"
}'

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
按次付费 · 点数包 · 月套餐
QPS 限制
QPS 2
登录免费额度
无
匿名每日额度
无
黄金会员
本档不提供 VIP 额度 · QPS 10
钻石会员
本档不提供 VIP 额度 · QPS 30
企业会员
本档不提供 VIP 额度 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • 1.0.02026-09-19

    上架，必须 Key，无免费额度，按次 0.08 元；可购月卡 / 年卡

免责声明

返回内容以当时查询结果为准，仅供开发与信息检索。附件链接可能过期。品牌与调用地址为极数本源。

招中标附件列表 接入文档｜极数本源