开发者平台

关于「规划中」：它不是承诺，只是当前排期方向。上线前不接受申请、不提供测试环境， 也不作为合同条款。为避免误会，本页对未上线能力只描述用途，不写接口细节。

1. 提交接入申请约 10 分钟

   邮件说明接入方主体、调用场景、预估日调用量与需要的字段层级， 并留一位技术联系人的姓名与联系方式。

2. 场景与字段确认1–3 个工作日

   技术对接人回执，确认应开放到哪一层字段、是否需要 L2 字段， 并约定限流与异常处理方式。L3 字段不会开放，详见下方数据分级。

3. 获取对接材料确认后 1 个工作日内

   收到调用凭据、字段字典、示例响应、错误码说明与可用于联调的测试追溯码。 本页的接口文档与之一致，可先据此完成开发。

4. 联调与开通按双方排期

   在测试追溯码上完成联调与异常路径验证（尤其是 404 的处理）， 双方确认后正式开通。开通前不提供生产调用凭据。

请求参数

示例请求

GET /api/verify?c=SZ-C-2609-01-10 HTTP/1.1
Host: www.jiyuannk.com
Accept: application/json

示例响应（200）

{
  "token": "c10k2m9q",
  "batchNo": "SZ-C-2609-01-10",
  "groups": [
    {
      "title": "产品信息",
      "titleEn": "Product Details",
      "items": [
        { "k": "产品名称", "v": "松针腐殖土（粗料）" },
        { "k": "规格",     "v": "10 L" },
        { "k": "批次号",   "v": "SZ-C-2609-01-10", "mono": true }
      ]
    }
  ],
  "chain": [
    { "name": "原料采集", "date": "2026-02-18" },
    { "name": "破碎处理", "date": "2026-02-19" },
    { "name": "控温发酵", "date": "02-20→09-03" },
    { "name": "高温腐熟", "date": "2026-09-04" },
    { "name": "消杀控温", "date": "2026-09-05" },
    { "name": "取样质检", "date": "2026-09-07" },
    { "name": "智能筛分", "date": "2026-09-08" },
    { "name": "检测封装", "date": "2026-09-10" },
    { "name": "成品入库" }
  ]
}

上例为节选：只列了「产品信息」组，组内也只列了三个字段 —— 该组实际共六项， 另含采集地区、进料舱室、发酵周期，完整清单见下方「字段字典」。 实际返回的 groups 还会按字段层级裁剪： L2 字段需单独申请后才会出现，L3 字段任何情况下都不返回（见「数据分级」）。 各分组内 items 的顺序稳定，可直接按顺序渲染。

状态码

「为保护生产经营主体和消费者的权利，生产经营主体只能查询向上一级和向下一级节点追溯信息， 消费者只能查询到产地追溯信息。国家追溯平台自动保留查询记录。」 ——《省级追溯平台与国家追溯平台对接总体实施方案》

字段按 NY/T 4712-2025《农产品质量安全追溯 数据格式》 的分类口径组织， 接口设计与安全要求参照 NY/T 4713-2025《农产品质量安全追溯 数据接口》。 上述四项追溯行业标准由农业农村部第 898 号公告发布，2025 年 7 月 1 日起实施。