API Pruvio para Desenvolvedores

Capacidades da API

O que a API pode fazer

Quatro áreas principais que você pode acessar programaticamente.

Pesquisa de empresas

GET /api/v1/companies/search?q=...

Pesquise por nome da empresa, número de IVA ou número HRB. Resultados de 6 fontes com índice de confiança.

Validação de e-fatura

POST /api/v1/invoices/validate

Envie uma e-fatura (ZUGFeRD/XRechnung). Receba resultado de validação, pontuação de risco e achados.

Gestão de watchlists

CRUD /api/v1/watchlists

Crie watchlists, adicione parceiros, receba alertas sobre eventos de compliance.

Webhooks

POST (URL de Callback)

Notificações em tempo real para novos eventos de compliance, resultados de faturas ou alertas de watchlist.

Início Rápido

Primeira consulta em 30 segundos

Crie uma chave API no dashboard e comece com um simples comando curl.

# Pesquisa de empresas via API
curl -X GET "https://api.pruvio.de/api/v1/companies/search?q=Siemens" \
  -H "X-API-Key: YOUR_API_KEY"

# Validar e-fatura
curl -X POST "https://api.pruvio.de/api/v1/invoices/validate" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@invoice.xml"

Recursos

Tudo o que desenvolvedores precisam

Documentação completa, permissões granulares e rate limiting robusto.

OpenAPI / Swagger

Documentação interativa com funcionalidade de teste. Todos os endpoints, parâmetros e schemas de resposta descritos.

Rate limiting por chave API

Rate limiting transparente com headers. Limites são medidos por chave API, não por endereço IP.

Chaves API com escopo

7 escopos granulares: companies:read, invoices:validate, watchlists:read, watchlists:write, alerts:read, assessments:manage, exports:create.

Callbacks de webhook

Registre URLs de webhook e receba payloads JSON em novos eventos. Assinatura HMAC para segurança.

Respostas JSON

Todas as respostas em formato JSON. Objetos de erro consistentes com status HTTP, código de erro e mensagem detalhada.

Paginação

Todos os endpoints de lista suportam paginação: ?page=1&per_page=20. Resposta com items, total, page e pages.

Documentação Interativa

Swagger UI

Encontre a documentação completa da API na interface interativa do Swagger. Teste endpoints diretamente no navegador.

api.pruvio.de/docs

Documentação OpenAPI interativa com todos os endpoints, exemplos e funcionalidade de teste.

Abrir Swagger →

Preços

Acesso API a partir do plano Enterprise

Acesso programático via API com chaves API está disponível a partir do plano Enterprise (a partir de 349 EUR/mês). Incluindo webhooks, chaves com escopo e suporte dedicado.

Comparar todos os planos

Pronto para a integração?

Cadastre-se e crie sua primeira chave API. A documentação Swagger guia você por cada endpoint.

Obter Acesso Antecipado Abrir Swagger

Acesso API a partir do plano Enterprise. A partir de 349 EUR/mês.

A API Pruvio para desenvolvedores