API 文档

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

鉴权

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

X-Api-Key: erp_xxxxxxxxxxxxxxxx

Key 在 控制台 注册生成（每账户最多 20 个，仅作鉴权凭证）。每个账户每月享有免费调用额度，调用时先扣免费额度、再扣资源包。

列出规范

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 次 / 月（每月 1 日自动重置），所有 Key 共享
资源包	免费额度用尽后按资源包扣减（可购买 / 赠送 / 折扣）
每账户 Key 数	最多 20 个（仅鉴权凭证）
超配额	返回 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/auth/otp/send	发送短信验证码（scene: register / login / change_phone）
POST/v1/auth/register	注册：手机号 + 验证码 + 密码（两次确认），邮箱可选
POST/v1/auth/register/wechat	微信授权后补录注册（仍需手机号 + 验证码 + 密码）
POST/v1/auth/login	登录：账号（手机号或邮箱）+ 密码
POST/v1/auth/login/otp	登录：手机号 + 验证码
POST/v1/auth/login/wechat/*	微信登录（已绑直接登 / 未绑补手机号 / 未注册需设密码）
POST/v1/auth/profile/*	修改手机号 / 邮箱 / 密码
GET/v1/auth/me	当前账户资料
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 在线浏览。