Referência da API

API do Trunko

Consulte e gerencie seus conectores por REST — de um script, do seu painel interno, ou plugando o próprio Trunko como conector. JSON, uma chave, leitura e escrita.

basehttps://trunko.com.br/api/v1

Autenticação

Toda requisição precisa de uma chave. Gere uma em Perfil → API (aparece uma única vez). Envie de um dos dois jeitos:

# no header Authorization
curl https://trunko.com.br/api/v1/stats \
  -H "Authorization: Bearer trkpk_…"

# ou no header x-api-key
curl https://trunko.com.br/api/v1/stats -H "x-api-key: trkpk_…"

Limite de 120 req/min por chave (30/min nas escritas). Erros no formato { "error": "…" }.

Endpoints

GET/v1/meValidar a chave

Confirma que a chave é válida e resume a conta.

resposta

{
  "org": { "id": "org_…", "name": "Minha equipe" },
  "connectors": 3,
  "tools": 8
}

GET/v1/statsNúmeros da plataforma

Totais de conectores, ferramentas e chamadas.

resposta

{
  "connectors": 3,
  "tools": 8,
  "callsToday": 12,
  "callsTotal": 210
}

GET/v1/connectorsListar conectores

Seus conectores com saúde, uso e ferramentas expostas.

resposta

{
  "connectors": [
    {
      "id": "conn_…",
      "name": "Cotações",
      "health": "ok",
      "callsToday": 5,
      "lastCall": "2026-07-17T14:03:00Z",
      "toolsCount": 2,
      "tools": [
        { "name": "cotacao", "method": "GET",
          "description": "Cotação de um par, ex: USD-BRL." }
      ]
    }
  ]
}

POST/v1/connectorsCriar conector

Cria um conector via API. O token MCP é devolvido uma única vez — guarde-o.

corpo

{
  "name": "Meu ERP",
  "baseUrl": "https://api.meuerp.com",
  "auth": { "type": "bearer", "value": "…" },
  "tools": [
    { "name": "listar_pedidos", "method": "GET",
      "path": "/pedidos" }
  ]
}

resposta

{
  "id": "conn_…",
  "name": "Meu ERP",
  "endpoint": "…/mcp/conn_…",
  "token": "trk_…"   // aparece só aqui
}

DELETE/v1/connectors/{id}Apagar conector

Remove o conector e o histórico de chamadas dele.

parâmetros

idpath · obrigatório

id do conector (conn_…)

resposta

{ "ok": true }

GET/v1/connectors/{id}/callsChamadas de um conector

Histórico recente (ferramenta, status, latência, origem).

parâmetros

idpath · obrigatório

id do conector (conn_…)

limitquery

máx. de chamadas, 1–200 (padrão 50)

resposta

{
  "connector": { "id": "conn_…", "name": "Cotações" },
  "calls": [
    { "tool": "cotacao", "ok": true, "status": 200,
      "durationMs": 145, "source": "mcp",
      "at": "2026-07-17T14:03:00Z" }
  ]
}

GET/v1/usageUso agregado (14 dias)

Chamadas por conector, por origem e por hora (horário de Brasília).

resposta

{
  "days": 14,
  "byConnector": [
    { "connector": "Cotações", "calls": 62,
      "errors": 1, "avgMs": 152 }
  ],
  "bySource": { "mcp": 58, "test": 4 },
  "byHour": [ { "hour": 9, "calls": 12 }, … ]
}

Plugue o Trunko no Trunko

Esta API tem um OpenAPI público. Importe-o como conector e pergunte pra IA como está sua plataforma — a resposta vem dos seus próprios números.

/api/v1/openapi Pegar uma chave →