Skip to main content
A Niadra tem duas APIs HTTP. A API de dados é de cada espaço: é nela que os seus agentes e sistemas gravam eventos, leem o contexto e navegam no histórico, e que o seu time de governança apaga, exporta, audita e mede. A API de controle cuida de tenants, projetos, fontes, chaves, pessoas e configuração versionada, e nunca guarda conteúdo de cliente. Os SDKs cobrem o lado do agente na API de dados; cada rota das duas APIs tem página própria nesta referência.

​
Endereço

Cada espaço tem um endereço estável, que leva a região e nunca expõe a infraestrutura por trás:
O SDK tira esse endereço da chave (nia_sk_<live|test>_<region>_<space>_<key_id>_<secret>). Enquanto um espaço muda de célula, a célula antiga responde 421 wrong_cell e o SDK tenta de novo numa conexão nova. A API de controle fica em https://control.api.niadra.com.

​
Autenticação

Toda rota recebe Authorization: Bearer <credencial>. Qual credencial serve depende da rota: Os papéis do Console são admin, security, integration, review, analysis e vendor. admin passa em toda checagem de papel. Uma pessoa vendor só enxerga as fontes nomeadas no vínculo do papel dela. Uma chave sem o escopo da rota recebe 403 scope_missing; uma pessoa sem o papel, 403 forbidden. Cada página da referência diz o que a rota aceita.

​
Grupos de rotas

​
Convenções numa tabela

Os detalhes estão em Limites e convenções e em Erros.

​
Contrato

A referência sai do contrato OpenAPI 3.1 que o servidor exporta do próprio código, o mesmo arquivo contra o qual os SDKs e o Console são testados. Valores de enum e nomes de campo são em inglês ASCII e nunca mudam de sentido dentro da /v1. As descrições aparecem em português; os nomes do contrato ficam como são.

​
Próximos passos

Ler o contexto

A chamada que todo agente faz antes de agir.

Enviar um lote

Mensagens, eventos de sistema e ações.

Erros

O catálogo de códigos e o que fazer com cada um.

Limites e convenções

Tamanhos, taxas, idempotência e cache.