文件下载

文档 v1.0.67 · 发布快照 1.0.78下载 meoz Skill最新文档

先核对文件类型、时间范围和权限,再按响应契约保存文件或使用返回的下载地址。

正式接口 · meoz 接口目录

按年份领取竞价分笔 Parquet 日包。仅有效专业版和旗舰版可用:专业版为最近365个自然日(含今天)内的已发布日包,旗舰版为所选年份全部已发布日包;每年返回一个分享,目录按日期排列。覆盖以实际发布文件为准,回填中和待核查文件不开放。文件名 YYYYMMDD_aucde.parquet,使用 ZSTD 压缩,可用 DuckDB、pandas 或 Polars 读取。

接口名称 file_download

请求方法 POST /api

  • https://sz.meoz.cn:6688
  • https://sh.meoz.cn:6688

请求

{"content":{"application/json":{"example":{"apikey":"","apiname":"file_download","params":{"data_type":"auction_tick","year":2026}},"schema":{"properties":{"apikey":{"default":"","description":"浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。","type":"string"},"apiname":{"default":"file_download","description":"接口名称","enum":["file_download"],"type":"string"},"params":{"additionalProperties":false,"default":{"data_type":"auction_tick","year":2026},"description":"| 参数 | 类型 | 是否必选 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `data_type` | `string` | 必选 | `auction_tick` | 竞价分笔文件。 |\n| `year` | `integer` | 必选 | `2026` | 2022年至当前年份,实际可下载范围以已发布文件为准。 |","properties":{"data_type":{"description":"竞价分笔文件。","enum":["auction_tick"],"example":"auction_tick","type":"string"},"year":{"description":"2022年至当前年份,实际可下载范围以已发布文件为准。","example":2026,"minimum":2022,"type":"integer"}},"required":["data_type","year"],"type":"object"}},"required":["apikey","apiname","params"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apiname` | `string` | 必选 | `file_download` | 接口名称 |\n| `apikey` | `string` | 必选 | [访问个人中心获取](/console) | 访问密钥 |","required":true}

响应

{"200":{"content":{"application/json":{"examples":{"no_data":{"description":"以下仅演示业务 code=1002 无已发布文件、code=503 暂不可用的响应结构;不表示所选年份当前无数据。成功响应的真实分享链接尚未核验,不提供虚构链接。","summary":"无已发布文件(业务 code=1002)","value":{"code":1002,"data":{"status":"no_data"},"message":"该年份暂无可下载数据"},"x-source":"etl/baidu/file_download.py::public_result"},"unavailable":{"description":"以下仅演示业务 code=1002 无已发布文件、code=503 暂不可用的响应结构;不表示所选年份当前无数据。成功响应的真实分享链接尚未核验,不提供虚构链接。","summary":"分享暂不可用(业务 code=503)","value":{"code":503,"data":{"retry_after":60,"status":"unavailable"},"message":"下载链接暂不可用,请稍后重试"},"x-source":"etl/baidu/file_download.py::public_result"}},"schema":{"properties":{"code":{"description":"业务状态码,200 表示成功","example":200,"type":"integer"},"data":{"nullable":true,"properties":{"data_type":{"example":"auction_tick","type":"string"},"end_date":{"description":"实际最晚日期,YYYYMMDD","type":"string"},"expires_at":{"description":"分享原生到期时间,ISO 8601,含时区;重复领取不延长","format":"date-time","type":"string"},"file_count":{"description":"分享中完整日包文件数量","type":"integer"},"password":{"description":"四位提取码","type":"string"},"retry_after":{"description":"暂不可用时可能返回的建议重试间隔,单位为秒","type":"integer"},"size_bytes":{"description":"日包文件总大小,单位为字节","type":"integer"},"start_date":{"description":"实际最早日期,YYYYMMDD","type":"string"},"status":{"enum":["ready","no_data","unavailable"],"type":"string"},"url":{"description":"百度网盘分享链接,不是文件下载直链","type":"string"},"year":{"example":2026,"type":"integer"}},"type":"object"},"message":{"description":"响应消息","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"code=200 可用,1002 无已发布文件,403 无权限,422 参数错误,503 缓存或清单不可用。返回 url、password、expires_at、start_date、end_date、file_count、size_bytes。分享创建后有效1天,每天00:00和12:00预生成;领取不会延长有效期,以 expires_at 为准。链接为百度网盘分享,不是文件直链。起止日期不代表其中每个交易日均有文件。\n\n以下仅演示业务 code=1002 无已发布文件、code=503 暂不可用的响应结构;不表示所选年份当前无数据。成功响应的真实分享链接尚未核验,不提供虚构链接。"},"429":{"content":{"application/json":{"schema":{"properties":{"code":{"example":429,"type":"integer"},"data":{"example":null,"nullable":true},"message":{"example":"请求频率超限:daily_auc_detail 接口的调用上限为 3 次/秒,请降低该接口的调用频率,建议 1 秒后重试。","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"账户总调用频率或单个重接口调用频率超过当前套餐限额。","headers":{"Retry-After":{"description":"建议等待后重试的秒数。","schema":{"minimum":1,"type":"integer"}}}}}

本页目录