流向数据直连 API

四川省新绿色医药集团有限公司 — 流向数据查询接口（密钥认证）

接口列表

接口方法说明
/api/healthGET健康检查（无需密钥）
/api/companiesGET查看本密钥绑定的单位信息
/api/queryGET流向数据查询

身份认证（四要素）

调用接口需同时提供：单位名称全称 + 密钥 + 联系人姓名 + 手机号。请求头或URL参数均可：

X-Company-Name: 单位名称全称
X-API-Key: xlv_xxxxxxxx...
X-Contact-Name: 联系人姓名
X-Contact-Phone: 手机号

查询示例

# 按商品名称查询(JSON)
curl -G -H "X-API-Key: 你的密钥" --data-urlencode "company_name=单位名称全称" --data-urlencode "name=联系人姓名" --data-urlencode "phone=手机号" --data-urlencode "query_type=product_name" --data-urlencode "query_value=贞芪扶正颗粒" "https://liuxiang.xinlvyao.cn/api/query"

# 按批号查询 + 日期范围 + 下载CSV
curl -G -H "X-API-Key: 你的密钥" --data-urlencode "company_name=单位名称全称" --data-urlencode "name=联系人姓名" --data-urlencode "phone=手机号" --data-urlencode "query_type=lot_number" --data-urlencode "query_value=240514" --data-urlencode "start_date=2025-01-01" --data-urlencode "end_date=2025-06-30" --data-urlencode "format=csv" -o 流向数据.csv

# 下载Excel
curl -G -H "X-API-Key: 你的密钥" --data-urlencode "company_name=单位名称全称" --data-urlencode "name=联系人姓名" --data-urlencode "phone=手机号" --data-urlencode "query_type=bill_number" --data-urlencode "query_value=XHCX00000027498" --data-urlencode "format=xlsx" -o 流向数据.xlsx

查询类型

query_type说明
bill_number按单据编号查询
product_name按商品名称查询
batch_number按批次号查询
lot_number按批号查询

注：普通密钥只能查询本单位（单位名称全称匹配）的流向数据；单次查询默认返回前5000条，可用 limit 调整；密钥有效期365天。