号易号卡分销系统旨在为用户提供便捷、高效的号码购买和分发服务，为了满足广大开发者的需求，我们提供了详细的API接口对接文档中心，以便于第三方开发者能够轻松地集成我们的系统，实现无缝对接。

API接口概述

号易号卡分销系统的API接口涵盖了从账号注册到订单处理的各个方面,包括但不限于以下功能模块：

  1. 用户管理
  2. 订单管理
  3. 账户管理
  4. 商品管理
  5. 支付管理
  6. 分销管理
  7. 数据统计

每个模块下都包含了多个具体的API接口,以满足不同场景下的业务需求。

文档结构

我们的API接口文档采用了RESTful风格的设计原则,遵循简洁明了的原则，便于开发者理解和使用，以下是文档的结构安排：

  • 首页：简要介绍API接口的基本信息和使用指南。
  • API列表：列出所有可用的API接口及其对应的功能描述。
  • 接口详情：对每个API接口进行详细介绍，包括请求方法、参数说明、返回值等。
  • 示例代码：提供多种编程语言的调用示例，帮助开发者快速上手。

接口详情

用户管理

注册用户（POST）

POST /api/user/register

参数：

  • username （必填）: 用户名
  • password （必填）: 密码
  • email （可选）: 电子邮件地址
  • phone （可选）: 手机号码

返回值：

  • code : 状态码（0表示成功，其他数字表示失败）
  • message : 返回信息
  • data : 用户ID或错误信息

登录用户（POST）

POST /api/user/login

参数：

  • username （必填）: 用户名
  • password （必填）: 密码

返回值：

  • token : 访问令牌
  • user_id : 用户ID
  • message : 返回信息

订单管理

创建订单（POST）

POST /api/order/create

参数：

  • product_id （必填）: 产品ID
  • quantity （必填）: 数量
  • address （可选）: 收货地址
  • payment_method （可选）: 支付方式

返回值：

  • order_id : 订单ID
  • total_price : 总价格
  • message : 返回信息

查询订单（GET）

GET /api/order/{id}

参数：

  • id （必填）: 订单ID

返回值：

  • order_details : 订单详细信息
  • status : 订单状态
  • message : 返回信息

账户管理

充值账户（POST）

POST /api/account/recharge

参数：

  • amount （必填）: 充值金额
  • currency （可选）: 货币类型

返回值：

  • balance : 当前余额
  • message : 返回信息

提现申请（POST）

POST /api/account/withdrawal

参数：

  • amount （必填）: 提现金额
  • bank_info （必填）: 银行信息

返回值：

  • withdrawal_id : 提现ID
  • message : 返回信息

商品管理

查询商品列表（GET）

GET /api/product/list

参数：

  • category （可选）: 分类
  • keyword （可选）: 关键词搜索

返回值：

  • products : 商品列表
  • count : 商品总数
  • message : 返回信息

查询单个商品详情（GET）

GET /api/product/{id}

参数：

  • id （必填）: 商品ID

返回值：

  • product : 商品详情
  • message : 返回信息

支付管理

创建支付订单（POST）

POST /api/payment/create

参数：

  • order_id （必填）: 订单ID
  • payment_method （必填）: 支付方式

返回值：