APIs & Keys
Gerencie suas chaves e integre com a API do IHUB DEALS
Base URL
https://api.ihubdeals.com/api
Suas API Keys
Gerencie suas chaves de acesso para integrações
| Nome | API Key | Criada em | Status | Ações |
|---|---|---|---|---|
| Produção | ihub_sk_prod_••••••••••••7f3a | 15/03/2026 | Ativa |
|
| Desenvolvimento | ihub_sk_dev_••••••••••••2b8c | 20/03/2026 | Ativa |
|
Endpoints da API
Referência completa de todos os 27 endpoints disponíveis
Autenticação
4
POST
/api/auth/login
Fazer login e obter token JWT
Parâmetros
email
string
Sim
E-mail do usuário
password
string
Sim
Senha do usuário
Exemplo de Requisição
curl -X POST https://api.ihubdeals.com/api/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]","password":"sua_senha"}'
Exemplo de Resposta
{
"success": true,
"data": {
"token": "eyJhbGciOiJIUzI1NiIs...",
"user": { "id": 1, "name": "...", "email": "...", "role": "admin" }
}
}
POST
/api/auth/register
Criar nova conta
Parâmetros
name
string
Sim
Nome completo
email
string
Sim
E-mail
password
string
Sim
Senha (min 8 caracteres)
Exemplo de Requisição
curl -X POST https://api.ihubdeals.com/api/auth/register \
-H "Content-Type: application/json" \
-d '{"name":"Nome do Usuário","email":"[email protected]","password":"SenhaSegura@123"}'
Exemplo de Resposta
{
"success": true,
"data": {
"user": { "id": 2, "name": "Nome do Usuário", "email": "[email protected]", "role": "user" },
"token": "eyJhbGciOiJIUzI1NiIs..."
}
}
POST
/api/auth/logout
Encerrar sessao
Exemplo de Requisição
curl -X POST https://api.ihubdeals.com/api/auth/logout \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"message": "Sessao encerrada com sucesso"
}
GET
/api/auth/me
Obter dados do usuário logado
Exemplo de Requisição
curl -X GET https://api.ihubdeals.com/api/auth/me \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": {
"id": 1,
"name": "Nome do Admin",
"email": "[email protected]",
"role": "admin",
"created_at": "2026-01-15T10:30:00Z"
}
}
Dashboard
1
GET
/api/dashboard
Obter metricas e dados do dashboard
Exemplo de Requisição
curl -X GET https://api.ihubdeals.com/api/dashboard \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": {
"metrics": {
"deposits": 87560.00,
"revenue": 23735.00,
"cpa": 219,
"ftd": 184
},
"balance": 10500.00
}
}
Deals
3
GET
/api/deals
Listar todos os deals
Parametros (Query)
page
integer
Não
Pagina (default: 1)
limit
integer
Não
Itens por pagina (default: 20)
Exemplo de Requisição
curl -X GET https://api.ihubdeals.com/api/deals \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": [
{ "id": 1, "name": "Blaze CPA", "type": "CPA", "value": 150.00, "status": "active" },
{ "id": 2, "name": "Stake RevShare", "type": "RevShare", "value": null, "status": "active" }
],
"pagination": { "page": 1, "total": 12, "pages": 1 }
}
POST
/api/deals
Criar novo deal (admin)
Parâmetros
name
string
Sim
Nome do deal
type
string
Sim
CPA, RevShare ou Hybrid
value
number
Não
Valor do CPA
Exemplo de Requisição
curl -X POST https://api.ihubdeals.com/api/deals \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Novo Deal","type":"CPA","value":200.00}'
Exemplo de Resposta
{
"success": true,
"data": { "id": 3, "name": "Novo Deal", "type": "CPA", "value": 200.00, "status": "active" }
}
GET
/api/deals/{id}
Detalhes de um deal
Exemplo de Requisição
curl -X GET https://api.ihubdeals.com/api/deals/1 \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": {
"id": 1,
"name": "Blaze CPA",
"type": "CPA",
"value": 150.00,
"status": "active",
"affiliates": 45,
"created_at": "2026-01-10T08:00:00Z"
}
}
Afiliações
4
GET
/api/affiliations
Listar afiliações
Exemplo de Requisição
curl -X GET https://api.ihubdeals.com/api/affiliations \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": [
{ "id": 1, "deal": "Nome do Deal", "status": "approved", "tracking_code": "IHXXXXXXXXX" },
{ "id": 2, "deal": "Nome do Deal", "status": "pending", "tracking_code": "IHXXXXXXXXX" }
]
}
POST
/api/affiliations
Solicitar afiliação
Parâmetros
deal_id
integer
Sim
ID do deal
Exemplo de Requisição
curl -X POST https://api.ihubdeals.com/api/affiliations \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"deal_id": 1}'
Exemplo de Resposta
{
"success": true,
"data": { "id": 3, "deal": "Nome do Deal", "status": "pending", "tracking_code": "IHXXXXXXXXX" }
}
POST
/api/affiliations/{id}/approve
Aprovar afiliação
Exemplo de Requisição
curl -X POST https://api.ihubdeals.com/api/affiliations/3/approve \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"message": "Afiliação aprovada com sucesso"
}
POST
/api/affiliations/{id}/reject
Rejeitar afiliação
Exemplo de Requisição
curl -X POST https://api.ihubdeals.com/api/affiliations/3/reject \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"message": "Afiliação rejeitada"
}
Financeiro
4
GET
/api/financial
Saldo e resumo financeiro
Exemplo de Requisição
curl -X GET https://api.ihubdeals.com/api/financial \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": {
"balance": 10500.00,
"total_earned": 23735.00,
"total_withdrawn": 13235.00,
"pending_withdrawals": 0
}
}
GET
/api/financial/history
Extrato de transações
Exemplo de Requisição
curl -X GET "https://api.ihubdeals.com/api/financial/history?page=1&limit=20" \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": [
{ "id": 1, "type": "commission", "amount": 450.00, "description": "Blaze CPA", "date": "2026-03-27" },
{ "id": 2, "type": "withdrawal", "amount": -2000.00, "description": "Saque PIX", "date": "2026-03-26" }
]
}
POST
/api/financial/withdraw
Solicitar saque
Parâmetros
amount
number
Sim
Valor do saque
pix_key
string
Sim
Chave PIX
Exemplo de Requisição
curl -X POST https://api.ihubdeals.com/api/financial/withdraw \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"amount": 2000.00, "pix_key": "[email protected]"}'
Exemplo de Resposta
{
"success": true,
"data": { "id": 10, "amount": 2000.00, "status": "pending", "estimated_at": "2026-03-29" }
}
POST
/api/financial/process
Processar transacao (admin)
Parâmetros
transaction_id
integer
Sim
ID da transacao
action
string
Sim
"approve" ou "reject"
Exemplo de Requisição
curl -X POST https://api.ihubdeals.com/api/financial/process \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"transaction_id": 10, "action": "approve"}'
Exemplo de Resposta
{
"success": true,
"message": "Transacao processada com sucesso"
}
Relatórios
2
GET
/api/reports
Dados de relatórios
Parametros (Query)
date_from
string
Não
Data inicio (YYYY-MM-DD)
date_to
string
Não
Data fim (YYYY-MM-DD)
Exemplo de Requisição
curl -X GET "https://api.ihubdeals.com/api/reports?date_from=2026-03-01&date_to=2026-03-27" \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": {
"summary": { "deposits": 87560.00, "revenue": 23735.00, "cpa": 219, "ftd": 184 },
"daily": [
{ "date": "2026-03-27", "deposits": 12400.00, "revenue": 3200.00, "cpa": 32, "ftd": 28 }
]
}
}
GET
/api/reports/export
Exportar CSV
Parametros (Query)
date_from
string
Não
Data inicio
date_to
string
Não
Data fim
format
string
Não
csv (default)
Exemplo de Requisição
curl -X GET "https://api.ihubdeals.com/api/reports/export?date_from=2026-03-01&date_to=2026-03-27" \
-H "Authorization: Bearer SEU_TOKEN" \
-o relatorio.csv
Resposta
Content-Type: text/csv
Content-Disposition: attachment; filename="report_2026-03-01_2026-03-27.csv"
date,deposits,revenue,cpa,ftd
2026-03-27,12400.00,3200.00,32,28
2026-03-26,15200.00,4800.00,41,35
...
Usuários
5
GET
/api/users
Listar usuários
Exemplo de Requisição
curl -X GET https://api.ihubdeals.com/api/users \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": [
{ "id": 1, "name": "Nome do Admin", "email": "[email protected]", "role": "admin" },
{ "id": 2, "name": "Nome do Usuário", "email": "[email protected]", "role": "user" }
]
}
POST
/api/users
Criar usuário
Parâmetros
name
string
Sim
Nome completo
email
string
Sim
E-mail
password
string
Sim
Senha
role
string
Não
user, admin, manager
Exemplo de Requisição
curl -X POST https://api.ihubdeals.com/api/users \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Nome do Usuário","email":"[email protected]","password":"SenhaSegura@123","role":"user"}'
Exemplo de Resposta
{
"success": true,
"data": { "id": 3, "name": "Nome do Usuário", "email": "[email protected]", "role": "user" }
}
GET
/api/users/{id}
Dados do usuário
Exemplo de Requisição
curl -X GET https://api.ihubdeals.com/api/users/1 \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": {
"id": 1,
"name": "Nome do Admin",
"email": "[email protected]",
"role": "admin",
"created_at": "2026-01-15T10:30:00Z",
"affiliations": 5
}
}
PUT
/api/users/{id}
Atualizar usuário
Parâmetros
name
string
Não
Nome
email
string
Não
E-mail
role
string
Não
Role do usuário
Exemplo de Requisição
curl -X PUT https://api.ihubdeals.com/api/users/2 \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Nome Atualizado","role":"manager"}'
Exemplo de Resposta
{
"success": true,
"data": { "id": 2, "name": "Nome Atualizado", "email": "[email protected]", "role": "manager" }
}
GET
/api/users/tree
Árvore hierárquica
Exemplo de Requisição
curl -X GET https://api.ihubdeals.com/api/users/tree \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": {
"id": 1,
"name": "Nome do Admin",
"role": "admin",
"children": [
{ "id": 2, "name": "Nome do Usuário", "role": "user", "children": [] },
{ "id": 3, "name": "Nome do Usuário", "role": "user", "children": [] }
]
}
}
Perfil
2
GET
/api/profile
Dados do perfil
Exemplo de Requisição
curl -X GET https://api.ihubdeals.com/api/profile \
-H "Authorization: Bearer SEU_TOKEN"
Exemplo de Resposta
{
"success": true,
"data": {
"id": 1,
"name": "Nome do Admin",
"email": "[email protected]",
"phone": "+55 00 00000-0000",
"pix_key": "[email protected]",
"role": "admin",
"created_at": "2026-01-15T10:30:00Z"
}
}
PUT
/api/profile
Atualizar perfil
Parâmetros
name
string
Não
Nome
phone
string
Não
Telefone
pix_key
string
Não
Chave PIX
password
string
Não
Nova senha
Exemplo de Requisição
curl -X PUT https://api.ihubdeals.com/api/profile \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Nome do Admin","phone":"+55 00 00000-0000"}'
Exemplo de Resposta
{
"success": true,
"data": {
"id": 1,
"name": "Nome do Admin",
"phone": "+55 00 00000-0000",
"message": "Perfil atualizado com sucesso"
}
}
Playground
Execute chamadas diretamente no navegador e veja a resposta em tempo real
-- Status
// A resposta aparecera aqui
Guia de Integracao
Exemplos de integracao nas principais linguagens de programacao
const res = await fetch('https://api.ihubdeals.com/api/dashboard', {
headers: {
'Authorization': 'Bearer SUA_API_KEY'
}
});
const data = await res.json();
console.log(data.data.metrics);
import requests
headers = {
'Authorization': 'Bearer SUA_API_KEY'
}
r = requests.get(
'https://api.ihubdeals.com/api/dashboard',
headers=headers
)
print(r.json()['data']['metrics'])
$ch = curl_init('https://api.ihubdeals.com/api/dashboard');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer SUA_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = json_decode(
curl_exec($ch), true
);
print_r($response['data']['metrics']);
curl -X GET https://api.ihubdeals.com/api/dashboard \
-H "Authorization: Bearer SUA_API_KEY" \
-H "Content-Type: application/json"
