• 接口URL http://api.openluat.com/sim

  • 非GET方法的接口参数以FORM方式传递。

  • 认证方式为HTTP Basic Authorization,即在headers中增加Basic auth认证,填入appkey和appsecret。appkey和appsecret可在http://sim.openluat.com右上角个人信息页面查看。

  • 调用成功将返回HTTP/1.1 200。如果有附带数据,将以json格式返回,存入data字段中。

{
    "data": {
    "creation_time": "2017-03-27 17:23:49",
    "phone": "15021833372",
    "email": "xc@airm2m.com",
    "name": "xc",
    "last_login_time": "2017-04-06 16:22:54"
  }
}
  • 如果失败,返回相应的HTTP错误码,如401 Unauthorized,另外的错误信息以json格式返回。
{
    "code": 19,
    "msg": "设备已存在"
}

错误码说明:

code msg
1 操作失败
17 无权限

1.获取账户总览
  • GET /overview
{
    "total_cards": 30, // 总卡数
    "total_data_usage": 1755.5740159181878, // 总流量
    "activated_count": 27, // 激活数
    "not_activated_count": 3, // 未激活数
    "near_expiration": 0, // 一个月之内将到期的卡数
    "normal_count": 30, // 状态正常的卡数
    "shutdown_count": 0 // 停机的卡数
}

2.获取卡列表

  • GET /card

    参数 例子 备注
    page 0 页码,从0开始。
    page_size 20 每页数据量
    iccid_msisdn_search 123456 要搜索的iccid或msisdn
      {
          "data": {
              "card_list": [
                  {
                      "iccid": "898607B0101730045356",
                      "account_status": "00", // 卡状态 00 - 正常, 01 - 单项停机, 02 - 停机 03 - 预销号, 04 - 销号, 05 - 过户 06 - 休眠, 07 - 待激活, 99 - 未知
                      "data_plan_airm2m": 500, // 套餐
                      "data_usage": 471.669, // 已用流量
                      "expiry_date": "2018-06-30 00:00:00", // 到期日期
                      "msisdn": "1064705260452",
                      "data_balance_airm2m": 28.331 // 剩余流量
                  },
                  {
                      "iccid": "898607B0101730045357",
                      "account_status": "00",
                      "data_plan_airm2m": 500,
                      "data_usage": 402.497,
                      "expiry_date": "2018-06-30 00:00:00",
                      "msisdn": "1064705260453",
                      "data_balance_airm2m": 97.503
                  },
                  ...
              ]
          }
      }

3.获取单个卡信息

  • GET /card/<iccid>
{
    "iccid": "898607B0101730045357",
    "account_status": "00",
    "data_plan_airm2m": 500,
    "data_usage": 402.497,
    "expiry_date": "2018-06-30 00:00:00",
    "msisdn": "1064705260453",
    "data_balance_airm2m": 97.503
}