API 文档

身份验证

所有 API 请求都需要身份验证。支持两种方法：

方法 1：DhruFusion 标准（POST 参数）

POST https://malenunlocker.net/api/index.php
Content-Type: application/x-www-form-urlencoded

username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=accountinfo

方法 2：WebX REST（Auth-Key 标头）

GET https://malenunlocker.net/api/account
Auth-Key: YOUR_API_KEY

API 密钥： 在设置 > API中生成 API 密钥。为了安全起见，您的 IP 将在首次连接时自动锁定。

DhruFusion API 端点

基本 URL： https://malenunlocker.net/api/index.php

替代 URL： https://malenunlocker.net/api 或 https://malenunlocker.net/dhru

所有请求都使用 POST 和表单编码参数。

accountinfo

获取账户余额和信息。

请求

POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=accountinfo

响应

{
  "SUCCESS": [{
    "MESSAGE": "Account info retrieved",
    "balance": "125.5000",
    "currency": "USD",
    "email": "your@email.com",
    "username": "your_username"
  }]
}

imeiservicelist

获取按类别分组的所有可用服务（IMEI、服务器和远程）。

请求

POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=imeiservicelist

响应

{
  "SUCCESS": [{
    "MESSAGE": "Service list retrieved",
    "LIST": [
      {
        "ID": 1,
        "SERVICENAME": "Samsung Galaxy Unlock",
        "GROUP": "Samsung",
        "GROUPTYPE": "IMEI",
        "PRICE": "5.00",
        "TIME": "1-24 hours",
        "INFO": "Supports all Samsung models"
      }
    ]
  }]
}

特定于类型的列表： 使用 getimeiservices, serverservicelist或 fileservicelist 来过滤列表。

placeimeiorder

下订单。根据服务 ID 自动检测服务类型（IMEI、服务器或远程）。

请求

POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=placeimeiorder
¶meters=BASE64_JSON

参数（base64 编码的 JSON）

字段	类型	必填	描述
`ID`	int	是	服务 ID
`IMEI`	string	是*	IMEI 号码（对于 IMEI 服务）
`USERNAME`	string	是*	用户名/帐户（对于服务器服务）
`QUANTITY`	int	否	数量（对于服务器服务，默认值：1）

* 必填字段取决于服务类型。

示例 (IMEI)

// Parameters JSON before base64:
{"ID": 1, "IMEI": "353272079261960"}

// Full request:
username=test@example.com
&apiaccesskey=abc123
&action=placeimeiorder
¶meters=eyJJRCI6IDEsICJJTUVJIjogIjM1MzI3MjA3OTI2MTk2MCJ9

响应

{
  "SUCCESS": [{
    "MESSAGE": "Order placed successfully",
    "REFERENCEID": "12345"
  }]
}

getimeiorder

获取订单状态和响应。自动检测订单类型。

请求

POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=getimeiorder
¶meters=BASE64_JSON

参数

{"ID": 12345}  // Order reference ID

响应

{
  "SUCCESS": [{
    "MESSAGE": "Order status retrieved",
    "ID": 12345,
    "STATUS": 4,
    "STATUSMSG": "Success",
    "CODE": "Unlock code: 12345678",
    "SERVICENAME": "Samsung Galaxy Unlock",
    "IMEI": "353272079261960"
  }]
}

WebX REST API

带 Auth-Key 标头身份验证的 RESTful API。

方法	端点	描述
`GET`	/api/account	帐户信息
`GET`	/api/imei-services	列出 IMEI 服务
`GET`	/api/server-services	列出服务器服务
`GET`	/api/file-services	列出文件/远程服务
`GET`	/api/imei-services/{id}	服务详细信息
`POST`	/api/imei-orders	下 IMEI 订单
`POST`	/api/server-orders	放置服务器订单
`POST`	/api/file-orders	放置文件/远程订单
`GET`	/api/imei-orders/{id}	获取 IMEI 订单状态
`GET`	/api/server-orders/{id}	获取服务器订单状态
`GET`	/api/file-orders/{id}	获取文件订单状态

订单状态

代码	状态	描述
`0`	新/等待	订单已收到，等待处理
`1`	处理中	订单发送给供应商，正在处理
`2`	已取消	订单已取消（退款）
`3`	已拒绝	供应商拒绝订单（已退款）
`4`	成功	订单已完成，代码/响应可用

错误处理

错误按以下格式返回：

{
  "ERROR": [{
    "MESSAGE": "Authentication failed: Invalid username or API key"
  }]
}

常见错误

错误	原因
需要身份验证	缺少用户名或 apiaccesskey
身份验证失败	凭证无效
API 访问已禁用	在“设置”>“API”中启用 API
IP 未授权	在“设置”> API 中重置 IP 锁定
无效操作	未知操作参数
无效服务	服务 ID 未找到或不活动
余额不足	积分不足

速率限制

API 请求限制为：

60 个请求/分钟 每个 IP 地址
120 个请求/分钟 每个 API 用户

每个响应中都包含速率限制标头：

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 115
Retry-After: 60  (only on 429)

当速率受到限制时，您将收到 429 Too Many Requests 响应。