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 AuthenticationExamplesGitHub
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 [Único] · 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.

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