API 文档

淘垦网「ERP 接口顾问」——规范/知识即服务。我们不代查你的业务数据、不托管你的 ERP 凭证，只提供权威、可执行的各家 ERP OPEN API 对接规范。

鉴权

所有 /v1/erp/* 查询接口需要在请求头携带 API Key：

X-Api-Key: erp_xxxxxxxxxxxxxxxx

Key 在 控制台 注册后免费领取（内测期 1000 次/月，每账户最多 3 个 Key）。

列出规范

GET/v1/erp/specs

参数	位置	说明
vendor	query，可选	按厂商过滤，如 chanjet
scenario	query，可选	按场景过滤，如 stock_query

curl -H "X-Api-Key: 你的KEY" \
  "https://open.iosat.com.cn/v1/erp/specs?vendor=chanjet"

查询单条规范

GET/v1/erp/spec

参数	位置	说明
v	query，必填	厂商，如 chanjet
s	query，必填	场景，如 stock_query
ver	query，可选	版本，缺省取最新

curl -H "X-Api-Key: 你的KEY" \
  "https://open.iosat.com.cn/v1/erp/spec?v=chanjet&s=stock_query"

返回完整规范：接口地址、鉴权方式、请求头、请求/响应示例、字段说明、错误码、实战 tips 与官方文档链接。

自然语言检索

POST/v1/erp/ask

curl -X POST -H "X-Api-Key: 你的KEY" -H "Content-Type: application/json" \
  -d '{"query":"查畅捷通库存怎么调"}' \
  "https://open.iosat.com.cn/v1/erp/ask"

按相关度返回最多 10 条匹配规范，适合接入 AI Agent 作为工具调用。

配额与限流

项	免费内测
调用配额	1000 次 / 月 / Key（每月 1 日自动重置）
每账户 Key 数	最多 3 个
超配额	返回 429 quota_exceeded

错误码

HTTP	error	说明
401	missing_api_key	未携带 X-Api-Key
401	invalid_api_key	Key 不存在或已吊销
429	quota_exceeded	本月配额已用尽
429	rate_limited	注册/登录过于频繁
404	spec_not_found	规范不存在
405	method_not_allowed	HTTP 方法不支持

账户与 Key（控制台接口）

以下接口供 控制台 使用，登录态通过 X-Session-Token 头或 Cookie 传递：

接口	说明
POST/v1/account/register	注册（email + password）
POST/v1/account/login	登录，返回会话 token（30 天有效）
GET/v1/account/me	我的信息：Key 列表 + 用量统计
POST/v1/account/keys	免费领取 API Key
POST/v1/account/keys/revoke	吊销 Key

当前规范库（4 条）

vendor	scenario	标题	版本
chanjet	authorize	授权绑定（获取 openToken）	1.0.0
chanjet	report_query	报表查询	1.0.0
chanjet	stock_query	库存查询	1.0.0
chanjet	warehouse_list	仓库列表	1.0.0

规范库持续扩充中；在 规范库门户 可免 Key 在线浏览。