异步结果获取

适用场景

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

必要条件

请求方法必须为 GET；

Query中所有非null参数以key value的JSON String按字典序排列作为签名的数据；

将signContent数据使用md5算法进行加密（默认32位小写字母+数字）

request_id 为异步操作接口（如添加/删除SIM卡）响应头中返回的唯一任务标识；

支持查询以下两类异步操作的结果：

添加SIM卡至指定分组action_code = 70

从指定分组删除SIM卡action_code = 71；

注意事项

request_id 由“添加SIM卡至指定分组”和“从指定分组删除SIM卡”接口在响应头中返回，调用方需妥善保存以用于后续查询；

该接口仅用于查询异步任务结果，不触发任何业务操作；

返回的 SIM 卡数量为“按次计数”，即每次添加操作均计入总数，不进行去重统计，需注意重复添加可能导致数量超限；

业务规则

支持查询系统明确支持的异步操作类型（当前限定为 action_code 70 和 71）；

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
  "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"
}

适用场景#

必要条件#

注意事项#