API REST da Frihet

Acesso programático a faturas, clientes, despesas, produtos e orçamentos. Projetada para integrações que escalam.

https://api.frihet.io/v1 v1 — 2026-03-18

Feita para desenvolvedores

Atualizações parciais PATCH

Atualize apenas os campos que você precisa. Schemas parciais validados com Zod garantem a integridade.

Busca e filtros

Busca full-text com parâmetro ?q=. Mapeamento de campos por recurso para resultados precisos.

Operações em lote

Crie até 50 recursos em uma única requisição. Respostas HTTP 207 multi-status.

Chaves de idempotência

Tente novamente requisições de forma segura com o cabeçalho Idempotency-Key. TTL de 24 horas, respaldado pelo Firestore.

Cabeçalhos de limite de taxa

X-RateLimit-Limit, Remaining e Reset em cada resposta. Planeje-se de acordo.

Spec OpenAPI 3.1

Especificação legível por máquinas em /openapi.yaml. 16 paths, 18 schemas. Gera SDKs automaticamente.

Endpoints de inteligência

Contexto de negócio, resumos mensais e dados fiscais trimestrais via /context, /monthly, /quarterly.

Exclusão segura VeriFactu

Soft delete para faturas e orçamentos não rascunho. Rastreabilidade completa para conformidade fiscal espanhola.

Endpoints

Method	Path	Description
GET	/v1/invoices	Listar faturas
POST	/v1/invoices	Criar fatura
PATCH	/v1/invoices/:id	Atualizar fatura
DELETE	/v1/invoices/:id	Excluir fatura
POST	/v1/invoices/batch	Criar faturas em lote
GET	/v1/clients	Listar clientes
POST	/v1/clients	Criar cliente
GET	/v1/expenses	Listar despesas
POST	/v1/expenses	Criar despesa
GET	/v1/products	Listar produtos
GET	/v1/quotes	Listar orçamentos
GET	/v1/context	Contexto de negócio
GET	/v1/monthly	Resumo mensal
GET	/v1/quarterly	Impostos trimestrais
GET	/openapi.yaml	Especificação OpenAPI

Exemplos de código

curl https://api.frihet.io/v1/invoices \
  -H "Authorization: Bearer fri_..." \
  -H "Content-Type: application/json"

const res = await fetch('https://api.frihet.io/v1/invoices', {
  headers: {
    'Authorization': 'Bearer fri_...',
    'Content-Type': 'application/json',
  },
});
const { data, meta } = await res.json();

import requests

res = requests.get(
    'https://api.frihet.io/v1/invoices',
    headers={'Authorization': 'Bearer fri_...'}
)
data = res.json()['data']

Autenticação

Gere chaves de API em Configurações > API no seu painel Frihet. Inclua sua chave como Bearer token no cabeçalho Authorization.

Authorization: Bearer fri_...

Documentação completa da API MCP Server

Comece a integrar hoje

Acesso à API incluído em todos os planos. Sua chave de API está pronta em Configurações.

Começar Grátis