Документація API

DhruFusion V6.1, сумісний API для IMEI, сервера та Послуги дистанційного розблокування.


Аутентифікація

Усі запити API вимагають автентифікації. Підтримуються два методи:

Метод 1: DhruFusion Standard (параметри POST)
POST https://imei-unlock.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://imei-unlock.net/api/account
Auth-Key: YOUR_API_KEY
Ключ API: Згенеруйте свій ключ API у Налаштування > API. Вашу IP-адресу буде автоматично заблоковано під час першого підключення для безпеки.

Кінцеві точки API DhruFusion

Основна URL-адреса: https://imei-unlock.net/api/index.php

Альтернативні URL-адреси: https://imei-unlock.net/api або https://imei-unlock.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, сервер і Remote), згруповані за категоріями.

Запит
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

Оформити замовлення. Автоматично визначає тип служби (IMEI, сервер або Remote) за ідентифікатором служби.

Запит
POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=placeimeiorder
¶meters=BASE64_JSON
Параметри (JSON у кодуванні base64)
ПолеТипНеобхідноОпис
IDintТакІдентифікатор служби
IMEIрядокТак*Номер IMEI (для послуг IMEI)
USERNAMEрядокТак*Ім’я користувача/Обліковий запис (для послуг сервера)
QUANTITYintНіКількість (для послуг сервера, за замовчуванням: 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

RESTful API з автентифікацією заголовка Auth-Key.

МетодКінцева точкаОпис
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 не авторизованийСкиньте блокування IP у Налаштуваннях > API
Недійсний ДіяНевідомий параметр дії
Недійсна службаІдентифікатор служби не знайдено або неактивний
Недостатній балансНедостатньо кредитів

Обмеження швидкості

Запити API обмежені до:

  • 60 запитів/хвилину на IP-адресу
  • 120 запитів/хвилину на користувача API

Заголовки обмеження швидкості включені в кожну відповідь:

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

Якщо швидкість обмежена, ви отримаєте 429 Too Many Requests відповідь.