云服务 API
本数据域下各能力均通过统一网关调用。请求体须指定 domain=cloud 及对应的 type。
| 能力名称 | type | 说明 |
|---|---|---|
| 快递查询 | express |
按快递单号查询物流轨迹。filters：com（公司编号，取自 cloud.express_com 命中的 no）、no（单号，也可用 query）、senderPhone / receiverPhone（寄/收件人手机后四位；顺丰/中通/跨越须填其一）。 |
| 快递公司编号 | express_com |
快递公司编号对照表。无业务请求参数（无需 query / filters）；hits 项仅含 com（公司名）与 no（公司编号），将 no 填入 cloud.express 的 filters.com； |
| 联网搜索 | web_search |
按关键词检索全网公开网页结果（标题、链接、摘要、日期）。条数用 top_k（1–10，默认 5）；本接口不支持 filters.offset 翻页。hits 可含 related_searches（相关搜索词列表）。 |
| 发票 OCR 识别 | invoice_ocr |
增值税发票结构化识别（普票/专票/电子票/全电/卷票等）。filters：image / url / pdf_file / ofd_file 四选一（优先级 image > url > pdf_file > ofd_file）；query 也可直接填图片 url。可选 type：normal（默认）或 roll（卷票）；seal_tag：是否开启印章识别；pdf_file_num / ofd_file_num：PDF/OFD 页码（默认第 1 页）。hits 字段名如 InvoiceNum、SellerName、CommodityTaxRate 等。本接口无分页，不支持 filters.offset。 |
各能力的 filters、返回字段与调用示例见对应能力页；统一约定见 统一查询。