yile接口
后台接口：
---------------------------
更改订单状态接口(需要主站长账号权限，主站要有接口权限)
更改订单状态（可批量更新），如需退款/退单请用订单退款退单接口,如需更新订单数据请用更改订单数量接口
注意：已完成 已退单 已退款订单使用此接口无效
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/order/status POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
ids string 是 128 订单号码，多个用,隔开 10010,10015,10016
status int 是 3 订单状态码：0 待处理 1 处理中 2退单中 3 有异常 4 补单中 90 已完成 90
remark string 否 128 订单备注，可为空
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
响应示例
{
"status": 0,
"message": "操作成功"
}
--------------------------------------------
获取订单详情接口(需要主站长账号权限，主站要有接口权限)
查询某条订单详情，包括对接信息和对接状态(需要主站长账号权限，主站要有接口权限)
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/order/info POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
id int 否 11 订单号（id和ids参数不能同时为空，优先以id为主） 10010
ids string 否 11 订单号列表,用于批量查询，多个用,隔开（id和ids参数不能同时为空，优先以id为主） 10010,10011,10012
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
data object或array 否 0 订单详情(批量查询时返回包含订单详情的数组) 见示例
响应示例
{
"status": 0,
"message": "",
"data": {
"id": 48, //订单号码
"status": 90, //订单状态码
"num": 1, //下单数量
"start_num": 0, //初始数量
"now_num": 0, //现在数量
"gid": 3094, //商品编号
"model_id": 1016, //下单模型编号
"value1": "123456", //下单参数1
"value2": null,
"value3": null,
"value4": null,
"value5": null,
"value6": null,
"join_status": 2, //对接状态 0 自营订单 1 对接成功 2 对接失败 3 等待对接
"money": "103.000000" //订单金额,
"remark": null //订单备注,
"created_at": "2018-08-20 19:52:53", //下单时间
"join": { //当无对接信息（自营或等待对接）时为null。
"id": 48, //订单号码
"jid": 9, //对接配置编号
"kind": "YiLe", //对接平台
"order_id": 0, //网站订单ID 为0代表失败。
"domain": "www.baidu.cn", //网站域名
"info": "请确保下单数量在(1000-100000000)之间", //对接失败原因
"updated_at": "2018-08-24 10:17:12" //最后一次对接时间
}
}
}
----------------------------------------------------------------------------
获取订单列表接口(需要主站长账号权限，主站要有接口权限)
用户获取站点的订单列表，接口不要频繁使用，否则可能被服务器永久性拦截！此接口数据有缓存，10秒内的重复请求会显示缓存内容！
**提示：如需获取最新订单，请尽量不要使用此接口，可以使用商品订单自动通知接口！去后台》商品列表》通知 设置通知地址！**
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/order/list POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
page int 是 2 第几页数据 1
pageSize int 是 3 每页数量，可选10,20,50,100,200 10
gid int 否 11 商品编号，为空则获取所有商品订单 1001
status int 是 3 订单状态码：0 待处理 1 处理中 2退单中 3 有异常 4 补单中 5 已更新 90 已完成 91 已退单 92 已退款 0
id int 否 11 订单号，为空则获取所有订单 10001
join_status int 否 2 对接状态，为空则获取所有。0 自营订单 1 对接成功 2 对接失败 3 等待对接
orderBy string 否 5 排序规则 asc 按ID正序排序，desc按ID倒序排序，默认desc desc
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
data array 否 0 订单列表 见示例
响应示例
{
"status": 0,
"message": "",
"data": [
{
"id": 10, //订单号码
"gid": 3071, //商品编号
"model_id": 1016, //下单模型编号
"value1": "123456", //下单参数1
"value2": null, //下单参数2
"value3": null, //下单参数3
"value4": null, //下单参数4
"value5": null, //下单参数5
"value6": null, //下单参数6
"num": 100, //下单数量
"start_num": 82087, //初始数量
"now_num": 82087, //当前数量
"status": 0, //订单状态码
"join_status": 0, //订单对接状态
"remark": null, //订单备注
"created_at": "2018-07-20 17:37:01", //下单时间
}
]
}
-------------------------------------------------------------
更改订单数量接口(需要主站长账号权限)
更改订单数量（可批量更新）,如只更新订单状态请用 更改订单状态接口
注意：已完成 已退单 已退款订单使用此接口无效
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/order/num POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
list json 是 0 要更新的订单列表 见下面示例
list参数示例
标准JSON格式列表数据，中文字符用UTF-8编码，
[
{
"id": 10050, //订单号(必须)
"status": 90, //订单状态码(必须)：0 待处理 1 处理中 2退单中 90 已完成 -1不更改订单状态
"start_num": 100, //初始数量(可为空)
"now_num": 500 //当前数量(必须)
},
{
"id": 10051,
"status": 1,
"now_num": 500
},
{
"id": 10052,
"status": 1,
"now_num": 1500
}
]
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
响应示例
{
"status": 0,
"message": "操作成功"
}
-----------------------------
订单退款或者退单接口(需要主站长账号权限，主站要有接口权限)
订单退款或者退单
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/order/refund POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
id int 是 11 订单号码 10010
status int 是 3 订单状态码：91 退单 92 退款 91
type int 是 3 退款方式 0 按数量退款，1按百分比退款，2按退款金额退款 0
num int 否 11 type=0时为退款数量，type=1时为百分比小数，type=2时为退款金额，退款时必须传递此参数，退单时可为空 25
remark string 否 128 订单备注，可为空
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
响应示例
{
"status": 0,
"message": "操作成功"
}
-------------------------------------
订单重新对接接口(需要主站长账号权限)
对接失败订单重新对接
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/order/repeatJoin POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
id int 是 11 订单号码 10010
type int 是 3 对接方式 0 添加进对接队列（异步对接） 1立即重新对接并返回对接结果（对接时间过长会导致接口返回时间过长，且容易超时）2 手动填写对接订单ID 0
order_id int 否 11 对接站订单ID(当type=2时必填此参数) 1
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
id int 是 11 对接成功后对接站订单ID（当type=1 且对接成功时才有此参数） 10010
响应示例
{
"status": 0,
"message": "设置重新对接成功，请耐心等待执行"
}
-----------------------------------------------
修改商品信息接口(需要主站长账号权限，主站要有接口权限)
修改商品信息接口
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/goods/update POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
gid int 是 11 商品编号 1001
price float 否 10 商品定价，不修改则留空 0.00015
close int 否 1 是否关闭商品下单 0不关闭 1关闭 不修改则留空 0
limit_min int 否 11 最低下单数量，不修改则留空 100
limit_max int 否 11 最高下单数量，不修改则留空 100000
rate int 否 11 下单数量必须是此数的整倍数，不修改则留空 100
jid int 否 11 对接配置编号(后台对接配置列表查看)，不修改则留空 18
post string 否 255 对接post，不修改则留空 zh=[value1]&need_num_0=[num]&goods_id=16744&goods_type=213
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
响应示例
{
"status": 0,
"message": "操作成功"
}
------------------------------
用户加款(需要主站长账号权限)
为用户加款接口
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/add/rmb POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
uid int 是 11 用户编号 1001
rmb float 是 6 加款金额，最低0.01 0.01
remark int 否 255 加款备注 ，可为空
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
响应示例
{
"status": 0,
"message": "加款成功"
}
---------------------------
用户密价查询(需要主站长账号权限)
查询用户的密价规则
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/user/mj/list POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
uid int 是 11 用户编号 1001
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
data array 否 0 订单列表 见示例
响应示例
{
"status": 0,
"message": "",
"data": [
{
"id": 8, //密价规则编号
"mid": 100, // 站点编号
"uid": 100, //系统用户唯一编号(不同于用户编号)
"kind": 0, //密价规则了类型 0成本价+百分比加价 1成本价+固定价格加价 2设置固定密价
"gid": 0, //指定商品编号 0则针对所有商品
"rate": "1.000000", //设定值
"created_at": "2018-09-05 10:43:33",
"updated_at": "2018-09-05 10:43:33",
"goods": { //商品信息，指定商品时则有数据
"gid": 3190, //商品编号
"name": "测试商品", //商品名称
"price": "1.000000", //商品成本价格
"can_mj": 0 //商品是否能密价 0不能 1可以
}
}
]
}
-----------------------------
用户密价修改和添加(需要主站长账号权限)
修改或添加用户的密价规则
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/user/mj/store POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
id int 否 11 密价规则编号，修改密价规则时必须传递此参数，添加规则则不用传递
uid int 是 11 用户编号 1001
gid int 是 11 指定商品编号 0则针对所有商品 0
kind int 是 3 密价规则了类型 0成本价+百分比加价 1成本价+固定价格加价 2设置固定密价 0
rate float 是 8 设定值 0.015
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
响应示例
{
"status": 0,
"message": "添加成功"
}
-----------------------
用户密价规则删除(需要主站长账号权限)
删除用户的密价规则
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/user/mj/delete POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
id int 是 11 密价规则编号 10
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
响应示例
{
"status": 0,
"message": "删除成功"
}
前台接口
签名计算方法
将所有传递的参数名（不包含sign和参数值为空的参数）按照字母升序排序，然后进行拼接，然后再取其MD5码。
举例：要传递的参数是：api_token=100×tamp=1531745059&gid=10001&action=test 则签名计算方式为：md5(action=test&api_token=100&gid=10001×tamp=1531745059用户密匙)
注意：签名时，参数值为空的参数不参与签名计算 注意：所有请求UA不能为空，最好包含 YiLeSheQu 字符串 注意：传递所有参数中文内容必须使用UTF-8编码
PHP签名计算示例
/**
* @param $param array 要签名的参数数组
* @param $key string 用户密匙
* @return string
*/
function getSign($param, $key)
{
$signPars = "";
ksort($param);
foreach ($param as $k => $v) {
if ("sign" != $k && "" !== $v) {
$signPars .= $k . "=" . $v . "&";
}
}
$signPars = trim($signPars, '&');
$signPars .= $key;
$sign = md5($signPars);
return $sign;
}
$params = [
'api_token' => 1000,
'timestamp' => '1534471761',
'gid' => 1000
];
$key = "b9f781de4c96e915ae8ba5fd9144f3aa";
$sign = $this->getSign($params, $key);
echo $sign;//打印签名结果
易语言签名计算示例
.子程序 sign计算, 文本型, 公开
.参数 param, 文本型
.参数 key, 文本型
.局部变量 signpars, 文本型
.局部变量 分割, 文本型, , "0"
.局部变量 x, 整数型
.局部变量 k, 文本型
.局部变量 v, 文本型
.局部变量 sign, 文本型
分割 ＝ 分割文本 (param, “&”, )
数组_排序 (分割, 0, )
.计次循环首 (取数组成员数 (分割), x)
k ＝ 文本_取左边 (分割 [x], “=”, , )
v ＝ 文本_取右边 (分割 [x], “=”, , )
.如果真 (k ≠ “sign” 且 v ≠ “”)
.如果 (x ＝ 取数组成员数 (分割))
signpars ＝ signpars ＋ k ＋ “=” ＋ v
.否则
signpars ＝ signpars ＋ k ＋ “=” ＋ v ＋ “&”
.如果结束
.如果真结束
.计次循环尾 ()
signpars ＝ signpars ＋ key
sign ＝ 取数据摘要 (到字节集 (signpars))
返回 (sign)
----------------
商品列表接口
此接口用于用户下单
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/goods/list POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
data array 否 0 商品列表 见示例
响应示例
{
"status": 0,
"message": "",
"data": [
{
"gid": 1002, //商品编号
"cid": 57, //商品分组编号
"name": "**名片", //商品名称
"image": "http://assets.yilep.com/upload/img/396/180505/bee83e75dc48defa4fe1742e9e135586.png", //商品图片地址
"model_id": 1027 //商品下单模型编号
"close": 0 //商品是否关闭下单 0 未关闭 1关闭下单
},
{
"gid": 1005,
"cid": 58,
"name": "**空间",
"model_id": 1014
}
]
}
----------------------
商品信息接口
用户获取某一商品详细信息和下单所需参数
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/goods/info POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
gid int 是 11 商品编号 1001
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
data object 否 0 商品信息 见示例
响应示例
{
"status": 0,
"message": "",
"data": {
"gid": 3071, //商品编号
"cid": 57, //商品分类编号
"model_id": 1016,
"name": "**名片", //商品名称
"desc": "商品介绍", //商品介绍
"image": "http://assets.yilep.com/upload/img/396/180505/bee83e75dc48defa4fe1742e9e135586.png", //商品图片地址
"inputs": [ //商品参数列表,有几个则需要传递几个参数
[
"QQ号码", //参数名称
"输入QQ号码", //参数输入提示
"QQ"
]
],
"price": "0.000107", //商品价格
"limit_min": "100", //最低下单数量
"limit_max": "100000", //最高下单数量
"rate": "100", //下单数量必须是此数值的整数倍
"close": 0, //商品是否关闭下单 0 未关闭 1关闭下单
"allow_gm":[ // 允许改密的订单状态（仅仅适合有密码的订单）
"0",
"1",
"2",
],
"allow_bd": [ //允许补单的订单状态
"0",
"1",
"2"
],
"allow_td": [ //允许退单的订单状态
"0"
]
}
}
----------------------
查询订单接口
查询用户某条订单详情
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/order/query POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
id int 否 11 订单号（id和ids参数不能同时为空，优先以id为主） 10010
ids string 否 11 订单号列表,用于批量查询，多个用,隔开（id和ids参数不能同时为空，优先以id为主） 10010,10011,10012
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
data object或array 否 0 订单详情(批量查询时返回包含订单详情的数组) 见示例
响应示例
{
"status": 0,
"message": "",
"data": {
"id": 48, //订单号码
"status": 90, //订单状态码
"num": 1, //下单数量
"tnum": 0, //退款|退单数量
"start_num": 0, //初始数量
"now_num": 0, //现在数量
"gid": 3094, //商品编号
"model_id": 1016, //下单模型编号
"value1": "123456", //下单参数1
"value2": null,
"value3": null,
"value4": null,
"value5": null,
"value6": null,
"remark": null //订单备注,
"created_at": "2018-08-20 19:52:53", //下单时间
}
}
--------------------------
订单操作接口
订单申请退款&补单
请求地址
请求地址 请求方式
http://社区域名.api.94sq.cn/api/order/action POST
公共请求参数
参数 类型 是否必填 最大长度 描述 示例值
api_token int 是 11 用户的TokenID 1001
timestamp string 是 10 发送请求时北京时间时间戳（秒） 1531745059
sign string 是 32 请求参数的签名串 ，具体签名方法查看签名计算 b9f781de4c96e915ae8ba5fd9144f3aa
请求参数
参数 类型 是否必填 最大长度 描述 示例值
id int 是 11 订单号 10010
status int 是 3 订单操作 2退单 4补单 5改密 2
password string 否 32 修改订单密码 （status=5时此参数必填，仅仅对有密码内容的订单有效） 2
响应参数
参数 类型 是否必填 最大长度 描述 示例值
status int 是 3 请求状态码,0 成功 其他失败 0
message string 是 128 请求状态码描述 操作成功
响应示例
{
"status": 0,
"message": "操作成功"
}
