随着互联网技术的飞速发展,越来越多的企业开始关注移动通信领域的机会，为了满足市场需求，我们推出了“号易号卡分销系统”，旨在通过创新的商业模式和强大的技术支持，为广大用户提供便捷、高效的通讯服务。

在这个系统中,我们特别注重开放性和可扩展性，因此提供了丰富的API接口供第三方开发者使用，这些接口涵盖了从订单管理到财务管理等多个方面，使得开发者能够轻松地将我们的服务集成到自己的应用中，从而实现业务的快速增长。

本文将详细介绍号易号卡分销系统的API接口对接文档中心,包括各个接口的功能描述、参数说明以及调用示例等关键信息，希望通过这篇文章，能让更多的开发者了解并利用我们的资源，共同推动行业的进步与发展。

API接口概述

订单管理系统

a. 创建订单

  • 功能描述：允许用户下单购买号码或套餐。
  • 参数说明：
    • user_id：用户的唯一标识符（必填）。
    • product_id：要购买的产品的ID（必填）。
    • quantity：购买的数量（默认值为1）。
  • 调用示例：
    {
  "user_id": "123456789",
  "product_id": "1001",
  "quantity": 2
}

b. 查询单个订单详情

  • 功能描述：获取特定订单的状态和信息。
  • 参数说明：
    • order_id：需要查询的订单的唯一编号（必填）。
  • 调用示例：
    {
  "order_id": "00123456789"
}

c. 更新订单状态

  • 功能描述：修改已创建订单的状态，如支付成功、发货等。
  • 参数说明：
    • order_id：待更新的订单ID（必填）。
    • status：新的订单状态（可选值有pending, paid, shipped, completed）。
  • 调用示例：
    {
  "order_id": "00123456789",
  "status": "paid"
}

产品管理系统

a. 获取所有产品列表

  • 功能描述：列出当前可用的所有产品及其相关信息。
  • 参数说明：无额外请求参数。
  • 调用示例：
    {}

b. 新增/编辑产品信息

  • 功能描述：添加新产品或者对现有产品进行更新。
  • 参数说明：
    • product_id：目标产品的ID（新增时为空；编辑时需指定）。
    • name：产品的名称（必填）。
    • price：产品的价格（必填）。
    • description：产品的简要介绍（可选）。
  • 调用示例：
    {
  "product_id": "",
  "name": "豪华套餐",
  "price": 99.99,
  "description": "包含更多通话分钟数和网络流量"
}

用户管理系统

a. 注册新用户

  • 功能描述：为新用户提供账号注册功能。
  • 参数说明：
    • username：用户名（必填且唯一）。
    • password：密码（至少8位字符）。
    • email：邮箱地址（用于接收验证码）。
  • 调用示例：
    {
  "username": "newuser123",
  "password": "Password@123",
  "email": "newuser@example.com"
}

b. 登录验证

  • 功能描述：检查用户凭据是否正确，以完成登录过程。
  • 参数说明：
    • username：用户名（必填）。
    • password：密码（必填）。
  • 调用示例：
    {
  "username": "existinguser",
  "password": "CorrectPassword"
}

支付系统集成

a. 发起支付请求

  • 功能描述：向支付网关发送交易请求，等待响应以确认付款。
  • 参数说明：
    • amount：交易的金额（单位为元）。
    • currency：货币类型（默认人民币RMB）。
    • transaction_id：唯一的交易标识符。
  • 调用示例：
    {
  "amount": 10.00,
  "currency": "CNY",
  "transaction_id": "TXN1234567890"
}

b. 检查支付结果

  • 功能描述：根据提供的交易ID