API 文档 – 单下单接口
概述
该接口用于用户提交单个订单。用户需提供必要的参数，并确保其余额足够支付订单费用。
接口信息
- 接口路径:
/api/order/add - 请求方式:
POST
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| uid | string | 是 | 用户唯一标识 |
| key | string | 是 | 用户接口密钥 |
| platform | string | 是 | 平台标识 |
| school | string | 是 | 学校名称 |
| user | string | 是 | 用户名 |
| pass | string | 是 | 密码 |
| kcid | string | 是 | 课程 ID |
| kcname | string | 是 | 课程名称 |
响应格式
接口返回 JSON 格式的响应。请求成功将返回状态码 0，失败则返回相应的错误码。
成功响应示例
{
"code": 0,
"msg": "提交成功",
"status": 0,
"message": "提交成功",
"id": "订单号登录后台自行查看，老子懒得写了"
}失败响应示例
{
"code": -1,
"msg": "你还没有开通接口哦"
}响应状态码说明
| 状态码 | 说明 |
|---|---|
| 0 | 成功 |
| -1 | 用户未开通接口 |
| -2 | 密钥错误 |
| -3 | 商品已下架 |
| -4 | 余额不足以提交 |
| -5 | 重复下单 |
| -6 | 输入信息不完整 |
业务逻辑
- 参数验证:
- 检查所有必填参数是否提供。
- 用户验证:
- 验证用户是否已开通接口及密钥的正确性。
- 课程状态验证:
- 检查课程是否下架。
- 价格计算:
- 根据课程价格和用户的额外费用进行价格计算。
- 应用密价规则调整价格。
- 订单提交:
- 检查用户余额是否足够。
- 检查是否重复下单。
- 插入新的订单记录。
- 扣除用户余额。
- 返回结果:
- 返回订单提交的结果。
注意事项
- 所有输入均需经过严格验证，防止SQL注入和其他安全风险。
- 用户需确保余额足以覆盖订单费用。
- 返回的订单号仅供后台查询，用户不需特别关注。
此文档仅供开发者参考，使用时请确保遵循相应的安全和性能最佳实践。
原创文章，作者：凹凸曼
，如若转载，请注明出处：https://www.studyace.club/827.html
