Todas as consultas listadas aqui devem ser realizadas como requisições HTTP GET para o servidor de DT.
- Consulta:
/dt/v1/get-smh
- Entradas: nenhuma
- Saídas:
timestamp
(número): o instante em que a cabeça foi geradamap_size
(número): o tamanho do mapamap_root_hash
(base64): a raiz do mapasource_tree_root_hash
(base64): a raiz da árvore fontesource_log_revisions
(lista): um objeto por log fonte, com as seguintes chaves:tree_size
(número): o tamanho do respectivo log fonteroot_hash
(base64): a raiz do respectivo log fonte
map_head_signature
(base64): a assinatura da cabeça de mapa
- Consulta:
/dt/v1/get-domain-root-and-proof
- Entradas:
domain_name
(string): o nome do domíniodomain_map_size
(número): o tamanho do mapa de domínios, que deve se referir uma cabeça válida
- Saídas:
domain_tree_size
(número): o número de folhas na árvore de domíniodomain_tree_root_hash
(base64): a raiz da árvore de domínionormalized_domain_name
(string): o nome de domínio normalizado referente à árvore de domínioaudit_path
(lista de base64): uma prova de auditoria dessa árvore de domínio
- Consulta:
/dt/v1/get-consistency-proof
- Entradas:
domain_name
(string): o nome do domíniofirst
(número): o tamanho da primeira revisão da árvore de domíniosecond
(número): o tamanho da segunda revisão da árvore de domínio
- Saída:
proof
(lista de base64): uma prova de consistência entre as duas revisões especificadas da árvore de domínio
- Consulta:
/dt/v1/get-entries
- Entradas:
domain_name
(string): o nome do domíniostart
(número): o índice do primeiro certificadoend
(número): o índice do último certificado
- Saída:
entries
(lista de [número, número]): uma lista de pares(i,j)
, onde cada par se refere ao certificado no índicej
doi
-ésimo log fonte
- Consulta:
/dt/v1/get-entry-and-proof
- Entradas:
domain_name
(string): o nome do domínioindex
(número): o índice do certificadodomain_tree_size
(número): o número de folhas na árvore de domínio
- Saída:
entry
([número, número]): um par(i,j)
, referenciando o certificado no índicej
doi
-ésimo log fonteaudit_path
(lista de base64): uma prova de auditoria desse certificado
- Consulta:
/dt/v1/get-domain-tree-index
- Entradas:
domain_name
(string): o nome do domíniolog_index
(número): o índice de um log fontecertificate_index
(número): o índice de um certificado no log fonte especificado
- Saída:
domain_tree_index
(número): o índice do certificado na árvore de domínio especificada
- Consulta:
/dt/v1/get-source-logs
- Entradas:
start
(número): o índice do primeiro logend
(número): o índice do último log
- Saída:
log_ids
(lista de base64): uma lista de IDs dos logs fonte pedidos
- Consulta:
/dt/v1/get-source-log-and-proof
- Entradas:
index
(número): o índice do log fontesource_tree_size
(número): o número de folhas na árvore fonte
- Saída:
log_id
(lista de base64): o ID do log fonte pedidoaudit_path
(lista de base64): uma prova de auditoria do log fonte
- Consulta:
/dt/v1/get-source-consistency-proof
- Entradas:
first
(número): o tamanho da primeira revisão da árvore fontesecond
(número): o tamanho da segunda revisão da árvore fonte
- Saída:
proof
(lista de base64): uma prova de consistência entre as duas revisões especificadas da árvore fonte