EtshopAPI Platform
中文 / EN
接口参考

业务状态码

所有接口的 HTTP 状态码都是 200,业务结果以响应体中的 code 为准。

所有接口的 HTTP 状态码都是 200,业务结果以响应体中的 code 为准。

枚举值

值 描述
200 成功
400 请求参数错误或业务错误,具体原因见 message
401 未授权:API Key 缺失或无效,或账户已被禁用。API Key 被禁用或删除后,最多 60 秒内失效
404 资源不存在,例如店铺/商品不存在、查询的店铺不在监控中
409 重复操作,例如店铺已在监控中
429 请求过于频繁:超过每分钟请求数限制(默认每个账户 200 次/分钟),请稍后再试
403001 拒绝访问:对应类型的 Credits 不足(Credits、Keyword Credits 或 Monitor Credits,见响应中的 credits.type)
403002 拒绝访问:没有查看权限。店铺/商品需要在 3 天内由列表或详情接口返回过;关键词需要在 30 天内通过关键词搜索查询过
500 服务器内部错误,本次请求已扣除的 Credits 会自动退还

403002 说明

部分接口不扣费,但要求先通过扣费接口获取数据,防止绕过列表直接按 ID 批量拉取:

超过有效期后,重新调用对应的扣费接口即可。详见计费规则。

来自现有接口目录与文档 · 支持接口名称和地址搜索