Appearance
IMEI设备会员状态查询
用于查询指定IMEI设备的会员有效期状态(有效时间/逾期信息),支持GET和POST两种请求方式。参数仅需appid(应用ID)、imei(设备标识)、signature(应用签名),均为必填项,动态获取开发者标识无需手动传入。
请求地址 GET / POST
text
https://nobase.cn/api/code/imei_query请求参数
| 参数名 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| appid | query | string | ✅ 是 | 应用ID,填写从开发者中心获取的应用唯一标识 |
| imei | query | string | ✅ 是 | 设备IMEI标识,需符合8-20位数字/字母组合(大小写不敏感,无特殊字符) |
| signature | query | string | ✅ 是 | 应用签名,直接从后台复制获取,无需手动生成 |
返回示例
成功响应(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设备不存在!"
}返回数据结构
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码:200=查询成功;204=参数缺失/错误;404=开发者/应用状态异常;407=IMEI不存在/应用配置缺失 |
| msg | string | 状态描述:success=成功,fail=失败 |
| data | object | 查询结果:含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)}")注意事项
- 接口功能说明:此接口仅用于“查询IMEI设备的会员状态”,不涉及卡密充值;若需充值,需使用之前的
/api/code/imei_recharge接口。 - 参数校验逻辑:
imei需符合8-20位数字/字母组合,含特殊字符会返回“IMEI格式错误”;
- 返回状态解读:
imei_vip为“YYYY-MM-DD HH:MM:SS”表示会员有效;- 为“已逾期(X天/月)”表示会员已过期,X为逾期时长。
- 设备标识扩展建议:若需支持非IMEI标识(如MEID、SN码),并同步修改接口的查询逻辑(替换
imei为目标标识字段)。

