Listar registos
GET /api/agentsure/public/agents
Filtros opcionais: q e status.
curl "https://gifo.pt/api/agentsure/public/agents?q=atendimento&status=verified"
AgentSure Developers
Registo públicoVerificação programática
API pública e SDKs
Consulte o estado, versão, validade e hash de um registo AgentSure. A API pública não revela evidências privadas, membros, caminhos de armazenamento ou informação interna da avaliação.
Piloto. Os endpoints públicos têm cache curto e proteção operacional. Limites empresariais, chaves dedicadas e webhooks geridos serão ativados apenas após testes de produção e contrato específico.
Consultar um AgentSure ID
GET /api/agentsure/public/agents/{id}
curl "https://gifo.pt/api/agentsure/public/agents/AS-PT-DEMO-001"
Selo incorporável
GET /api/agentsure/public/agents/{id}/badge.svg
<a href="https://gifo.pt/agentsure/?id=AS-PT-DEMO-001">
<img src="https://gifo.pt/api/agentsure/public/agents/AS-PT-DEMO-001/badge.svg"
alt="Verificar no AgentSure">
</a>
Passaporte PDF
GET /api/agentsure/public/agents/{id}/passport.pdf
Documento gerado a partir do estado atual do registo. Inclui versão, nível, limitações e hash.
SDK JavaScript
<script src="https://gifo.pt/agentsure/sdk/agentsure.js"></script>
<script>
const client = AgentSure.createClient();
const result = await client.verify('AS-PT-DEMO-001', {
expectedVersion: '1.0.0'
});
console.log(result.valid, result.record);
</script>
SDK Python
from agentsure import AgentSureClient
with AgentSureClient() as client:
result = client.verify(
"AS-PT-DEMO-001",
expected_version="1.0.0",
)
print(result.valid)
Descarregue o ficheiro em /agentsure/sdk/agentsure.py. Requer httpx.
Semântica de verificação
- Estado: situação atual do registo.
- Versão: configuração exata avaliada.
- Hash: integridade do manifesto preservado.
- Validade: prazo da avaliação aplicável.
Boas práticas
- Não copie apenas a imagem do selo.
- Verifique sempre o ID e a versão.
- Trate suspensão e expiração como falhas de confiança.
- Não interprete AgentSure como aprovação regulatória.