O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.
Carregando…
civics.recordsMódulo 48
Módulo da plataforma
Public records search
Pergunte ao registro o que aconteceu com um recurso, ou leia os eventos do workspace de forma direta, redigidos conforme o que sua permissão realmente permite.
civics.records é uma janela pública fina para o ledger: com um resource delega à mesma lógica de blame de ledger.blame, e sem um lista eventos. Quem chama com records.export vê todos os campos; os demais têm os campos de identificadores de testemunha removidos antes de a resposta sair da plataforma.
Intralock · Leases · Parley · Fleet Map
Um produto da Trustvice
Os agentes agem quando o plano diz sim, e o registo diz porquê.
Passe ações de agentes, hashes de conteúdo, checagens de API, DNS, webhooks, chamadas de LLM e commits git pela Intramedial. Receba um recibo assinado que todos verificam – sem confiar em nós.
Status"Filtrar todo evento" exagera a superfície real
O único filtro é resource; não há filtro por autor, tipo ou intervalo de datas aqui. Filtros mais finos precisam ser feitos no cliente, ou chamando diretamente as ações ledger.blame/ledger.list com os filtros que elas suportam.
Registro
O registro
O que é registrado
resource
O filtro opcional; quando informado, restringe ao histórico do próprio recurso.
projection
"records" para a lista sem filtro, ou "blame" quando um resource foi informado.
public ou operator, decidido a partir das permissões de quem chama, nunca de um campo da requisição.
events
Os eventos correspondentes, cada um com os campos de identificadores de testemunha removidos, a menos que quem chama leia no nível operator.
lastTouch
Em um filtro resource, a alteração mais recente nele, com quaisquer campos que o evento nunca registrou nomeados em unknown.
why
Em um filtro resource, a regra de correspondência usada: recurso ou assunto igual ao valor informado.
Mecanismo
Passo a passo
Como funciona
O nível de divulgação de quem chama é definido
Quem chama com a permissão records.export lê no nível operator; os demais leem no nível public, decidido antes de qualquer coisa ser buscada.
Um recurso restringe ao seu histórico
Passar resource delega à lógica de blame do ledger e devolve os eventos desse recurso em ordem cronológica inversa, com lastTouch e quaisquer campos unknown nomeados com honestidade.
Sem recurso, lista tudo
Sem resource, todo evento do ledger do workspace volta como events, no mesmo nível de divulgação.
Identificadores removidos, não o conteúdo
No nível public, campos como rootHex, otsDigestHex e inclusionProof são removidos de cada evento e de seu corpo; nada mais no evento é alterado.
Experimente
Demo ao vivo
Execute a partir desta página
GET/api/v1/acp/civics/records
// Sem corpo: isto é um GET. Clique em Executar.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado. Docs de civics.records
Respostas
Clique em Executar para enviar a requisição à esquerda ao workspace de demonstração compartilhado.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado.
Código
Exemplo ao vivo
Uma requisição real
Uma requisição no formato que a API aceita e um exemplo de resposta no formato que o módulo devolve.
api.intramedial.com/api/v1/acp/civics/recordsGET
GET/api/v1/acp/civics/recordsAuthorization: Bearer av_workspace_••••→ 200 { projection, disclosureLevel, events } (filtering by resource also adds lastTouch, unknown and why)
Um membro sem direito de exportação lê o que aconteceu com um recurso com os campos de identificadores de testemunha removidos, o suficiente para ver o formato dos eventos sem expor material de prova.
Um operador puxando o registro completo
O dono de um workspace com records.export lê os mesmos eventos no nível operator, sem nada removido, para uma exportação de conformidade.
Rastrear o histórico de um recurso
Passar resource transforma o registro geral em uma visão de blame focada, a mesma que o próprio ledger.blame devolve.
Saber o que o registro não sabe
Um lastTouch sem seu autor ou decisão diz isso em unknown, em vez de adivinhar ou deixar o campo ausente em silêncio.
Quando usar outra coisa
Filtrar por autor, tipo ou intervalo de datas. Aqui só resource restringe o resultado.
Alterar ou remover um evento gravado. Não existe ação de atualização ou exclusão; o registro só cresce.
Ler os eventos de outro workspace. Toda leitura é restrita ao workspace de quem chama.
Evidência
Garantias
O que faz e o que não faz
Um módulo é uma afirmação forte sobre algo estreito. Confie nele exatamente pelo que ele é.
Faz
O nível de divulgação é calculado das permissões de quem chama, nunca aceito como campo de requisição que ele mesmo pudesse definir.
A transcrição confirmada e com hash de um evento nunca é alterada depois do fato, embora uma prova de testemunha possa ser anexada à sua linha armazenada depois.
Nenhuma ação deste módulo, nem do ledger que ele lê, pode atualizar ou apagar um evento gravado.
Não faz
Que todo evento que um recurso tocou seja filtrável por algo além de sua string exata de resource ou subject.
Que um leitor público e um leitor operador vejam eventos diferentes, apenas campos diferentes dos mesmos eventos.
Que o cabeçalho do gateway que leva a permissão de quem chama não possa estar mal configurado; este módulo confia no que recebe.
Detalhes
Notas de construção
Antes de construir
Delega ao módulo do ledger
Os caminhos de blame e de lista aqui chamam diretamente as próprias funções de ledger.blame e ledger.list; civics.records acrescenta por cima a camada de redação baseada em permissão, não um armazenamento separado.
Identificadores de testemunha, nomeados
Os campos removidos no nível public são leafHex, rootHex, otsDigestHex, entpoindReceiptId, topsEntryId, witnessRecordId, awsWitnessKey, awsKmsKeyId, awsCountersignHex e inclusionProof.
Não existe ação MCP
civics.records só é acessível por REST; civics.presence, civics.forum, civics.claims e civics.list têm cada um sua ação MCP, mas records não.
Limites e medição
O único filtro é resource; não há autor, tipo ou intervalo de datas.
O nível de divulgação é binário: public ou operator, decidido por uma permissão, não uma escala gradual.
Não existe id de ação MCP ou de contrato para esta rota; chame-a por REST.
Acesso
API e MCP
REST e MCP
Autentique-se com uma chave de API do workspace como token Bearer. A URL base é https://api.intramedial.com.
Endpoints REST
GET/api/v1/acp/civics/recordsLeia eventos de forma direta, ou o histórico de um recurso com resource.
Ações MCP
Este módulo não tem ação MCP. Chame-o por REST a partir de qualquer agente ou programa.
Planeje onde os registros de coordenação deste workspace devem ficar, veja exatamente o que seria movido e depois leve-os a outra região quando você decidir.
Módulo da plataforma
