Skip to content

IMEI设备会员状态查询

用于查询指定IMEI设备的会员有效期状态(有效时间/逾期信息),支持GET和POST两种请求方式。参数仅需appid(应用ID)、imei(设备标识)、signature(应用签名),均为必填项,动态获取开发者标识无需手动传入。

请求地址 GET / POST

text
https://nobase.cn/api/code/imei_query

请求参数

参数名位置类型必选说明
appidquerystring✅ 是应用ID,填写从开发者中心获取的应用唯一标识
imeiquerystring✅ 是设备IMEI标识,需符合8-20位数字/字母组合(大小写不敏感,无特殊字符)
signaturequerystring✅ 是应用签名,直接从后台复制获取,无需手动生成

返回示例

成功响应(IMEI存在且会员有效)

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "imei": "861234567890123456",
    "imei_vip": "2025-12-31 23:59:59",
    "imei_time": "2024-01-01 10:00:00"
  }
}

成功响应(IMEI存在但会员逾期)

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "imei": "861234567890123456",
    "imei_vip": "已逾期(30天)",
    "imei_time": "2024-01-01 10:00:00"
  }
}

失败响应(参数错误/IMEI不存在)

json
{
  "code": 204,
  "msg": "fail",
  "data": "接口参数错误:缺少imei"
}
json
{
  "code": 407,
  "msg": "fail",
  "data": "IMEI设备不存在!"
}

返回数据结构

参数名类型说明
codenumber状态码:200=查询成功;204=参数缺失/错误;404=开发者/应用状态异常;407=IMEI不存在/应用配置缺失
msgstring状态描述:success=成功,fail=失败
dataobject查询结果:含imei(设备标识)、imei_vip(会员状态,有效时间或逾期信息)、imei_time(设备创建时间)

代码示例

javascript
// 1. 配置参数
const appid = "your_app_id";
const imei = "861234567890123456"; // 目标IMEI
const signature = "signature_from_backend";

// 2. 构造POST参数
const params = new URLSearchParams({ appid, imei, signature });

// 3. 发起请求
fetch("https://nobase.cn/api/code/imei_query", {
  method: "POST",
  body: params,
  headers: { "Content-Type": "application/x-www-form-urlencoded" }
})
.then(res => res.json())
.then(res => {
  res.code === 200 
    ? console.log("IMEI会员状态:", res.data) 
    : console.error("查询失败:", res.data);
})
.catch(err => console.error("请求异常:", err));
javascript
// 1. 配置参数
const appid = "your_app_id";
const imei = "A1B2C3D4E5F6G7H8";
const signature = "signature_from_backend";

// 2. 拼接请求URL
const requestUrl = `https://nobase.cn/api/code/imei_query?appid=${appid}&imei=${imei}&signature=${signature}`;

// 3. 发起请求
fetch(requestUrl)
.then(res => res.json())
.then(res => {
  res.code === 200 
    ? console.log("IMEI会员状态:", res.data) 
    : console.error("查询失败:", res.data);
})
.catch(err => console.error("请求异常:", err));
python
import requests

# 1. 配置参数
params = {
    "appid": "your_app_id",
    "imei": "867654321098765432",
    "signature": "signature_from_backend"
}

# 2. 发起POST请求
url = "https://nobase.cn/api/code/imei_query"
try:
    res_data = requests.post(url, data=params, timeout=5).json()
    print(f"查询结果:{res_data['data']}")
except requests.exceptions.RequestException as e:
    print(f"请求异常:{str(e)}")
python
import requests

# 1. 配置参数
params = {
    "appid": "your_app_id",
    "imei": "D8E7F6G5H4I3J2K1L0",
    "signature": "signature_from_backend"
}

# 2. 发起GET请求
url = "https://nobase.cn/api/code/imei_query"
try:
    res_data = requests.get(url, params=params, timeout=5).json()
    print(f"查询结果:{res_data['data']}")
except requests.exceptions.RequestException as e:
    print(f"请求异常:{str(e)}")

注意事项

  1. 接口功能说明:此接口仅用于“查询IMEI设备的会员状态”,不涉及卡密充值;若需充值,需使用之前的/api/code/imei_recharge接口。
  2. 参数校验逻辑
    • imei需符合8-20位数字/字母组合,含特殊字符会返回“IMEI格式错误”;
  3. 返回状态解读
    • imei_vip为“YYYY-MM-DD HH:MM:SS”表示会员有效;
    • 为“已逾期(X天/月)”表示会员已过期,X为逾期时长。
  4. 设备标识扩展建议:若需支持非IMEI标识(如MEID、SN码),并同步修改接口的查询逻辑(替换imei为目标标识字段)。