Venue Authority

Verifique instalações de serviço de alimentação em relação aos registros reguladores suportados.

GitHubExperimente este MCPPatrocinado

Documentação

API Venue Authority

O Venue Authority verifica o nome e o endereço de um comerciante de serviços alimentícios em relação aos registros regulatórios dos EUA suportados. Cada decisão inclui a fonte correspondente e o limite de evidências, para que as equipes de integração de comerciantes possam manter um recibo de auditoria em vez de depender de um sim ou não opaco.

Ele foi criado para facilitadores de pagamento, marketplaces, provedores de KYB e plataformas de restaurantes que precisam verificar locais durante a integração. As operações de lista de vigilância e webhook são documentadas para workspaces suportados. A expansão de monitoramento pago ainda não está disponível. Verifique a disponibilidade atual nas páginas de status e preços.

Verifique a cobertura primeiro

O endpoint de cobertura não requer chave de API:

curl https://venueauthority.com/api/v1/coverage

A resposta mostra as jurisdições, fontes regulatórias, classes de fontes e estado de atualização atualmente disponíveis para a API. Verifique antes de enviar registros de comerciantes.

Veja uma decisão antes de se inscrever

Abra o exemplo público de Portfolio Proof para inspecionar uma decisão aceita vinculada à fonte, uma decisão rejeitada e o limite de evidências. O exemplo fixo não requer conta nem upload de arquivo.

Teste uma decisão

  1. Crie um workspace verificado.
  2. Crie uma chave de teste no painel. Um workspace verificado elegível recebe uma concessão única de 25 unidades de teste.
  3. Envie um nome de comerciante e endereço com um ID de solicitação estável.
curl -X POST https://venueauthority.com/api/v1/resolve \
  -H 'Authorization: Bearer YOUR_ONE_TIME_KEY' \
  -H 'X-Request-Id: quickstart-000001' \
  -H 'Content-Type: application/json' \
  --data '{"name":"MERCHANT NAME","address":"STREET ADDRESS"}'

Uma decisão válida retorna a disposição, o motivo da política, a identidade da fonte, a classe da fonte, a atribuição da fonte, o snapshot e o limite de evidências. Repetir o mesmo ID de solicitação com o mesmo payload retorna o resultado armazenado sem outro débito.

Arquivos de integração

O contrato também cobre registros canônicos de instalações, portfólios, exportações de auditoria, webhooks e histórico de entrega de webhooks.

Pacotes de cliente

O repositório inclui três integrações revisadas e versionadas:

  • SDK Node.js para Node 18 e versões posteriores. Não possui dependências em tempo de execução.
  • SDK Python para Python 3.9 e versões posteriores. Usa apenas a biblioteca padrão em tempo de execução.
  • Servidor MCP para hosts MCP que precisam de cobertura pública, resolução de instalações ou evidências canônicas de instalações.

O lançamento v0.1.0 inclui um pacote MCP com um clique e arquivos baixáveis para todos os três clientes. Os lançamentos npm e PyPI serão documentados aqui somente após a publicação correspondente no registro ser bem-sucedida.

Limites do produto

O Venue Authority resolve uma instalação enviada para um registro regulatório suportado. Ele não infere o operador legal, não prova que um negócio está fisicamente aberto nem pesquisa fora da cobertura retornada pela API. Correspondências incertas são rejeitadas.

Links

Este repositório contém artefatos públicos de integração. O uso da API hospedada é regido pelos termos do Venue Authority.