Plataforma para desenvolvedores

Desenvolva na
CouthActs.

Uma API de agentes e um servidor MCP para assistentes de IA, uma API de prestadores para sistemas de despacho e telemática e endpoints públicos para verificar registros de custódia assinados. JSON simples sobre HTTPS com chaves bearer.

Obter chaves de API Fale conosco

Chaves e limites

Escolha sua chave.

Chaves de agente

Sem taxa de plano

Para agentes e assistentes de IA que agem em nome de uma conta de cliente.

Permissões que você escolhe: cotação, serviços, reservas, carteira e confiança
Limites de gasto por serviço e mensais, além de um limite de aprovação
Até 120 requisições por minuto por chave
Crie em Configurações → Agentes de IA, ou conecte um assistente via OAuth

Criar uma chave de agente

API de prestadores

Plano Basic

Para prestadores que conectam seus próprios sistemas de despacho ou telemática.

Basic: 500 chamadas por mês; depois disso, as chamadas são recusadas
Serviços abertos, suas reservas, sua carteira e atualizações de localização
Professional (5.000 chamadas por mês) e Enterprise: em breve
Crie chaves em Configurações → Chaves de API de prestador

Gerenciar chaves de prestador

API de clientes

Sob consulta

Endpoints REST para os serviços, propostas e carteira de um cliente.

Starter: 1.000 chamadas por mês; depois disso, as chamadas são recusadas
Growth: 5.000 chamadas por mês e depois US$ 0,20 por chamada, cobrados da sua Carteira no mês seguinte
Enterprise: limites conforme acordado
As chaves ainda não são autoatendimento; a maioria dos clientes deve usar uma chave de agente

Fale conosco

Os planos pagos da API de prestadores (Professional e Enterprise) chegam em breve; fale conosco se precisar de limites maiores agora. Seu plano atual e seu uso aparecem em Configurações. As APIs são oferecidas sem compromisso de nível de serviço.

Início rápido

Três passos até sua primeira chamada.

Passo 01

Obtenha sua chave

Clientes e agentes de IA: Configurações → Agentes de IA. Prestadores: Configurações → Chaves de API de prestador. A chave completa aparece uma única vez, na criação.

Passo 02

Faça sua primeira requisição

Envie sua chave em Authorization: Bearer. Prestadores podem começar com GET /api/provider/v1/jobs.

Passo 03

Explore as ferramentas para agentes

Chaves de agente: leia a descrição OpenAPI em /api/agent/openapi.json ou conecte um cliente MCP a /api/mcp.

Requisição de exemplo

curl -X GET https://couthacts.com/api/provider/v1/jobs \
  -H "Authorization: Bearer ca_provider_your_key_here" \
  -H "Content-Type: application/json"

# Response
{
  "success": true,
  "data": [
    {
      "id": "clx...",
      "mode": "FREIGHT_TRUCKING",
      "title": "Freight: Dallas, TX → Houston, TX",
      "status": "OPEN",
      "originAddress": "Dallas, TX",
      "destinationAddress": "Houston, TX",
      "pickupDate": "2026-11-05T08:00:00.000Z",
      "budgetUsd": "2500",
      "insuranceTier": "NONE",
      "_count": { "bids": 3 }
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1, "pages": 1, "requestId": "…", "timestamp": "…" }
}

Endpoints

Referência completa.

Todos os valores nas respostas da API, dos agentes e do MCP estão em USD (campos terminados em Usd): a CouthActs cobra e paga somente em USD. Para mostrar um equivalente local, chame GET /api/currency/display uma vez por tela e multiplique: local ≈ amountUsd × rate. Mostre primeiro o valor em USD e o local como estimativa.

API de agentes e MCP

GET/api/agent/v1/tools
Lista as ações que sua chave de agente pode realizar, com os esquemas de entrada.
Chave de agente
POST/api/agent/v1/tools/{name}
Executa uma ação (por exemplo, get_quote ou post_job) dentro das permissões, limites de gasto e regras de aprovação da sua chave.
Chave de agente
GET/api/agent/openapi.json
Descrição OpenAPI 3.1 das ferramentas para agentes.
Nenhuma
POST/api/mcp
As mesmas ações pelo Model Context Protocol, para Claude, ChatGPT e outros assistentes compatíveis com MCP.
Chave de agente / OAuth

API de prestadores

GET/api/provider/v1/jobs
Serviços abertos nas suas modalidades de transporte cadastradas (filtráveis por modalidade; paginados).
Chave de API de prestador
GET/api/provider/v1/bookings
Suas reservas com status, código de rastreamento e status da retenção do pagamento.
Chave de API de prestador
POST/api/provider/v1/tracking
Informa uma localização de uma reserva ativa; ela aparece para o cliente e fica registrada no Registro de custódia.
Chave de API de prestador
GET/api/provider/v1/wallet
O saldo da sua carteira e as transações recentes.
Chave de API de prestador

API de clientes

GET · POST/api/v1/jobs
Lista seus serviços ou publica um serviço (cobra as taxas e retém o orçamento da sua Carteira).
Chave de API de cliente
GET · PATCH/api/v1/jobs/{id}
Consulta um serviço, altera o orçamento ou a descrição, ou o cancela.
Chave de API de cliente
GET · POST/api/v1/bids
Lista as propostas dos seus serviços, ou aceita ou recusa uma proposta.
Chave de API de cliente
GET/api/v1/wallet
O saldo da sua carteira.
Chave de API de cliente

Públicos (sem chave)

GET/api/track/{code}
Status, rota e eventos de rastreamento de uma reserva pelo código de rastreamento. Sem dados financeiros.
Nenhuma
GET/api/custody/public/{trackingCode}
Prova pública de que o Registro de custódia de uma reserva está íntegro (tipos de evento, horários, hashes e assinaturas).
Nenhuma
GET/api/credentials/provider/{id}
A credencial assinada de um prestador (status de verificação e histórico).
Nenhuma
GET/.well-known/couthacts-keys.json
As chaves públicas Ed25519 da CouthActs para verificar assinaturas.
Nenhuma
POST/api/trust/verify
Verifica um certificado de custódia ou uma credencial de prestador.
Nenhuma
GET/api/currency/display
A moeda de exibição do usuário e a cotação em relação ao USD (rate é null quando não há cotação ao vivo: mostre somente USD).
Nenhuma
GET/api/currency/supported
Moedas de exibição para um seletor: código, nome, símbolo e casas decimais.
Nenhuma

Rastreamento do prestador

Informe a localização pelos seus sistemas.

Envie uma localização de uma reserva confirmada ou em andamento. Ela aparece para o cliente em tempo real e fica registrada como ponto de verificação no Registro de custódia assinado. Você pode indicar a origem de cada leitura com um nome de camada. A CouthActs guarda essa etiqueta, mas não se conecta nem verifica por conta própria fontes AIS, de voo, ELD, de sensores ou de satélite: os dados são os que você informa.

Etiquetas de camada aceitas

MOBILE_GPS

GPS móvel

Uma posição de GPS do celular ou do veículo (padrão).

AIS_MARITIME

AIS (marítimo)

A posição de uma embarcação vinda da sua fonte AIS.

FLIGHT_TRACKING

Rastreamento de voo

A posição de uma aeronave vinda da sua fonte de rastreamento de voo.

ELD_INTEGRATION

ELD

A posição de um caminhão vinda do seu registrador eletrônico.

QR_PIN_CONFIRMATION

Entrega com PIN

Uma posição no momento da entrega. O PIN de entrega em si é digitado no app.

IOT_DEVICE

Dispositivo IoT

Uma posição do seu rastreador. Leituras de sensores não são armazenadas.

SATELLITE

Satélite

Uma posição do seu rastreador por satélite.

DOCUMENT_POD_AI

Comprovante de entrega

Apenas uma etiqueta de posição. A CouthActs não analisa documentos.

BIOMETRIC

Biometria

Apenas uma etiqueta de posição. A CouthActs não faz verificações biométricas na entrega.

Informar uma localização

POST /api/provider/v1/tracking
Authorization: Bearer ca_provider_your_key_here
Content-Type: application/json

{
  "bookingId": "clx...",
  "lat": 32.7767,
  "lng": -96.7970,
  "layer": "MOBILE_GPS",
  "status": "IN_TRANSIT",
  "note": "Departed Dallas warehouse"
}

Autenticação e segurança

Como o acesso é controlado.

Chaves bearer

Toda requisição precisa de Authorization: Bearer. As chaves são criadas em Configurações, aparecem uma vez e podem ser revogadas a qualquer momento.

Somente HTTPS

Envie chaves apenas por HTTPS. Nunca as inclua em código público ou em apps do lado do cliente.

Limites

Chaves de agente: 120 requisições por minuto. Chaves de API de prestador e de cliente: as chamadas mensais do plano, informadas nos cabeçalhos X-RateLimit-Limit e X-RateLimit-Remaining.

Registro de atividades

Cada ação de agente é registrada com ferramenta, status, valor, entradas e resultado, e aparece em Configurações. Chaves de prestador mostram o número de requisições e o último uso.

Limites de gasto e aprovações

Chaves de agente não podem ultrapassar o limite por serviço ou mensal, e ações acima do limite de aprovação aguardam a aprovação do titular (os pedidos expiram em 72 horas).

Registros assinados, não requisições assinadas

Os Registros de custódia e as credenciais de prestadores são assinados com a chave Ed25519 da CouthActs, para que qualquer pessoa possa verificá-los. Requisições e respostas da API não são assinadas, e a CouthActs não envia webhooks de saída.

Formato de resposta

Consistente. Previsível.

As respostas das APIs de prestadores e de clientes usam o formato abaixo. As respostas da API de agentes têm, em vez disso, os campos status, actionId e result; veja a descrição OpenAPI.

Sucesso (2xx)

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

Erro (4xx/5xx)

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "bookingId, lat, lng required"
  },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

Desenvolvedores são bem-vindos

Pronto para integrar?

Crie uma chave em Configurações e faça sua primeira chamada em minutos. Para limites maiores ou um plano Enterprise, fale conosco.

Obter chaves de API Fale conosco

Desenvolva naCouthActs.

Escolha sua chave.

Chaves de agente

API de prestadores

API de clientes

Três passos até sua primeira chamada.

Obtenha sua chave

Faça sua primeira requisição

Explore as ferramentas para agentes

Referência completa.

API de agentes e MCP

API de prestadores

API de clientes

Públicos (sem chave)

Informe a localização pelos seus sistemas.

Etiquetas de camada aceitas

GPS móvel

AIS (marítimo)

Rastreamento de voo

ELD

Entrega com PIN

Dispositivo IoT

Satélite

Comprovante de entrega

Biometria

Como o acesso é controlado.

Chaves bearer

Somente HTTPS

Limites

Registro de atividades

Limites de gasto e aprovações

Registros assinados, não requisições assinadas

Consistente. Previsível.

Pronto para integrar?

Desenvolva na
CouthActs.