Documentação API
API compatível com DhruFusion V6.1 para IMEI, servidor e serviços de desbloqueio remoto.
Autenticação
Todas as solicitações de API requerem autenticação. Dois métodos são suportados:
Método 1: DhruFusion Standard (parâmetros 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
Método 2: WebX REST (cabeçalho Auth-Key)
GET https://imei-unlock.net/api/account
Auth-Key: YOUR_API_KEY
Endpoints da API DhruFusion
URL base: https://imei-unlock.net/api/index.php
URLs alternativos: https://imei-unlock.net/api ou https://imei-unlock.net/dhru
Todas as solicitações usam POST com parâmetros codificados em formulário.
accountinfo
Obtenha saldo e informações da conta.
Solicitação
POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=accountinfo
Resposta
{
"SUCCESS": [{
"MESSAGE": "Account info retrieved",
"balance": "125.5000",
"currency": "USD",
"email": "your@email.com",
"username": "your_username"
}]
}
imeiservicelist
Obtenha todos os serviços disponíveis (IMEI, Servidor e Remoto) agrupados por categoria.
Solicitação
POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=imeiservicelist
Resposta
{
"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, serverservicelistou fileservicelist para listas filtradas.
placeimeiorder
Faça um pedido. Detecta automaticamente o tipo de serviço (IMEI, Servidor ou Remoto) a partir do ID do serviço.
Solicitação
POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=placeimeiorder
¶meters=BASE64_JSON
Parâmetros (JSON codificado em base64)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ID | int | Sim | ID do serviço |
IMEI | string | Sim* | Número IMEI (para serviços IMEI) |
USERNAME | string | Sim* | Nome de usuário/Conta (para serviços de servidor) |
QUANTITY | int | Não | Quantidade (para serviços de servidor, padrão: 1) |
* O campo obrigatório depende do tipo de serviço.
Exemplo (IMEI)
// Parameters JSON before base64:
{"ID": 1, "IMEI": "353272079261960"}
// Full request:
username=test@example.com
&apiaccesskey=abc123
&action=placeimeiorder
¶meters=eyJJRCI6IDEsICJJTUVJIjogIjM1MzI3MjA3OTI2MTk2MCJ9
Resposta
{
"SUCCESS": [{
"MESSAGE": "Order placed successfully",
"REFERENCEID": "12345"
}]
}
getimeiorder
Obtenha o status e a resposta do pedido. Detecta automaticamente o tipo de pedido.
Solicitação
POST /api/index.php
username=your@email.com
&apiaccesskey=YOUR_API_KEY
&action=getimeiorder
¶meters=BASE64_JSON
Parâmetros
{"ID": 12345} // Order reference ID
Resposta
{
"SUCCESS": [{
"MESSAGE": "Order status retrieved",
"ID": 12345,
"STATUS": 4,
"STATUSMSG": "Success",
"CODE": "Unlock code: 12345678",
"SERVICENAME": "Samsung Galaxy Unlock",
"IMEI": "353272079261960"
}]
}
WebX REST API
API RESTful com autenticação de cabeçalho Auth-Key.
| Método | Endpoint | Descrição |
|---|---|---|
GET | /api/account | Informações da conta |
GET | /api/imei-services | Listar serviços IMEI |
GET | /api/server-services | Listar serviços de servidor |
GET | /api/file-services | Listar serviços de arquivo/remotos |
GET | /api/imei-services/{id} | Detalhes do serviço |
POST | /api/imei-orders | Fazer pedido de IMEI |
POST | /api/server-orders | Fazer pedido de servidor |
POST | /api/file-orders | Colocar arquivo/pedido remoto |
GET | /api/imei-orders/{id} | Obter status de pedido de IMEI |
GET | /api/server-orders/{id} | Obter status de pedido de servidor |
GET | /api/file-orders/{id} | Obter status de pedido de arquivo |
Status do pedido
| Código | Status | Descrição |
|---|---|---|
0 | Novo / Aguardando | Pedido recebido, aguardando processamento |
1 | Em processo | Pedido enviado ao fornecedor, em processamento |
2 | Cancelado | Pedido cancelado (reembolsado) |
3 | Rejeitado | Pedido rejeitado pelo fornecedor (reembolsado) |
4 | Sucesso | Pedido concluído, código/resposta disponível |
Tratamento de erros
Os erros são retornados neste formato:
{
"ERROR": [{
"MESSAGE": "Authentication failed: Invalid username or API key"
}]
}
Erros comuns
| Erro | Causa |
|---|---|
| Autenticação necessária | Nome de usuário ou apiaccesskey ausentes |
| Falha na autenticação | Credenciais inválidas |
| Acesso à API desativado | Ativar API em Configurações > API |
| IP não autorizado | Redefinir bloqueio de IP em Configurações > API |
| Ação inválida | Parâmetro de ação desconhecido |
| Serviço inválido | ID de serviço não encontrado ou inativo |
| Saldo insuficiente | Créditos insuficientes |
Limitação de taxa
Solicitações de API são limitadas a:
- 60 solicitações/minuto por endereço IP
- 120 solicitações/minuto por usuário da API
Os cabeçalhos de limite de taxa estão incluídos em cada resposta:
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 115
Retry-After: 60 (only on 429)
Quando a taxa é limitada, você receberá uma resposta 429 Too Many Requests .