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 API SDK JSON Schema Authentication Examples GitHub

REST API

Endpoints do protocolo

POST/v1/identitygera o AC⚡IDN a partir do elemento (Chaves Mestras H1/H2/H3)

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: dev@acprotocol.org