Integra Veil
Trova la chiave giusta da un account che i tuoi utenti conoscono. Permetti loro di controllare chi ha firmato un messaggio, anche se quell’account viene rubato.
Una scheda, letta dal vivo#
GET
https://veil.rip/u/1.jsonQuesta richiesta parte quando la pagina si apre. La sua risposta riempie i valori qui sotto.
| Campo | In questa risposta | Significato |
|---|---|---|
n | integer | Numero permanente della scheda. |
name | string | Nome visualizzato corrente; un nome nascosto diventa Card seguito dal numero. |
url | string | URL permanente con il numero della scheda. |
keys | array<CardKey> | Tutte le chiavi dei dispositivi e di recupero, incluse quelle revocate. |
fingerprint | Fingerprint | Dodici parole per lingua e dodici gruppi di cinque cifre. |
witnesses | object | null | Conteggi signed, of e needed per la versione corrente. Sono controlli del server. |
La risposta intera
Le ricerche pubbliche, le schede e la verifica dei messaggi non richiedono una chiave API. Puoi chiamarle da un browser, un bot o un server.
cURL
curl -fsS 'https://veil.rip/u/1.json'Le operazioni più comuni#
- GETCerca una schedaTrova la scheda che ha un account, una chiave o un’impronta esatti.
/v1/lookup - GETLeggi la scheda di una personaLeggi la scheda pubblica completa, il record firmato, la prova e la storia recente.
/u/{card}.json - GETTrova chi ha una chiaveCerca una chiave pubblica, la sua scheda e il periodo di validità.
/v1/keys/{key} - POSTVerifica un messaggioControlla un blocco firma oppure chiave, messaggio e firma espliciti. Questa POST legge soltanto.
/v1/verify - POSTVerifica un file o un rilascioControlla la firma di un file dal suo hash, o di un elenco di checksum firmato, con le chiavi di una scheda. Questa POST legge soltanto.
/v1/verify - GETControlla quando una chiave poteva firmareChiedi se una chiave era attiva a un dato momento.
/v1/keys/{key}/active-at - GETLeggi la storia della schedaLeggi gli eventi delle versioni precedenti e i subentri del loro periodo.
/v1/identities/{n}/history - GETIncorpora un widget che verificaMostra una scheda in sola lettura che si verifica nel browser del visitatore.
/{kind}/{card}/embed
Usa il risultato#
- Scegli un badge con link, un’immagine o un widget che controlla la scheda.
- Controlla il testo esatto, la chiave che lo ha firmato e lo stato di quella chiave.
- Cerca le schede e controlla i messaggi firmati in qualunque server o messaggio diretto di Discord.
- Usa fetch direttamente per le letture pubbliche e la verifica dei messaggi.
- Controlla le versioni firmate di una scheda, il suo posto nell’indice del registro e i testimoni del registro.
- Installa veil dal deposito apt firmato, da winget o Homebrew, e controlla la chiave del deposito con la scheda dell’organizzazione Veil.
Sfoglia il riferimento#
- Letture pubbliche, risorse per le integrazioni e richieste disponibili ai proprietari delle schede.
- Usa la chiave di un dispositivo autorizzato per modificare schede e organizzazioni.
- Mantieni le richieste limitate e segui la risposta quando una chiamata deve aspettare.
- Dai a un’integrazione da server una quota condivisa senza concedere autorità sulla scheda Veil.