Mappa delle rotte
Ogni percorso sotto è sotto http://127.0.0.1:19821 e viene dal documento
OpenAPI proprio del daemon. Solo /api/v1/token nel primo gruppo è
raggiungibile senza un bearer token.
Dove il documento non porta nessuna descrizione per una rotta, qui non ne viene
inventata nessuna. Recupera /api/v1/openapi.json, oppure apri /api/v1/docs,
per gli schemi di richiesta e risposta.
Sistema
Sezione intitolata “Sistema”Il daemon è attivo, ha effettuato l’accesso, e quando ha parlato l’ultima volta
con il server. GET /api/v1/sync risponde che cosa ha fatto l’ultima
sincronizzazione senza farne un’altra; POST ne esegue una.
| Percorso | Metodi |
|---|---|
/api/v1/status | GET |
/api/v1/sync | GET, POST |
/api/v1/token | POST |
Esistono anche /health e /api/v1/health, fuori dall’insieme documentato.
Identità
Sezione intitolata “Identità”Le due rotte che un’integrazione di solito vuole.
POST /api/v1/verify controlla tre parole contro le connessioni per cui questo
dispositivo detiene un segreto. È puramente locale. Leggi il campo conclusive
prima di mostrare qualsiasi cosa: è falso ogni volta che una connessione non ha
potuto essere controllata, incluso il caso comune in cui non c’è nulla in cache.
Chi chiama non deve dire “non verificato” a meno che conclusive non sia vero.
Una corrispondenza porta window — current, oppure previous per un codice
precedente che l’operatore accetta ancora (uno per impostazione predefinita),
con windowsBack che dice quanto indietro — e validUntil, l’istante in cui
quel codice smette o ha smesso di essere valido. Mostra una corrispondenza
precedente con quell’ora in ora locale e suggerisci un sigillo per un messaggio
letto più tardi. Su una connessione in cui ogni membro ha il proprio codice,
memberName dice di chi era. Il codice di chi legge non corrisponde mai. Questa
route e i codici precedenti qui sotto richiedono solo un token in lettura.
POST /api/v1/stamp firma un contenuto sul dispositivo e risponde con tre
parole, l’orario in cui è stato firmato, un livello di affidabilità e l’URL che
un destinatario apre per controllare la firma.
| Percorso | Metodi |
|---|---|
/api/v1/stamp | POST |
/api/v1/verify | POST |
Fiducia
Sezione intitolata “Fiducia”Seguire persone, e il registro delle verifiche.
POST /api/v1/verify/public è l’altra metà di /api/v1/verify: chiede al
server se tre parole appartengono a qualcuno, invece di controllare localmente.
Le rotte /api/v1/trust-cards elencano e modificano le persone che questo
account segue. Il percorso conserva un nome precedente. L’{id} su queste rotte
è l’id della persona seguita, non quello della riga.
| Percorso | Metodi |
|---|---|
/api/v1/trust-cards | GET, POST |
/api/v1/trust-cards/{id} | PATCH, DELETE |
/api/v1/trust-cards/{id}/history | GET |
/api/v1/trust/metrics | GET |
/api/v1/verification-log | GET |
/api/v1/verify/public | POST |
Connessioni
Sezione intitolata “Connessioni”Creare, leggere, rinominare ed eliminare connessioni; leggere il codice attuale di una; segnarne una come preferita; aggiungere e rimuovere membri.
GET /api/v1/connections/:id/members/:mid/previous-codes elenca i codici
precedenti di un membro, il più recente per primo, ciascuno con words,
validFrom e validUntil; :mid è l’id della riga di appartenenza.
previousWindows è quanti ne accetta l’operatore. available è falso quando
questo dispositivo non custodisce alcun segreto da cui derivarli — mostralo come
“non è possibile mostrarli”, non come un elenco vuoto. È locale e non registra
nulla. Una riga che non è membro di quella connessione risponde 404.
| Percorso | Metodi |
|---|---|
/api/v1/connections | GET, POST |
/api/v1/connections/:id | GET, PATCH, DELETE |
/api/v1/connections/:id/code | GET |
/api/v1/connections/:id/favorite | POST |
/api/v1/connections/:id/members | POST |
/api/v1/connections/:id/members/:mid | DELETE |
/api/v1/connections/:id/members/:mid/previous-codes | GET |
GET /api/v1/invitations elenca entrambe le direzioni. Il resto agisce su un
singolo invito: approvarlo, rifiutarlo, o ritirarne uno che hai inviato.
| Percorso | Metodi |
|---|---|
/api/v1/invitations | GET |
/api/v1/invitations/pending | GET |
/api/v1/invitations/:id/approve | POST |
/api/v1/invitations/:id/decline | POST |
/api/v1/invitations/:id/withdraw | POST |
Codici ospite
Sezione intitolata “Codici ospite”Creare e revocare codici per persone che non usano l’app, recuperarne uno come immagine QR, o farlo inviare.
| Percorso | Metodi |
|---|---|
/api/v1/guest-codes | GET, POST |
/api/v1/guest-codes/:id | DELETE |
/api/v1/guest-codes/:id/qr | GET |
/api/v1/guest-codes/:id/send | POST |
Membri esterni
Sezione intitolata “Membri esterni”Le pagine di verifica per gli ospiti.
| Percorso | Metodi |
|---|---|
/api/v1/external-members | GET, POST |
/api/v1/external-members/:id | DELETE |
I tag organizzano le connessioni. Il percorso di assegnazione prende entrambi gli id: prima il tag, poi la connessione.
| Percorso | Metodi |
|---|---|
/api/v1/tags | GET, POST |
/api/v1/tags/:id | PATCH, DELETE |
/api/v1/tags/:id/assign/:cid | POST, DELETE |
I preset delle connessioni, e quale sia quello predefinito.
| Percorso | Metodi |
|---|---|
/api/v1/presets | GET, POST |
/api/v1/presets/{id} | PATCH, DELETE |
/api/v1/presets/{id}/default | POST |
/api/v1/presets/default | DELETE |
Open link
Sezione intitolata “Open link”Gli open link e le richieste di approvazione che producono. Un link può essere
messo in pausa, ripreso o rinominato con un nuovo slug; una richiesta può essere
approvata o rifiutata. suggest propone uno slug.
| Percorso | Metodi |
|---|---|
/api/v1/open-links | GET, POST |
/api/v1/open-links/suggest | GET |
/api/v1/open-links/{id} | DELETE |
/api/v1/open-links/{id}/pause | PATCH |
/api/v1/open-links/{id}/resume | PATCH |
/api/v1/open-links/{id}/slug | PATCH |
/api/v1/open-links/requests | GET |
/api/v1/open-links/requests/{id}/approve | POST |
/api/v1/open-links/requests/{id}/decline | POST |
Profilo e contesto
Sezione intitolata “Profilo e contesto”GET /api/v1/context risponde identità dell’account e contesto
dell’organizzazione in una sola chiamata — l’organizzazione attiva è presente
solo quando ce n’è una.
POST /api/v1/context/active-org cambia l’organizzazione attiva, o la azzera
per il contesto personale. È limitato alla sessione: scrive la scelta di questa
sessione, non il valore predefinito persistente dell’utente, quindi una scelta
sul desktop non ridirige altri dispositivi.
/api/v1/profiles/{id} è un profilo pubblico minimo di qualcun altro, e /keys
le sue chiavi pubbliche attive.
| Percorso | Metodi |
|---|---|
/api/v1/context | GET |
/api/v1/context/active-org | POST |
/api/v1/profile | GET, PATCH |
/api/v1/profiles/{id} | GET |
/api/v1/profiles/{id}/keys | GET |
/api/v1/preferences | GET, PATCH |
/api/v1/notifications | GET, DELETE |
/api/v1/notifications/read | POST |
Account
Sezione intitolata “Account”Dispositivi, sessioni, indirizzi email, esportazioni dati ed eliminazione dell’account.
Un’esportazione viene richiesta e costruita dal server: POST /api/v1/exports
risponde con un id, non un file, e /api/v1/exports/{id}/download risponde con
un link firmato e a scadenza per uno completato.
DELETE /api/v1/account elimina l’account e tutto ciò che contiene, e non può
essere annullato. Richiede un corpo che porta confirmEmail, l’indirizzo
proprio dell’account, che il daemon confronta sulla macchina prima di chiamare
qualsiasi cosa. Una chiamata senza corpo, o con l’indirizzo sbagliato, viene
rifiutata.
| Percorso | Metodi |
|---|---|
/api/v1/devices | GET |
/api/v1/devices/{id} | DELETE |
/api/v1/sessions | GET |
/api/v1/sessions/{id} | DELETE |
/api/v1/emails | GET, POST |
/api/v1/exports | GET, POST, DELETE |
/api/v1/exports/{id}/download | GET |
/api/v1/account | DELETE |
Gestione dell’organizzazione
Sezione intitolata “Gestione dell’organizzazione”Membri, gruppi, avvisi e analytics.
Le rotte di membri, gruppi e avvisi richiedono un token full, su ogni metodo.
Le letture di attività e analytics sono GET ordinari e basta un token read.
| Percorso | Metodi |
|---|---|
/api/v1/org/members | GET |
/api/v1/org/members/{id} | GET |
/api/v1/org/members/{id}/activate | POST |
/api/v1/org/members/{id}/suspend | POST |
/api/v1/org/members/bulk-invite | POST |
/api/v1/org/groups | GET, POST |
/api/v1/org/groups/{id} | PATCH, DELETE |
/api/v1/org/groups/{id}/members | POST, DELETE |
/api/v1/org/alerts | GET, POST |
/api/v1/org/alerts/{id} | PATCH, DELETE |
/api/v1/org/activity | GET |
/api/v1/org/activity/summary | GET |
/api/v1/org/analytics/dashboard | GET |
/api/v1/org/analytics/trends | GET |
Token API
Sezione intitolata “Token API”Elencare, generare e revocare token. Anche questo solo full.
| Percorso | Metodi |
|---|---|
/api/v1/api-tokens | GET, POST |
/api/v1/api-tokens/{id} | DELETE |
Assistente e feedback
Sezione intitolata “Assistente e feedback”Un turno della conversazione con l’assistente, una valutazione per una risposta, e un feedback al team. La risposta della chat viene passata direttamente dal server, quindi il daemon non ne corregge la forma.
| Percorso | Metodi |
|---|---|
/api/v1/chat | POST |
/api/v1/chat/rate | POST |
/api/v1/feedback | POST |