Primeiros Passos

Do zero ao primeiro request em 5 minutos

Este guia mostra o caminho mínimo para integrar com a API Hooked: autenticar, confirmar o contexto e buscar dados reais.

https://api.app.hooked.com.br

Passo 1 — Autenticar e obter o token

Todas as rotas da API (exceto o próprio login) exigem um Bearer Token no header Authorization. Obtenha-o fazendo login:

POST /api/conta/login

Corpo da requisição:

{
  "email": "[email protected]",
  "password": "suaSenha"
}

Resposta:

{
  "success": true,
  "data": {
    "serviceToken": "eyJhbGci...",
    "user": { "id": "...", "nome": "...", "email": "..." }
  }
}

Guarde o valor de data.serviceToken — ele é o seu token.

O token expira após algumas horas. Quando qualquer endpoint retornar 401, repita o login para obter um novo token.

Exemplos de Código

cURL

curl -X POST "https://api.app.hooked.com.br/api/conta/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"suaSenha"}'

JavaScript

const res = await fetch('https://api.app.hooked.com.br/api/conta/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: '[email protected]', password: 'suaSenha' })
});
const { data } = await res.json();
const token = data.serviceToken;

Python

import requests

resp = requests.post(
    'https://api.app.hooked.com.br/api/conta/login',
    json={'email': '[email protected]', 'password': 'suaSenha'}
)
token = resp.json()['data']['serviceToken']

Go

package main

import (
    "bytes"
    "encoding/json"
    "io"
    "net/http"
)

body := []byte(`{"email":"[email protected]","password":"suaSenha"}`)
resp, _ := http.Post(
    "https://api.app.hooked.com.br/api/conta/login",
    "application/json",
    bytes.NewBuffer(body),
)
defer resp.Body.Close()
raw, _ := io.ReadAll(resp.Body)

var result map[string]interface{}
json.Unmarshal(raw, &result)
token := result["data"].(map[string]interface{})["serviceToken"].(string)

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/conta/login');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode(['email' => '[email protected]', 'password' => 'suaSenha']),
    CURLOPT_RETURNTRANSFER => true,
]);
$resp  = json_decode(curl_exec($ch), true);
$token = $resp['data']['serviceToken'];
curl_close($ch);

n8n

{
  "name": "Hooked API — Login",
  "nodes": [
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.app.hooked.com.br/api/conta/login",
        "sendBody": true,
        "contentType": "json",
        "specifyBody": "json",
        "jsonBody": "{\"email\":\"[email protected]\",\"password\":\"suaSenha\"}",
        "options": {}
      },
      "id": "node-1",
      "name": "Login",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [250, 300]
    }
  ],
  "connections": {},
  "pinData": {}
}

Passo 2 — Fazer o primeiro GET com dados reais

Agora busque uma lista de registros. Todos os endpoints de listagem seguem o mesmo padrão de paginação com pageNumber e pageSize:

GET /api/bancos?pageNumber=1&pageSize=10

Resposta:

{
  "currentPage": 1,
  "totalPages": 3,
  "pageSize": 10,
  "totalCount": 28,
  "hasPrevious": false,
  "hasNext": true,
  "data": [
    { "id": 1, "nome": "Banco do Brasil", "codigo": "001" },
    { "id": 2, "nome": "Bradesco", "codigo": "237" }
  ]
}

Exemplos de Código

cURL

curl "https://api.app.hooked.com.br/api/bancos?pageNumber=1&pageSize=10" \
  -H "Authorization: Bearer {token}"

JavaScript

const res = await fetch('https://api.app.hooked.com.br/api/bancos?pageNumber=1&pageSize=10', {
  headers: { 'Authorization': `Bearer ${token}` }
});
const { data, totalCount } = await res.json();

Python

resp = requests.get(
    'https://api.app.hooked.com.br/api/bancos',
    params={'pageNumber': 1, 'pageSize': 10},
    headers={'Authorization': f'Bearer {token}'}
).json()

Go

req, _ := http.NewRequest("GET", "https://api.app.hooked.com.br/api/bancos?pageNumber=1&pageSize=10", nil)
req.Header.Set("Authorization", "Bearer "+token)
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/bancos?pageNumber=1&pageSize=10');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $token],
    CURLOPT_RETURNTRANSFER => true,
]);
$resultado = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — Listar Bancos",
  "nodes": [
    {
      "parameters": {
        "method": "GET",
        "url": "https://api.app.hooked.com.br/api/bancos",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [{ "name": "Authorization", "value": "Bearer SEU_TOKEN_AQUI" }]
        },
        "sendQuery": true,
        "queryParameters": {
          "parameters": [
            { "name": "pageNumber", "value": "1" },
            { "name": "pageSize", "value": "10" }
          ]
        },
        "options": {}
      },
      "id": "node-1",
      "name": "Listar Bancos",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [250, 300]
    }
  ],
  "connections": {},
  "pinData": {}
}

Próximos passos

Postman — importar e testar →