公共说明
API 接入文档 易客客户端、易客供应商端与亿乐供应商接口。左侧按系统和用途查阅，接口页包含请求参数、响应字段及调用示例。
服务地址 TEXT 复制
https://www.yikesup.com此地址为本次验证使用的 API 服务域名。文档发布网站与 API 服务可以使用不同域名。
接口分组 开始调用 在对应账户后台取得 AppId 与 AppSecret。 按照签名认证 计算请求头。 使用Python 示例 调用商品列表，确认业务状态码。 从列表取得有效编号，再查询详情或处理业务。 两套协议的区别 本次验证范围 2026-09-17 已验证 8 个商品、订单查询接口的成功响应。客户端 5 个查询接口返回认证失败；下单、退款、状态修改、商品修改与推送回调未执行。
实测结果仅适用于当前服务与本次样本。原文与实测不一致的字段在接口页分别展示，详见差异记录 。
公共说明
签名认证 本次易客供应商与亿乐查询均使用以下签名方式成功。客户端应使用对应会员凭据。
必需请求头 计算规则 TEXT 复制
AppToken = SHA1(AppId + AppSecret + requestURI + AppTimestamp)使用当前 Unix 秒级时间戳，转为字符串。 将请求路径与最终 QueryString 拼成 requestURI，不包含协议、域名和 URL 片段。 按上述顺序直接连接，不添加分隔符，使用 UTF-8 编码后计算 SHA1 小写十六进制字符串。 签名和请求头必须使用同一个 AppTimestamp；签名后不再改变查询串。 PYTHON 复制
requestURI = "/api/supplier/goods/v2/goods/list?limit=1&page=1"
# 签名使用这一完整字符串；实际请求也发送完全相同的路径与查询串。Header 名称不区分大小写，Appid / AppId 等效。POST 的 JSON 正文不在原文签名公式内；已验证的亿乐 POST 查询按此方式通过。
时间与查询串 推送回调验签 回调使用后台配置的完整 URL，包含协议和域名。使用请求头里的时间戳与账户密钥计算期望签名。
PYTHON 复制
import hashlib
import hmac
expected = hashlib.sha1(
(app_id + app_secret + configured_callback_url + header_timestamp).encode("utf-8")
).hexdigest()
valid = hmac.compare_digest(expected, header_token)回调 URL 的 QueryString 如有配置，也需按原文完整 URL 规则参与计算。回调重放时限、成功应答正文与重试间隔原文未定义，需与平台约定。
AppSecret 只在调用方服务端保存，不发送给 API，也不放入公开网页。
公共说明
Python 调用示例 Python 3 标准库实现，无第三方依赖。函数支持易客与亿乐协议，自动生成签名，并分别检查 HTTP 与业务错误。
设置凭据 以下为 PowerShell 示例。填入自己的凭据，在同一终端运行 Python 文件。
POWERSHELL 复制
$env:API_APP_ID = "YOUR_APP_ID"
$env:API_APP_SECRET = "YOUR_APP_SECRET"
python api_client.py本示例已验证易客 GET 与亿乐 POST 查询。保留显式 User-Agent；本次默认 Python 请求头曾收到 HTTP 403。
公共调用函数 api_client.py 复制
"""Python 3 standard library. Set API_APP_ID and API_APP_SECRET before use."""
import hashlib
import json
import os
import time
from urllib.parse import urlencode
from urllib.request import Request, build_opener, HTTPRedirectHandler
from urllib.error import HTTPError
BASE_URL = "https://www.yikesup.com"
class NoRedirect(HTTPRedirectHandler):
def redirect_request(self, req, fp, code, msg, headers, newurl):
return None
class APIError(RuntimeError):
pass
def request_api(path, *, method="GET", query=None, body=None, family="yike"):
"""Returns the entire response. family is 'yike' or 'yile'."""
if family not in ("yike", "yile"):
raise ValueError("family must be yike or yile")
if not path.startswith("/") or path.startswith("//") or "?" in path or "#" in path:
raise ValueError("Use an absolute API path and pass query separately")
app_id = os.environ["API_APP_ID"]
app_secret = os.environ["API_APP_SECRET"]
# Generate the query string once; sign and send exactly the same URI.
query_string = urlencode(query or {}, doseq=True)
uri = path + ("?" + query_string if query_string else "")
url = BASE_URL.rstrip("/") + uri
timestamp = str(int(time.time())) # Unix seconds, not milliseconds
token = hashlib.sha1(
(app_id + app_secret + uri + timestamp).encode("utf-8")
).hexdigest()
headers = {
"AppId": app_id,
"AppToken": token,
"AppTimestamp": timestamp,
"Accept": "application/json",
"User-Agent": "API-Documentation-Verification/1.0",
}
payload = None
if body is not None:
headers["Content-Type"] = "application/json"
payload = json.dumps(body, ensure_ascii=False).encode("utf-8")
req = Request(url, data=payload, headers=headers, method=method)
try:
with build_opener(NoRedirect).open(req, timeout=20) as response:
raw = response.read()
except HTTPError as exc:
raise APIError(f"HTTP {exc.code}; check the service response") from exc
try:
response_data = json.loads(raw)
except (ValueError, UnicodeDecodeError) as exc:
raise APIError("The server did not return JSON") from exc
expected_code = 100 if family == "yike" else 0
if not isinstance(response_data, dict):
raise APIError("Unexpected response structure")
if response_data.get("code") != expected_code:
message = response_data.get("msg", response_data.get("message", ""))
raise APIError(f"API {response_data.get('code')}: {message}")
return response_data
if __name__ == "__main__":
# Read-only example: Yike supplier goods, one row per page.
response = request_api(
"/api/supplier/goods/v2/goods/list",
query={"limit": 1, "page": 1},
)
print(json.dumps(response, ensure_ascii=False, indent=2))
亿乐查询示例 PYTHON 复制
response = request_api(
"/openapi/supplier/Goods/Paging",
method="POST",
body={"page": 1, "list_rows": 1, "id": None, "status": 1, "goods_category_id": None},
family="yile",
)
items = response["data"]["infos"]
print(items)cURL 请求结构 先按签名规则计算 APP_TOKEN；APP_TIMESTAMP 必须与该次签名一致。
BASH 复制
curl --request GET \
"https://www.yikesup.com/api/supplier/goods/v2/goods/list?limit=1&page=1" \
--header "AppId: YOUR_APP_ID" \
--header "AppToken: CALCULATED_APP_TOKEN" \
--header "AppTimestamp: SAME_TIMESTAMP_USED_IN_SIGNATURE"公共说明
响应与错误处理 业务状态码 建议检查顺序 检查 HTTP 状态和响应是否为 JSON。 按接口系列检查 code，读取 msg 或 message。 检查业务对象的编号和关键字段，不能把空记录当作有效订单。 按实际类型处理数组、JSON 字符串和 null。 字段类型兼容 PYTHON 复制
import json
from decimal import Decimal
def as_list(value):
if value is None or value == "":
return []
parsed = json.loads(value) if isinstance(value, str) else value
if not isinstance(parsed, list):
raise TypeError("expected a list or JSON-encoded list")
return parsed
# 仅对确实是 JSON 文本的字段解析一次。
params = as_list(order.get("params"))
logs = as_list(order.get("logs"))
# 金额如需计算，用 Decimal 保留十进制精度。
price = Decimal(str(order["price"]))常见问题 公共说明
订单状态 以下易客枚举来自原文，状态转换约束未实测。亿乐不能复用易客枚举。
易客供应商端 state 易客客户端订单 state 亿乐订单状态 响应和订单列表过滤使用 status，状态更改接口使用 old_status、new_status。以下为平台补充确认的状态定义。
new_status = 8（已退款）时，refund_number 必传。状态值定义不代表任意两种状态之间均允许转换；状态转换约束未实测。
公共说明
实测差异记录 验证日期：2026-09-17。执行只读查询，包括使用 POST 的亿乐查询接口。
已验证的成功响应 未确认范围 易客 API / 客户端
商品分类 本次凭据认证未通过
GET /api/client/goods/v2/category复制
本次请求返回 HTTP 200、业务 code = 403，提示 AppId 未找到。以下成功响应取自原文，需使用客户端所属会员凭据验证。
请求说明 Content-Type 原文值：未填写。当前查询示例按实际验证的传输方式编写。
原文未列出 Query 参数。本页示例不附加未定义参数。
成功响应（原文） JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"data": [
{
"categoryId": 1,
"categoryName": "DY",
"categoryThumb": "http://www.baidu.com/uploads/2022-06/16560595528229.png",
"parentCategoryId": 0
},
{
"categoryId": 12,
"categoryName": "视屏号",
"categoryThumb": "http://cms2.hengchengde.cn:5000/uploads/2022-06/16563241412957.png",
"parentCategoryId": 0
}
],
"total": 367
}
}认证失败响应（实测） JSON 复制
{
"code": 403,
"msg": "接口认证失败，AppId 未找到（提示已简化）",
"result": {
"data": ""
}
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/client/goods/v2/category',
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/client/goods/v2/category
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 客户端
商品列表 本次凭据认证未通过
GET /api/client/goods/v2/goods/list复制
本次请求返回 HTTP 200、业务 code = 403，提示 AppId 未找到。以下成功响应取自原文，需使用客户端所属会员凭据验证。
请求说明 Content-Type 原文值：未填写。当前查询示例按实际验证的传输方式编写。
原文未列出 Query 参数。本页示例不附加未定义参数。
成功响应（原文） JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"data": [
{
"goodsSN": 1,
"goodsName": "哈哈",
"goodsThumb": "http://58.57sj.cn/upload/console/goods/5e942ea421b4ae146eb0ea2022095fda.png",
"categoryId": 1,
"categoryName": "DY"
}
],
"total": 3
}
}认证失败响应（实测） JSON 复制
{
"code": 403,
"msg": "接口认证失败，AppId 未找到（提示已简化）",
"result": {
"data": ""
}
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/client/goods/v2/goods/list',
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/client/goods/v2/goods/list
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 客户端
商品详情 本次凭据认证未通过
GET /api/client/goods/v2/goods复制
原文参数表写 paramsTemplate，响应示例写 ParamsTemplate。客户端成功响应尚未验证，不用供应商端字段替代客户端契约。
本次请求返回 HTTP 200、业务 code = 403，提示 AppId 未找到。以下成功响应取自原文，需使用客户端所属会员凭据验证。
请求说明 Content-Type 原文值：none。当前查询示例按实际验证的传输方式编写。
Query 参数 成功响应（原文） JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"goodsSN": 1,
"goodsId": 1,
"goodsName": "测试",
"goodsThumb": "http://58.xxxxsj.cn/upload/console/goods/5e942ea421b4ae146eb0ea2022095fda.png",
"goodsUnit": "个",
"goodsDesc": "GoodsDesc",
"minOrderNum": 2,
"maxOrderNum": 10000,
"goodsPrice": "1.3",
"goodsDetail": " dddd",
"goodsStock": 1000,
"preUnitNum": 1,
"ParamsTemplate": "[{\"alias\":\"作品链接\",\"assist\":\"input\",\"desc\":\"连接\",\"name\":\"连接111\",\"required\":true}]",
"goodsType": 1,
"canTui": "1",
"canRepeat": 1,
"categoryId": 1,
"isClose": 2,
"categoryName": "DY"
}
}认证失败响应（实测） JSON 复制
{
"code": 403,
"msg": "接口认证失败，AppId 未找到（提示已简化）",
"result": {
"data": ""
}
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/client/goods/v2/goods',
query={'goodsSN': '10001'},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/client/goods/v2/goods?goodsSN=
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 客户端
下单 原文定义 · 未验证写入
POST /api/client/goods/v2/order复制
customOrderSN 按原文为必填且 40 位以内。成功示例已补齐 JSON 逗号；重试前应先确认原请求是否成功，避免重复下单。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 原文表中 number、params 标为 string，但正文示例分别为数字和数组。此写入未验证，接入时需确认服务端实际类型约束。
请求正文 JSON 复制
{
"goodsSN": "10",
"number": 500,
"orderNote": "下单",
"customOrderSN": "dddddd",
"params": [
{
"alias": "主页链接",
"name": "作品连接",
"value": "http://www.baidu.com"
},
{
"alias": "时长",
"name": "作品连接",
"value": "2"
}
]
}成功响应（原文） JSON 复制
{
"code": 100,
"result": {
"orderSN": "39292823123"
},
"msg": ""
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/client/goods/v2/order',
method="POST",
body={'goodsSN': '10',
'number': 500,
'orderNote': '下单',
'customOrderSN': 'dddddd',
'params': [{'alias': '主页链接',
'name': '作品连接',
'value': 'http://www.baidu.com'},
{'alias': '时长', 'name': '作品连接', 'value': '2'}]},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/client/goods/v2/order
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 客户端
订单详情 本次凭据认证未通过
GET /api/client/goods/v2/order复制
客户端 state 枚举与供应商端不同，见订单状态。此处成功结构仍为原文定义。
本次请求返回 HTTP 200、业务 code = 403，提示 AppId 未找到。以下成功响应取自原文，需使用客户端所属会员凭据验证。
请求说明 Content-Type 原文值：未填写。当前查询示例按实际验证的传输方式编写。
Query 参数 成功响应（原文） JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"orderSN": 84,
"state": 7,
"goodsSN": "3",
"goodsName": "亿乐测试",
"orderNum": "10",
"orderRemark": "下单",
"startNum": 0,
"currentNum": 0,
"finishTotal": 0,
"price": "1.00300000",
"orderAmount": "10.03000000",
"refundAmount": "5.01500000",
"refundNumber": 5,
"params": "[{\"alias\":\"主页链接\",\"name\":\"作品连接\",\"value\":\"http://www.baidu.com\"},{\"alias\":\"评论内容\",\"name\":\"作品连接\",\"value\":\"dfdfdfdfdfdfdfd\"}]",
"logs": "[{\"content\":\"状态为:创建订单\",\"createdAt\":\"2023-11-11 11:16:16\"},{\"content\":\"状态为:已退款\",\"createdAt\":\"2023-11-11 12:35:56\"}]",
"createdAt": 1699672576,
"cardNumber": ""
}
}认证失败响应（实测） JSON 复制
{
"code": 403,
"msg": "接口认证失败，AppId 未找到（提示已简化）",
"result": {
"data": ""
}
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/client/goods/v2/order',
query={'orderSN': '10001'},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/client/goods/v2/order?orderSN=
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 客户端
申请退款 原文定义 · 未验证写入
POST /api/client/goods/v2/order/state复制
请求说明 Content-Type 原文值：未填写。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"orderSN": "10"
}成功响应（原文） JSON 复制
{
"code": 100,
"result": "",
"msg": "ok"
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/client/goods/v2/order/state',
method="POST",
body={'orderSN': '10'},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/client/goods/v2/order/state
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 客户端
账户信息 本次凭据认证未通过
GET /api/client/account/v2/profile复制
本次请求返回 HTTP 200、业务 code = 403，提示 AppId 未找到。以下成功响应取自原文，需使用客户端所属会员凭据验证。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
原文未列出 Query 参数。本页示例不附加未定义参数。
成功响应（原文） JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"balance": "1005.0150000000",
"uid": 15737,
"username": "huaxia12"
}
}认证失败响应（实测） JSON 复制
{
"code": 403,
"msg": "接口认证失败，AppId 未找到（提示已简化）",
"result": {
"data": ""
}
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/client/account/v2/profile',
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/client/account/v2/profile
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 供应商端
订单退单 原文定义 · 未验证写入
POST /api/supplier/order/v2/refundTd复制
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"orderSN": "41",
"remarks": "下单"
}成功响应（原文） 原文未提供成功响应正文。
调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/supplier/order/v2/refundTd',
method="POST",
body={'orderSN': '41', 'remarks': '下单'},
family="yike"
)
print(response)原文地址与失败响应说明 http://域名/api/supplier/order/v2/refundTd
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 供应商端
商品列表 实测成功 · 2026-09-17
GET /api/supplier/goods/v2/goods/list复制
实测列表返回 result.data 数组和 result.total；价格字段为 supplyPrice。原文示例是单个商品对象，不能直接作为当前列表结构使用。
原文接口状态：已完成。
请求说明 Content-Type 原文值：form-data。当前查询示例按实际验证的传输方式编写。
Query 参数 响应字段 以下类型来自 2026-09-17 的成功响应样本；不代表所有记录的可空范围。[] 表示数组元素。
成功响应示例 HTTP 200。结构与类型来自实测；编号、名称、金额和业务数值已替换，数组仅保留一项。
JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"data": [
{
"goodsSN": 10001,
"goodsName": "示例名称",
"goodsThumb": "",
"AddTime": 1760000000,
"goodsUnit": "",
"goodsDesc": "",
"goodsState": 1,
"minOrderNum": 1000,
"maxOrderNum": 100000000,
"supplyPrice": "1.00",
"goodsDetail": "示例内容",
"goodsStock": -1,
"preUnitNum": 1,
"goodsType": 1,
"categoryId": 10001,
"isClose": 2,
"categoryName": "示例名称"
}
],
"total": 1
}
}原文响应定义对照 JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"goodsSN": 1,
"goodsName": "测试",
"goodsThumb": "http://58.57sj.cn/upload/console/goods/5e942ea421b4ae146eb0ea2022095fda.png",
"goodsUnit": "个",
"goodsDesc": "GoodsDesc",
"goodsState": 1,
"minOrderNum": 2,
"maxOrderNum": 10000,
"goodsPrice": "1.00000000",
"goodsDetail": "",
"goodsStock": 1000,
"preUnitNum": 1,
"ParamsTemplate": "[{\"alias\":\"作品链接\",\"assist\":\"input\",\"desc\":\"连接\",\"name\":\"连接111\",\"required\":true}]",
"goodsType": 1,
"canTui": "1",
"canRepeat": 1,
"categoryId": 1,
"isClose": 2,
"categoryName": "DY"
}
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/supplier/goods/v2/goods/list',
query={'limit': 10, 'page': 1},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/supplier/goods/v2/goods/list?goodsName=&goodsSN=&goodsState=&categoryId=&isClose=&limit=100&page=1
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 供应商端
商品详情 实测成功 · 2026-09-17
GET /api/supplier/goods/v2/goods复制
实测详情为 goodsSN / goodsName 等字段，ParamsTemplate 为数组。原文 Id / GoodsName / Gid 等字段属于旧示例，保留在原文对照中。
请求说明 Content-Type 原文值：none。当前查询示例按实际验证的传输方式编写。
Query 参数 响应字段 以下类型来自 2026-09-17 的成功响应样本；不代表所有记录的可空范围。[] 表示数组元素。
成功响应示例 HTTP 200。结构与类型来自实测；编号、名称、金额和业务数值已替换，数组仅保留一项。
JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"goodsSN": 10001,
"goodsName": "示例名称",
"AddTime": 1760000000,
"goodsThumb": "",
"goodsUnit": "",
"goodsDesc": "",
"goodsState": 1,
"minOrderNum": 1000,
"maxOrderNum": 100000000,
"goodsPrice": "1.00",
"goodsDetail": "示例内容",
"goodsStock": -1,
"preUnitNum": 1,
"ParamsTemplate": [
{
"alias": "示例内容",
"assist": "示例内容",
"desc": "示例内容",
"name": "示例名称",
"required": true
}
],
"goodsType": 1,
"canTui": "",
"canRepeat": 2,
"categoryId": 10001,
"isClose": 2,
"categoryName": "示例名称"
}
}原文响应定义对照 JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"Id": 1,
"Gid": "758",
"AddTime": 1698202421,
"GoodsName": "11测试",
"ShequId": 4,
"IsClose": 2,
"CategoryId3": 10,
"CategoryId2": 3,
"GoodsType": 1,
"CategoryId": 1,
"Sort": 1,
"GoodsThumb": "http://58.57sj.cn/upload/console/goods/5e942ea421b4ae146eb0ea2022095fda.png",
"GoodsPrice": "1.00000000",
"ParamsTemplate": "[{\"description\":\"连接\",\"is_default\":false,\"key\":\"作品链接\",\"name\":\"连接111\",\"type\":1,\"type_config\":\"\",\"value\":{\"max\":1,\"min\":100}}]",
"CanTui": "1",
"CanRepeat": 1,
"IsSecret": 1,
"OtherName": "",
"GoodsUnit": "个",
"GongId": 71,
"Bs": 1,
"MinOrderNum": 2,
"MaxOrderNum": 10000,
"LimitMoney": "10.00",
"LimitCount": -1,
"GoodsDesc": "GoodsDesc",
"GoodsDetail": "",
"JiuwuType": "",
"Lable": "Lable",
"IsTb": 1,
"IsIndex": 1,
"IsTc": 1,
"TcTitle": "TcTitle",
"TcContent": "TcContent",
"SfGoodsName": "SfGoodsName",
"Bq": "Bq",
"GoodsStock": 1000,
"IsMx": 1,
"MxSort": 1,
"TbTime": 1698661781,
"AuditStatus": 1,
"SSupid": 0
}
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/supplier/goods/v2/goods',
query={'goodsSN': '10001'},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/supplier/goods/v2/goods?goodsSN=
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 供应商端
订单列表 实测成功 · 2026-09-17
GET /api/supplier/order/v2/orders复制
实测 params 是数组，logs 仍为序列化 JSON 字符串。goodsSN、number 是字符串，orderSN 是整数。
请求说明 Content-Type 原文值：none。当前查询示例按实际验证的传输方式编写。
Query 参数 响应字段 以下类型来自 2026-09-17 的成功响应样本；不代表所有记录的可空范围。[] 表示数组元素。
成功响应示例 HTTP 200。结构与类型来自实测；编号、名称、金额和业务数值已替换，数组仅保留一项。
JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"data": [
{
"orderSN": 10001,
"customOrderSN": "10001",
"state": 2,
"buyUserId": 10001,
"goodsSN": "10001",
"goodsName": "示例名称",
"number": "1000",
"orderRemark": "",
"startNum": 0,
"currentNum": 100,
"finishTotal": 100,
"price": "1.00",
"amount": "1000.00",
"refundAmount": "0.00",
"refundNumber": 0,
"params": [
{
"alias": "示例内容",
"name": "示例名称",
"value": "https://example.com/image.png"
}
],
"orderNote": "",
"logs": "[{\"content\":\"示例内容\",\"createdAt\":\"示例内容\"}]",
"createdAt": 1760000000
}
],
"total": 1
}
}原文响应定义对照 JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"data": [
{
"orderSN": 86,
"customOrderSN": "202311113rBGhVNul",
"state": 2,
"buyUserId": 15737,
"goodsSN": "3",
"goodsName": "11测试",
"number": "10",
"orderRemark": "下单",
"startNum": 0,
"currentNum": 0,
"finishTotal": 0,
"price": "1.00300000",
"amount": "10.03000000",
"refundAmount": "0.00000000",
"refundNumber": 0,
"params": "[{\"alias\":\"主页链接\",\"name\":\"作品连接\",\"value\":\"http://www.baidu.com\"},{\"alias\":\"评论内容\",\"name\":\"作品连接\",\"value\":\"dfdfdfdfdfdfdfd\"}]",
"orderNote": "",
"logs": "[{\"content\":\"状态为:创建订单\",\"createdAt\":\"2023-11-11 11:20:25\"}]",
"createdAt": 1699672825,
"cardNumber": ""
}
],
"total": 3
}
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/supplier/order/v2/orders',
query={'limit': 10, 'page': 1},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/supplier/order/v2/orders?page=&goodsSN=&orderSN=&state=&limit=
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 供应商端
订单详情 实测成功 · 2026-09-17
GET /api/supplier/order/v2/order复制
实测 params 是数组，logs 是字符串。不要对已经是数组的 params 再执行 JSON.parse。
请求说明 Content-Type 原文值：none。当前查询示例按实际验证的传输方式编写。
Query 参数 响应字段 以下类型来自 2026-09-17 的成功响应样本；不代表所有记录的可空范围。[] 表示数组元素。
成功响应示例 HTTP 200。结构与类型来自实测；编号、名称、金额和业务数值已替换，数组仅保留一项。
JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"orderSN": 10001,
"customOrderSN": "10001",
"state": 2,
"buyUserId": 10001,
"goodsSN": "10001",
"goodsName": "示例名称",
"number": "1000",
"orderRemark": "",
"startNum": 0,
"currentNum": 100,
"finishTotal": 100,
"price": "1.00",
"amount": "1000.00",
"refundAmount": "0.00",
"refundNumber": 0,
"params": [
{
"alias": "示例内容",
"name": "示例名称",
"value": "https://example.com/image.png"
}
],
"orderNote": "",
"logs": "[{\"content\":\"示例内容\",\"createdAt\":\"示例内容\"}]",
"createdAt": 1760000000
}
}原文响应定义对照 JSON 复制
{
"code": 100,
"msg": "ok",
"result": {
"orderSN": 84,
"customOrderSN": "202311111bPES_70D",
"state": 7,
"buyUserId": 15737,
"goodsSN": "3",
"goodsName": "亿乐测试",
"number": "10",
"orderRemark": "下单",
"startNum": 0,
"currentNum": 0,
"finishTotal": 0,
"price": "1.00300000",
"amount": "10.03000000",
"refundAmount": "5.01500000",
"refundNumber": 5,
"params": "[{\"alias\":\"主页链接\",\"name\":\"作品连接\",\"value\":\"http://www.baidu.com\"},{\"alias\":\"评论内容\",\"name\":\"作品连接\",\"value\":\"dfdfdfdfdfdfdfd\"}]",
"orderNote": "不要意思要退款",
"logs": "[{\"content\":\"状态为:创建订单\",\"createdAt\":\"2023-11-11 11:16:16\"},{\"content\":\"状态为:已退款\",\"createdAt\":\"2023-11-11 12:35:56\"}]",
"createdAt": 1699672576
}
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/supplier/order/v2/order',
query={'orderSN': '10001'},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/supplier/order/v2/order?orderSN=
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 供应商端
订单状态操作 原文定义 · 未验证写入
POST /api/supplier/order/v2/order复制
原文 state = 500 不在其状态表中，调用示例改为 2（处理中）。实际业务是否允许该状态转换未验证。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"orderSN": "10",
"state": 2,
"remarks": "下单"
}成功响应（原文） JSON 复制
{
"code": 100,
"msg": "ok",
"result": ""
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/supplier/order/v2/order',
method="POST",
body={'orderSN': '10', 'state': 2, 'remarks': '下单'},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/supplier/order/v2/order
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 供应商端
更新订单完成进度 原文定义 · 未验证写入
POST /api/supplier/order/v2/progress复制
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"orderSN": 803583,
"startNum": 602,
"currentNum": 602,
"remarks": ""
}原文请求注释 orderSN、startNum、currentNum 必传。remarks 在原文参数表中也标为必填。 成功响应（原文） JSON 复制
{
"code": 100,
"msg": "ok",
"result": ""
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/supplier/order/v2/progress',
method="POST",
body={'orderSN': 803583, 'startNum': 602, 'currentNum': 602, 'remarks': ''},
family="yike"
)
print(response)原文地址与失败响应说明 http://127.0.0.1:9991/api/supplier/order/v2/progress
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 供应商端
修改商品信息 原文定义 · 未验证写入
POST /api/supplier/goods/v2/goods复制
原文最低数量 600 大于最高数量 10，调用示例改为 minNum = 10、maxNum = 10000。修改接口未执行。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"goodsSN": "10",
"price": "500",
"minNum": 10,
"maxNum": 10000,
"baseNum": 10,
"close": true
}成功响应（原文） JSON 复制
{
"code": 100,
"msg": "ok",
"result": ""
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/supplier/goods/v2/goods',
method="POST",
body={'goodsSN': '10',
'price': '500',
'minNum': 10,
'maxNum': 10000,
'baseNum': 10,
'close': True},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/supplier/goods/v2/goods
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 供应商端
订单退款 原文定义 · 未验证写入
POST /api/supplier/order/v2/refund复制
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"orderSN": "10",
"number": 500,
"remarks": "下单"
}成功响应（原文） JSON 复制
{
"code": 100,
"msg": "ok",
"result": ""
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/api/supplier/order/v2/refund',
method="POST",
body={'orderSN': '10', 'number': 500, 'remarks': '下单'},
family="yike"
)
print(response)原文地址与失败响应说明 http://接口域名/api/supplier/order/v2/refund
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
易客 API / 供应商端
订单推送回调 原文定义
POST 后台配置的推送地址复制
推送方向为平台 → 供应商后台配置的回调地址；不是调用服务域名上的固定路径。验签时使用完整回调 URL。原文未定义应答正文、重试策略和超时时间。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"createdAt": 1710816528,
"goodsName": "供应商测试5",
"goodsSN": 164,
"goodsThumb": "",
"number": 1,
"orderSN": "202403192oujgmJuv",
"unitPrice": "37.00000000"
}成功响应（原文） 原文未提供成功响应正文。
原文地址与失败响应说明 xxxx
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
亿乐 API / 供应商
商品列表 实测成功 · 2026-09-17
POST /openapi/supplier/Goods/Paging复制
实测 status = 1 可查到审核通过的商品；status = 2 本次返回空列表。分页记录位于 data.infos，总数位于 data.count。空列表不能说明签名失败。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"page": 1,
"list_rows": 10,
"id": null,
"status": 1,
"goods_category_id": null
}原文请求注释 响应字段 以下类型来自 2026-09-17 的成功响应样本；不代表所有记录的可空范围。[] 表示数组元素。
成功响应示例 HTTP 200。结构与类型来自实测；编号、名称、金额和业务数值已替换，数组仅保留一项。
JSON 复制
{
"code": 0,
"message": "ok",
"data": {
"count": 1,
"infos": [
{
"id": 10001,
"supplier_info": "示例内容",
"is_card_code": 0,
"is_close": 0,
"refund_status": null,
"name": "示例名称",
"tag": "",
"weight": 0,
"goods_category_info": "示例内容",
"price": 0.0,
"buy_max_limit": 0,
"stock": 0,
"create_time": 1760000000,
"status": 1
}
]
}
}原文响应定义对照 原文未提供成功响应正文。
调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/openapi/supplier/Goods/Paging',
method="POST",
body={'page': 1,
'list_rows': 10,
'id': None,
'status': 1,
'goods_category_id': None},
family="yile"
)
print(response)原文地址与失败响应说明 127.0.0.1:9991/openapi/supplier/Goods/Paging
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
亿乐 API / 供应商
商品详情 实测成功 · 2026-09-17
POST /openapi/supplier/Goods/Show复制
实测有效商品 id 返回 code = 0，id = 0 返回 code = 1、message = 商品无效。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 响应字段 以下类型来自 2026-09-17 的成功响应样本；不代表所有记录的可空范围。[] 表示数组元素。
成功响应示例 HTTP 200。结构与类型来自实测；编号、名称、金额和业务数值已替换，数组仅保留一项。
JSON 复制
{
"code": 0,
"message": "ok",
"data": {
"id": 10001,
"is_card_code": 0,
"goods_category_id": 10001,
"goods_category_id2": 0,
"goods_category_id3": 0,
"name": "示例名称",
"create_time": 1760000000,
"weight": 0,
"price": 0.0,
"stock": 0,
"unit": "",
"buy_min_limit": 0,
"buy_max_limit": 0,
"is_repeat": 0,
"is_close": 0,
"is_batch": 0,
"refund_status": null,
"image_urls": [
""
],
"particulars": "",
"status": 1,
"buy_params": [
{
"description": "示例内容",
"key": "示例内容",
"name": "示例名称",
"type": 0,
"type_config": "",
"value": "",
"verify": {
"max": 0,
"min": 0
}
}
],
"price_show_num": 0,
"description": "",
"goods_category_name": "示例名称",
"buy_rate": 0,
"goodsThumb": ""
}
}原文响应定义对照 原文未提供成功响应正文。
错误响应（实测） id = 0 时返回 HTTP 200：
JSON 复制
{
"code": 1,
"message": "商品无效",
"data": ""
}调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/openapi/supplier/Goods/Show',
method="POST",
body={'id': 504},
family="yile"
)
print(response)原文地址与失败响应说明 127.0.0.1:9991/openapi/supplier/Goods/Show
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
亿乐 API / 供应商
修改商品 原文定义 · 未验证写入
POST /openapi/supplier/Goods/Edit复制
原文标为开发中；请求参数说明由原文 JSON 注释整理，必填规则未提供。
原文接口状态：开发中。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 原文没有参数表；以下类型和说明由请求示例整理，必填性未验证。
请求正文 JSON 复制
{
"id": 504,
"goods_category_id": 4,
"goods_category_id2": 4,
"goods_category_id3": 4,
"name": "测试供货1",
"price": 11,
"stock": 10,
"unit": "2",
"buy_rate": 3,
"buy_min_limit": 4,
"buy_max_limit": 5,
"is_repeat": 1,
"is_close": 2,
"refund_status": [],
"image_urls": [
"wwww.aa.a"
],
"particulars": "ddffssdfdsf",
"buy_params": [
{
"type": 4,
"value": "",
"key": "1",
"description": "eeee",
"name": "eee",
"type_config": "",
"verify": {
"min": 1,
"max": -1
}
}
]
}原文请求注释 id 类别1 类别2 类别3 商品名称 金额 库存 单位 下单倍数 最小 最大 1:可以重复下单,2:不可以 1:关闭下单,2:开启 可以退的状态 商品图片 商品详情 成功响应（原文） 原文未提供成功响应正文。
调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/openapi/supplier/Goods/Edit',
method="POST",
body={'id': 504,
'goods_category_id': 4,
'goods_category_id2': 4,
'goods_category_id3': 4,
'name': '测试供货1',
'price': 11,
'stock': 10,
'unit': '2',
'buy_rate': 3,
'buy_min_limit': 4,
'buy_max_limit': 5,
'is_repeat': 1,
'is_close': 2,
'refund_status': [],
'image_urls': ['wwww.aa.a'],
'particulars': 'ddffssdfdsf',
'buy_params': [{'type': 4,
'value': '',
'key': '1',
'description': 'eeee',
'name': 'eee',
'type_config': '',
'verify': {'min': 1, 'max': -1}}]},
family="yile"
)
print(response)原文地址与失败响应说明 127.0.0.1:9991/openapi/supplier/Goods/Edit
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
亿乐 API / 供应商
修改商品价格 原文定义 · 未验证写入
POST /openapi/supplier/Goods/EditPrice复制
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"id": 504,
"price": 1.25
}原文请求注释 成功响应（原文） 原文未提供成功响应正文。
调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/openapi/supplier/Goods/EditPrice',
method="POST",
body={'id': 504, 'price': 1.25},
family="yile"
)
print(response)原文地址与失败响应说明 127.0.0.1:9991/openapi/supplier/Goods/EditPrice
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
亿乐 API / 供应商
订单列表 实测成功 · 2026-09-17
POST /openapi/supplier/Order/Paging复制
实测 status = null 查询到已有订单。buy_params、status_changes 为数组，params、logs 为 JSON 字符串。订单状态不可套用易客的 state。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"page": 1,
"list_rows": 10,
"id": null,
"status": null,
"goods_id": null
}原文请求注释 响应字段 以下类型来自 2026-09-17 的成功响应样本；不代表所有记录的可空范围。[] 表示数组元素。
成功响应示例 HTTP 200。结构与类型来自实测；编号、名称、金额和业务数值已替换，数组仅保留一项。
JSON 复制
{
"code": 0,
"message": "ok",
"data": {
"count": 1,
"infos": [
{
"id": 10001,
"goods_id": "10001",
"status": 3,
"customer_id": 10001,
"selling_price": "1.00",
"amount": 0,
"buy_params": [
{
"description": "示例内容",
"is_default": false,
"key": "示例内容",
"name": "示例名称",
"type": 0,
"type_config": "",
"value": "https://example.com/image.png",
"verify": {
"max": 0,
"min": 0
}
}
],
"buy_number": "1",
"refund_amount": 0,
"start_num": 0,
"current_num": 100,
"card_code_ids": null,
"create_time": 1760000000,
"ip": "192.0.2.1",
"remark": "",
"goodsName": "示例名称",
"status_changes": [
{
"At": "示例内容",
"Name": "示例名称"
}
],
"refundNumber": 0,
"params": "[{\"alias\":\"示例内容\",\"name\":\"示例名称\",\"value\":\"https://example.com/image.png\"}]",
"logs": "[{\"content\":\"示例内容\",\"createdAt\":\"示例内容\"}]",
"cardNumber": ""
}
]
}
}原文响应定义对照 原文未提供成功响应正文。
调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/openapi/supplier/Order/Paging',
method="POST",
body={'page': 1, 'list_rows': 10, 'id': None, 'status': None, 'goods_id': None},
family="yile"
)
print(response)原文地址与失败响应说明 127.0.0.1:9991/openapi/supplier/Order/Paging
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
亿乐 API / 供应商
订单详情 实测成功 · 2026-09-17
POST /openapi/supplier/Order/Show复制
有效订单 ID 的响应已验证。另一次 id = 0 查询仍返回 code = 0 和空值记录，因此不能仅以 code = 0 判断订单存在，应核对返回 id 及关键业务字段。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 响应字段 以下类型来自 2026-09-17 的成功响应样本；不代表所有记录的可空范围。[] 表示数组元素。
成功响应示例 HTTP 200。结构与类型来自实测；编号、名称、金额和业务数值已替换，数组仅保留一项。
JSON 复制
{
"code": 0,
"message": "ok",
"data": {
"id": 10001,
"goods_id": "10001",
"status": 3,
"customer_id": 10001,
"selling_price": "1.00",
"amount": 0,
"buy_params": [
{
"description": "示例内容",
"is_default": false,
"key": "示例内容",
"name": "示例名称",
"type": 0,
"type_config": "",
"value": "https://example.com/image.png",
"verify": {
"max": 0,
"min": 0
}
}
],
"buy_number": "1",
"refund_amount": 0,
"start_num": 0,
"current_num": 100,
"card_code_ids": null,
"create_time": 1760000000,
"ip": "192.0.2.1",
"remark": "",
"goodsName": "示例名称",
"status_changes": [
{
"At": "示例内容",
"Name": "示例名称"
}
],
"refundNumber": 0,
"params": "[{\"alias\":\"示例内容\",\"name\":\"示例名称\",\"value\":\"https://example.com/image.png\"}]",
"logs": "[{\"content\":\"示例内容\",\"createdAt\":\"示例内容\"}]",
"cardNumber": ""
}
}原文响应定义对照 原文未提供成功响应正文。
调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/openapi/supplier/Order/Show',
method="POST",
body={'id': 7},
family="yile"
)
print(response)原文地址与失败响应说明 127.0.0.1:9991/openapi/supplier/Order/Show
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
亿乐 API / 供应商
订单进度修改 原文定义 · 未验证写入
POST /openapi/supplier/Order/ScheduleHandle复制
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"id": 7,
"start_num": 10,
"current_num": 100,
"remark": "sdfsdfsadfdfsfdsfsd"
}成功响应（原文） 原文未提供成功响应正文。
调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/openapi/supplier/Order/ScheduleHandle',
method="POST",
body={'id': 7,
'start_num': 10,
'current_num': 100,
'remark': 'sdfsdfsadfdfsfdsfsd'},
family="yile"
)
print(response)原文地址与失败响应说明 127.0.0.1:9991/openapi/supplier/Order/ScheduleHandle
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。
亿乐 API / 供应商
订单状态更改 原文定义 · 未验证写入
POST /openapi/supplier/Order/StatusHandle复制
new_status = 8 表示已退款，refund_number 必传；4 表示补单中。请使用亿乐订单状态表，不要混用易客 state。状态更改接口未执行，允许的状态转换仍需按业务规则确认。
请求说明 Content-Type 原文值：json。当前查询示例按实际验证的传输方式编写。
Body 参数 请求正文 JSON 复制
{
"old_status": 3,
"new_status": 8,
"id": 7,
"remark": "111111",
"refund_number": 1
}请求示例说明 old_status = 3 表示原状态为处理中。 new_status = 8 表示目标状态为已退款，此时 refund_number 必传。 成功响应（原文） 原文未提供成功响应正文。
调用示例 使用公共 Python 调用函数 。商品和订单编号为占位示例，需替换为当前账户下的有效编号。
PYTHON 复制
response = request_api(
'/openapi/supplier/Order/StatusHandle',
method="POST",
body={'old_status': 3,
'new_status': 8,
'id': 7,
'remark': '111111',
'refund_number': 1},
family="yile"
)
print(response)原文地址与失败响应说明 127.0.0.1:9991/openapi/supplier/Order/StatusHandle
原文列出 HTTP 404 失败响应，但未提供正文。业务错误也可能通过 HTTP 200 返回，应同时检查业务 code。