接口目录

健康检查（无需鉴权）；data.status 恒 ok。实测公网 200，门户首页可用其做真实健康状态灯（不得伪造）。

连通性探测，用于验证 AK/SK 有效性与签名链路（真实 401 表示验签失败）。

回显测试：原样返回请求体，用于校验签名、时间戳与请求序列化。

返回当前凭据主体 {type,id}（E1 统一主体），用于自查 Key 归属。

商品分页列表；参数 page,pageSize,categoryId,keyword,isOnSale,sortField,sortOrder；响应 data.list。

热销商品列表；参数 limit（≤100）。

商品详情，含 skus 与溯源品质标签；已做字段白名单，拒绝 costPrice（成本价）。

商品 SKU 列表；已做字段白名单，拒绝 costPrice。

商品分类树。

商品分类列表；参数 rootOnly。

溯源报告公开视图（既有脱敏快照子集，原样透传）。数据源真实存在；未绑定/失效返回真实 404 或 data:null，绝不用 0/随机值冒充。

按商品查询品质标签（冻结白名单结构，不含告警/设备明细/坐标/内部 ID/成本）。

按报告查询品质标签（同一冻结白名单结构）。

本主体订单分页列表（merchant→自有订单；farmer→自购订单）；developer 主体返回 403。跨主体不可见。

该能力端点已开放，但涉主体交易数据、需人工核实主体所有权 → 请前往 开放意向登记 留下联系方式，由运营对接开通。

本主体订单详情；跨主体访问返回真实 404（不泄露存在性）并审计。

该能力端点已开放，但涉主体交易数据、需人工核实主体所有权 → 请前往 开放意向登记 留下联系方式，由运营对接开通。

农业问答；请求 {question,conversationId?}。上游降级时返回真实 503 UPSTREAM_DEGRADED，绝不 200。

病虫害识别；请求 {imageBase64|imageUrl,description?}。降级同样返回真实 503，不冒充成功。

本 Key/主体配额用量自省：日/月额度、并发、RPM、熔断状态。仅本主体自身，不含趋势/分布（看板属 C-3，暂不开放）。

提交接入申请（需 Idempotency-Key）；返回 applicationNo + 一次性 claimSecret（仅此一次展示）。

查询申请进度（需请求头 X-Claim-Secret，只读不轮换）。

领取 sk（需 X-Claim-Secret）；返回 ak/sk/新 claimSecret，均仅此一次展示。sk 唯一披露点。

自助重置 sk（需 X-Claim-Secret）；返回新 sk + 新 claimSecret。

自助吊销 Key（需 X-Claim-Secret）；返回 {ak,status:0}，不返回 secret、不轮换。

意向登记（独立轻量路由）：只收联系方式+用途，不建单、不承诺时间。本轮交付（用户已批准；归 engineer-3）。