Powered by Praça

Como integrar

1. Obtenha uma API key no painel admin (stub) com allowlist dos serviços desejados.
2. Chame POST /api/portal-tools/v1/services/:serviceKey/execute com header X-Api-Key.
3. Exiba o badge com link para /powered-by-praca.

Compat: /powered-by-nexa e /powered-by-nexa.svg redirecionam / espelham o selo Praça.

Exemplo curl

curl -X POST "https://api.exemplo/api/portal-tools/v1/services/nexa.validate.cpf/execute" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: tk_live_..." \
  -d '{"cpf":"52998224725"}'

service_key com prefixo nexa. é contrato técnico da API (não renomeado).

Exemplo JavaScript

const res = await fetch(
  "https://api.exemplo/api/portal-tools/v1/services/query.cep/execute",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Api-Key": process.env.PRACA_API_KEY,
    },
    body: JSON.stringify({ input: { cep: "01310-100" } }),
  }
);
const json = await res.json(); // { ok, data, meta }

Termos do badge

• Não altere as cores do SVG (#1A56DB / branco) sem autorização.
• Não use o selo para sugerir parceria oficial além do uso da API.
• Remova o badge se a key for revogada ou o contrato encerrado.
• Detalhes em Termos da API.