外单发单预检查接口 - 开放接口文档

应用场景：

拥有自主订单平台的第三方开发者，在正式调用发单接口（outerEntryOrder）前，可先调用本接口做发单条件预检查，提前发现「开发者无权限、签名错误、店铺不存在、站长不存在、专送条数不足」等问题，避免订单发入后才失败。

本接口仅做校验，不会创建任何订单、不会写入任何业务数据，可安全重复调用。

校验通过后，再调用发单接口完成正式发单。接口返回的 keloop_num 为当前扣费账号的剩余专送条数（实时快照，并发场景下仅供参考）。

发入条数的扣减对象由站点配置决定：站点设置为由商家承担条数且店铺已绑定商家账号时，校验商家条数；否则校验站长条数。

请求URL：

https://www.0xiao.com/keloop/api/entryOrderCheck

请求方式：

POST

支持 Content-Type: application/x-www-form-urlencoded（普通表单）或 application/json（JSON 请求体）；参数必须放在请求体中，放 URL Query 不参与签名校验。

请求参数：

参数名	必选	类型	说明	示例值
`developer_code`	是	`string`	开发者CODE（系统加密的开发者ID）	U2QHNB2w=
`shop_code`	是	`string`	关联店CODE：一般为加密店铺ID；开放平台类开发者（如小橙故事）传第三方店铺唯一标识	U2TD844B2
`timestamp`	是	`int`	秒级时间戳，与服务端时间差须小于 60 秒，否则返回「请求超时」	1792746000
`type`	是	`int`	开发者权限类型位，需与发单接口传值一致并具备对应权限位；常见 `128`（API发单）、`4096`（开放平台开发者）	128
`sign`	是	`string`	密钥签名（MD5，小写32位），生成规则见下方	8cd6ef22a13f73619c5f96d386e7a525

签名规则：

取除 sign 外的全部请求参数（只对实际提交的参数签名，不要额外补参数，否则签名不一致）。

按参数名 ASCII 升序排序（即 PHP ksort）。

拼成 key1=value1&key2=value2&... 形式，参数值不做 URL 编码。

字符串末尾直接拼接开发者密钥 appkey（中间不加 &）。

对整个字符串做 md5()，取小写32位。

示例（appkey 为示例密钥，非真实值）：

排序后：developer_code=U2QHNB2w=&shop_code=U2TD844B2&timestamp=1792746000&type=128
拼接密钥：developer_code=U2QHNB2w=&shop_code=U2TD844B2&timestamp=1792746000&type=1285f3c9d2a7b1e4c8f0a6d9b2e7c4f1a8d
sign = md5(上述字符串) = 8cd6ef22a13f73619c5f96d386e7a525

PHP 参考实现：

同步响应参数：

参数名	参数描述
`code`	状态码（100：请求成功、104：出现错误）
`message`	操作提示信息
`data.keloop_num`	当前扣费账号剩余专送条数（错误场景下无法确定时为 0）
`request_id`	请求追踪ID，排查问题时提供给技术支持

响应示例：

预检查成功

预检查失败（条数不足）

预检查失败（缺少参数）

错误提示对照：

message	触发原因
`请求超时`	`timestamp` 缺失或与服务端时间差 ≥ 60 秒（最先校验，缺 `timestamp` 也返回此提示）
`缺少请求参数`	`developer_code`、`shop_code`、`type`、`sign` 任一为空
`请求参数错误：您不是开发者或没有对应权限`	开发者不存在、被禁用，或 `type` 权限位不匹配
`签名错误`	签名计算不一致（参数增删、排序、URL 编码、密钥错误均会导致）
`当前店铺不存在`	`shop_code` 无法解析为有效店铺，或店铺已关闭
`当前平台站长不存在`	店铺所属站点无正常状态的站长
`外部订单当前平台未购买发入条数`	扣费账号（站长或商家）未购买专送发入条数
`外部订单当前平台发入条数不足`	剩余条数 ≤ 本次所需扣减条数（1条）

校验顺序（便于排查）：

时间戳超时

必填参数

开发者身份及权限位

签名

店铺

站长

专送条数