Navigazione
Autenticazione Endpoint Informazioni account Elenco servizi Effettua ordine Ottieni stato ordine API REST WebX Stati degli ordini Gestione degli errori Limitazione della velocità

Documentazione API

API compatibile con DhruFusion V6.1 per servizi IMEI, server e sblocco remoto.

Autenticazione

Tutte le richieste API richiedono l'autenticazione. Sono supportati due metodi:

Metodo 1: DhruFusion Standard (parametri 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
Metodo 2: WebX REST (intestazione Auth-Key)
GET https://imei-unlock.net/api/account
Auth-Key: YOUR_API_KEY
Chiave API: Genera la chiave API in Impostazioni > API. Il tuo IP verrà bloccato automaticamente alla prima connessione per sicurezza.

Endpoint API DhruFusion

URL di base: https://imei-unlock.net/api/index.php

URL alternativi: https://imei-unlock.net/api o https://imei-unlock.net/dhru

Tutte le richieste utilizzano POST con parametri codificati nel modulo.

informazioni sull'account

Ottieni informazioni e saldo del conto.

Richiesta
POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=accountinfo
Risposta
{
  "SUCCESS": [{
    "MESSAGE": "Account info retrieved",
    "balance": "125.5000",
    "currency": "USD",
    "email": "your@email.com",
    "username": "your_username"
  }]
}

imeiservicelist

Ottieni tutti i servizi disponibili (IMEI, Server e Remoto) raggruppati per categoria.

Richiesta
POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=imeiservicelist
Risposta
{
  "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"
      }
    ]
  }]
}
Elenchi specifici per tipo: Usa getimeiservices, serverservicelisto fileservicelist per elenchi filtrati.

placeimeiorder

Effettua un ordine. Auto-detects service type (IMEI, Server, or Remote) from the service ID.

Richiesta
POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=placeimeiorder
¶meters=BASE64_JSON
Parametri (JSON con codifica base64)
CampoTipoObbligatorioDescrizione
IDintSìID servizio
IMEIstringSì*Numero IMEI (per servizi IMEI)
USERNAMEstringSì*Nome utente/Account (per servizi server)
QUANTITYintNOQuantità (per servizi server, impostazione predefinita: 1)

* Il campo obbligatorio dipende dal tipo di servizio.

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

// Full request:
username=test@example.com
&apiaccesskey=abc123
&action=placeimeiorder
¶meters=eyJJRCI6IDEsICJJTUVJIjogIjM1MzI3MjA3OTI2MTk2MCJ9
Risposta
{
  "SUCCESS": [{
    "MESSAGE": "Order placed successfully",
    "REFERENCEID": "12345"
  }]
}

getimeiorder

Get order status and response. Rileva automaticamente il tipo di ordine.

Richiesta
POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=getimeiorder
¶meters=BASE64_JSON
Parametri
{"ID": 12345}  // Order reference ID
Risposta
{
  "SUCCESS": [{
    "MESSAGE": "Order status retrieved",
    "ID": 12345,
    "STATUS": 4,
    "STATUSMSG": "Success",
    "CODE": "Unlock code: 12345678",
    "SERVICENAME": "Samsung Galaxy Unlock",
    "IMEI": "353272079261960"
  }]
}

API REST WebX

API RESTful con autenticazione dell'intestazione Auth-Key.

MetodoEndpointDescrizione
GET/api/accountInformazioni account
GET/api/imei-servicesElenco servizi IMEI
GET/api/imei-servicesElenco servizi server
GET/api/file-servicesElenco file/servizi remoti
GET/api/imei-services/{id}Dettagli servizio
POST/api/imei-ordersLuogo Ordine IMEI
POST/api/server-ordersInserisci ordine server
POST/api/imei-ordersInserisci ordine file/remoto
GET/api/imei-orders/{id}Ottieni stato ordine IMEI
GET/api/server-orders/{id}Ottieni stato ordine server
GET/api/file-orders/{id}Ottieni stato ordine file

Stati degli ordini

CodiceStatoDescrizione
0Nuovo / In attesaOrdine ricevuto, in attesa di elaborazione
1In elaborazioneOrdine inviato al fornitore, in elaborazione
2AnnullatoOrdine annullato (rimborsato)
3RifiutatoOrdine rifiutato dal fornitore (rimborsato)
4SuccessoOrdine completato, codice/risposta disponibile

Gestione degli errori

Gli errori vengono restituiti in questo formato:

{
  "ERROR": [{
    "MESSAGE": "Authentication failed: Invalid username or API key"
  }]
}
Errori comuni
ErroreCausa
Autenticazione richiestaNome utente o nome utente mancante apiaccesskey
Autenticazione non riuscitaCredenziali non valide
Accesso API disabilitatoAbilita API in Impostazioni > API
IP non autorizzatoReimposta blocco IP in Impostazioni > API
Azione non validaParametro di azione sconosciuto
Servizio non validoID servizio non trovato o inattivo
Saldo insufficienteCrediti insufficienti

Limitazione della velocità

Le richieste API sono limitate a:

  • 60 richieste/minuto per indirizzo IP
  • 120 richieste/minuto per utente API

Le intestazioni del limite di velocità sono incluse in ogni risposta:

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

Quando la velocità è limitata, riceverai una risposta 429 Too Many Requests .