调用方接入指南

先确认你需要识别的主体，以及接受什么证据等级，再选择渠道和采用规则。

适用范围

目标为中国大陆依法设立，具备与业务相适应资质，并以药品流通或临床诊疗为主要业务，实际开展药品采购、销售或调剂供药活动的主体。仅从事科研、试验或教学且不开展相应经营／临床供药活动的机构，不纳入目标业务范围。

这是业务筛选方向；当前分类路由不等于完整药品资质核验。名称中含“研究型”不能单独作为排除依据，未查到资质也不等于无资质。

一次查询的最小输入

{
  "rid": "caller-record-001",
  "name": "上海交通大学医学院附属瑞金医院",
  "social_credit_code": null,
  "query_mask": 7
}

rid 是调用方关联标识，原样返回，不参与检索，也不是任务幂等键。name 和 social_credit_code 至少有一项。省份、地址、账户状态、short_name 不是当前外部输入。

请求到采用的步骤

1. 部署方提供受控的查询服务地址。当前没有已发布的公共 API 地址。
2. POST /verifications 提交，保存返回的 job_id 与 status_url。
3. GET /verifications/{job_id} 轮询任务。不要因等待而反复 POST 同一请求。
4. 任务完成后，先读 result.status，再逐条检查 details 及组级 query_status。
5. 依据 sources、field_evidence、issues 和候选覆盖程度决定是否采用。回写由调用方完成。

query_mask 选择的是渠道

相加组合，默认 7。例如 6=2+4，请求医疗登记和互联网，不能暗中补查工商。

当前 mask=4／6 只有已登记规范名称及成功读取可信网页后才可独立建立上下文；mask=2 的通用独立定位仍不足。已有工商信息不会仅凭 rid 自动从调用方历史记录中取回。

两条轴：渠道与属性

query_mask 控制从哪里查；identity／business／medical／custom 表示查到的值是什么。床位与诊疗量始终属于 medical，虽然通过互联网获取；custom 目前保存渠道类型，可由任意所选渠道的明确依据派生。

T21（药店）、T31（第三终端）、C（商业）不查询医疗专属属性。分类未知或冲突时先待复核，不能只看名称里是否有“医院”。

正式采用前还需要什么

目前适合受控原型验证与样本评测。正式接入前仍需部署鉴权、冻结结果契约、验证目标机构覆盖、明确预算与整体截止时间，并约定失败、歧义和字段缺失的采用规则。当前没有服务等级或字段全覆盖承诺。