Linksfield Developer
OverviewCube APIsTopup APIs
旧版本API
OverviewCube APIsTopup APIs
旧版本API
  1. Bundle-groups
  • Mall全局说明
  • Mall业务流程
  • Mall签名代码示例
  • APP调用Stripe的SDK示例说明
  • Vshop
    • 卡片登录验证
      POST
    • 获取可购套餐商品列表
      POST
    • 创建用户订单
      POST
    • 查询正在使用、未启用订单
      POST
    • 获取生效中的自动续费
      POST
    • 关闭自动续费
      POST
    • 用户下单(第三方支付)
      POST
  • Payment
    • 获取stripe单次支付权限
      POST
    • 获取Stripe订阅支付权限
      POST
    • 创建Stripe订阅/自动续费
      POST
    • 支付结果查询
      POST
  • Notification
    • 充值成功消息推送
      POST
  • Bundle-groups
    • 添加SIM卡至指定分组
      POST
    • 从指定分组删除SIM卡
      DELETE
    • 查询所有分组及套餐基本信息
      GET
    • 查询指定分组的 SIM 卡号
      GET
    • 异步结果获取
      GET
  • Order
    • 订单详情查询
      GET
  1. Bundle-groups

异步结果获取

Cube UAT
Cube UAT
GET
/async-result/{request_id}

适用场景#

适用于客户端在调用异步操作接口(如“添加SIM卡至指定分组”或“从指定分组删除SIM卡”)后,查询该异步任务的执行状态与最终结果;

必要条件#

1.
请求方法必须为 GET;
2.
Query中所有非null参数以key value的JSON String按字典序排列作为签名的数据;
3.
将signContent数据使用md5算法进行加密(默认32位小写字母+数字)
4.
request_id 为异步操作接口(如添加/删除SIM卡)响应头中返回的唯一任务标识;
5.
支持查询以下两类异步操作的结果:
添加SIM卡至指定分组action_code = 70
从指定分组删除SIM卡action_code = 71;

注意事项#

1.
request_id 由“添加SIM卡至指定分组”和“从指定分组删除SIM卡”接口在 响应头中返回,调用方需妥善保存以用于后续查询;
2.
该接口仅用于查询异步任务结果,不触发任何业务操作;
3.
返回的 SIM 卡数量为“按次计数”,即每次添加操作均计入总数,不进行去重统计,需注意重复添加可能导致数量超限;

业务规则#

1.
支持查询系统明确支持的异步操作类型(当前限定为 action_code 70 和 71);

请求参数

Path 参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/async-result/?version=undefined&partnerCode=undefined&sign=undefined' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
  "data": {
    "request_id": "RQ-20231001123456",
    "action_code": "70",
    "status": "completed",
    "details": [
      {
        "sim_id": "89852202306250040073",
        "result": "10",
        "message": "success"
      },
      {
        "sim_id": "89852202306250040074",
        "result": "31",
        "message": "The SIM card does not exist."
      }
    ]
  },
  "operateCode": "S",
  "message": "success"
}
🟢200success
修改于 2026-01-29 05:46:01
上一页
查询指定分组的 SIM 卡号
下一页
订单详情查询
Built with