Documentação da API Praça

Exemplos curl

Base da API: https://api.praca.id. Consultas, execute v1 e FIPE usam o envelope { ok, data, error, meta }.

• Consulta CEP (envelope ToolResult)

  curl -sS "https://api.praca.id/api/portal-tools/queries/cep?cep=01310100"

  Resposta: { "ok": true, "data": { ... }, "error": null, "meta": { "source": "ViaCEP", ... } }

• Execute v1 — calculadora (quando api_enabled)

  curl -sS -X POST "https://api.praca.id/api/portal-tools/v1/services/calc.porcentagem/execute" \
    -H "Content-Type: application/json" \
    -d '{"input":{"valor":200,"percentual":15}}'

  Header opcional: -H "X-Api-Key: sua-chave"

• Execute v1 — consulta CEP via engine

  curl -sS -X POST "https://api.praca.id/api/portal-tools/v1/services/query.cep/execute" \
    -H "Content-Type: application/json" \
    -d '{"input":{"cep":"01310100"}}'

• FIPE por código, ano e combustível

  curl -sS "https://api.praca.id/api/fipe/consulta/001004-9/1998?combustivel=Gasolina"

  A consulta salva a variante e sua série histórica; meta informa fonte, cache e disclaimer.

• Criar job echo

  curl -sS -X POST "https://api.praca.id/api/portal-tools/jobs" \
    -H "Content-Type: application/json" \
    -d '{"service_key":"job.echo","payload_meta":{"text":"Olá, Praça!"}}'

  Jobs retornam recurso { id, status, result_meta, ... } — não usam envelope ok/data.

• Status do job

  curl -sS "https://api.praca.id/api/portal-tools/jobs/{uuid-do-job}"

• Catálogo — listar ferramentas

  curl -sS "https://api.praca.id/api/portal-tools/tools?featured=true&limit=10"

  Catálogo retorna JSON direto (array), sem envelope.

Especificação completa: praca-api.yaml. Termos: /api-termos.