ERP TPH

Documentação da API

API para integrações externas (ex: CRM TPH Consultoria). Autenticação via API key (Bearer token). Cada tenant gerencia suas próprias chaves em /configuracoes/api.

Especificação OpenAPI completa: /api/v1/openapi.json

Cobertura em expansão: por ora só os endpoints abaixo aceitam autenticação por API key. Os demais endpoints internos de /api/v1/* continuam exclusivos da sessão logada do aplicativo.

Autenticação

Envie o cabeçalho Authorization: Bearer sk_live_... em toda requisição. Gere e gerencie chaves em Configurações → API. Cada chave tem escopos específicos e um limite de 60 requisições por minuto.

Formato de erro

{
  "error": {
    "code": "FORBIDDEN",
    "message": "Esta API key não tem o escopo products.view.",
    "details": {}
  }
}

Endpoints

get /api/v1/products

Listar produtos

Requer o escopo `products.view` na API key.

get /api/v1/customers

Listar clientes

Requer o escopo `customers.view` na API key.