ACPROTOCOL

DEVELOPERS

REST API, SDK e esquemas do protocolo. A API pública está em desenvolvimento — as especificações abaixo refletem o Vocabulário Oficial e podem evoluir até o lançamento.

REST APISDKJSON Schema Registrar × ConsultarAuthenticationExamplesGitHub
REST API

Endpoints do protocolo

POST/v1/identitygera o AC⚡IDN a partir do elemento submetido
POST/v1/parityconsulta de paridade — retorna AC⚡UNI · AC⚡DUP · AC⚡PAR · AC⚡QTN · AC⚡INL
GET/v1/timelinegenealogia e eventos do ativo (canonicalTimeline)
GET/v1/registryconsulta de registro permanente
POST/v1/profileidentidade do titular (acProfileId)
POST/v1/access/*login, approve, challenge, sign, verify — camada AC⚡ACCESS
POST/v1/security/*device, recovery, kyc, policy — camada AC⚡SECURITY
JSON Schema

Resposta de paridade

{ "acIdn": "AC-…", // Canonical Identity Number "parityStatus": "AC⚡DUP", // AC⚡UNI | AC⚡DUP | AC⚡PAR | AC⚡QTN | AC⚡INL "canonicalTimeline": { "ancestor": "AC-…", "timelineEvents": [ … ] }, "anchoredAt": "2026-07-19T14:32:07Z" // ancoragem blockchain-agnostic }

Legenda dos códigos: AC⚡UNI [Unicidade] · AC⚡DUP [Duplicidade] · AC⚡PAR [Paridade] · AC⚡QTN [Quarentena] · AC⚡INL [Identidade não localizada ou documento ilegível].
Convenções do Vocabulário Oficial: endpoints em kebab-case, campos JSON em camelCase; códigos internos do motor jamais expostos — a resposta é sempre um dos 5 códigos públicos.

Operações

Registrar × Consultar

A mesma situação pode gerar respostas diferentes conforme a operação. Registrar compara a nova ocorrência com o registro e pode inaugurar uma identidade. Consultar informa o estado canônico atual do ativo e nunca cria identidade.

SituaçãoRegistrarConsultar
Documento ilegívelAC⚡INLAC⚡INL
Identidade ou ocorrência não determinável ou não validável com segurançaAC⚡QTNAC⚡QTN
Chave válida, sem identidade existenteAC⚡UNIcria a identidadeAC⚡INLnão localizada
Mesma chave, sem diferença documentalAC⚡DUPAC⚡UNIlocalizada e íntegra, salvo estado adverso já registrado
Mesma chave, conteúdo documental diferenteAC⚡PARAC⚡PARsalvo estado adverso já registrado
  1. Documento ilegível → AC⚡INL
  2. Identidade ou chave não determinável ou não validável com segurança → AC⚡QTN
  3. Identidade localizada → estado canônico atual, com o sinal mais crítico já registrado para ela, independentemente da ocorrência consultada

AC⚡UNI em consulta significa identidade localizada e sem estado adverso registrado. Não significa autorização para realizar nova operação sobre o ativo.

Authentication · SDK

SDK e autenticação

// SDK — nomes oficiais (em desenvolvimento) ACProtocol.identity() ACSecurity.login() ACProtocol.parity() ACSecurity.approve() ACProtocol.timeline() ACSecurity.device() ACProtocol.registry() ACSecurity.policy()

Autenticação por chaves de API por faixas (cartórios · bancos · varejo) e, para operações do titular, o fluxo AC⚡ACCESS com desafio dinâmico de sessão única. Detalhes completos na especificação a ser publicada.

GitHub & Developer Program

Os repositórios públicos, exemplos e o programa de acesso antecipado abrem junto com a API. Cadastre interesse: contact@acprotocol.org