Aggiornato al 2025-04-29
URI di base
Sezione intitolata “URI di base”https://REGION.onetimesecret.com/api
Dove REGIONE
è us
o eu
.
Località dei dati e selezione della regione
- Scegliere una regione (ad esempio USA
us.onetimesecret.com
) o UE (eu.onetimesecret.com
). Vedere Regioni per tutte le opzioni. - Considerare fattori come la sovranità dei dati, la latenza e i requisiti di conformità.
- NOTA: Il sito
onetimesecret.com
predefinito rimane operativo e instrada verso un centro dati attivo; si raccomanda di utilizzare una località specifica, poiché questa funzionalità potrebbe essere deprecata in futuro. ::
Autenticazione
Sezione intitolata “Autenticazione”Supportiamo due modalità di utilizzo dell'API:
Accesso autenticato
Sezione intitolata “Accesso autenticato”https://USERNAME:APITOKEN@REGION.onetimesecret.com/api
- Utilizzare l'autenticazione di base HTTP per ottenere tutte le funzionalità API.
- Il nome utente è il login del proprio account
- La password è il token API dalla pagina del proprio account
Accesso anonimo
Sezione intitolata “Accesso anonimo”https://REGION.onetimesecret.com/api
- Funzionalità limitate disponibili senza autenticazione
- Ideale per la condivisione rapida di segreti una tantum
- Può essere utilizzato sia per creare che per recuperare i segreti
Località dei dati
Sezione intitolata “Località dei dati”Onetime Secret supporta più centri dati geografici. Seguiamo una politica di zero condivisione dei dati tra le regioni, assicurando il completo isolamento dei dati. Scegliete il centro dati più adatto alle vostre esigenze:
- Centro dati UE: eu.onetimesecret.com
- Centro dati USA: us.onetimesecret.com
Considerazioni importanti:
Sezione intitolata “Considerazioni importanti:”- È possibile scegliere una località specifica per i dati navigando direttamente al dominio desiderato.
- La posizione del vostro segreto è sempre chiara dal link generato (ad esempio,
us.onetimesecret.com/secret/abcd1234
). - NOTA: Attualmente, l'accesso tramite
onetimesecret.com/api
è ancora operativo, ma si raccomanda di utilizzare una località specifica poiché questa funzionalità potrebbe essere deprecata in futuro.
Domini personalizzati
Sezione intitolata “Domini personalizzati”Onetime Secret supporta configurazioni di dominio personalizzate per le organizzazioni con requisiti specifici di rete o di branding attraverso il nostro piano Identity Plus.
Vantaggi del dominio personalizzato
Sezione intitolata “Vantaggi del dominio personalizzato”- Usare il proprio dominio (ad esempio,
secrets.example.com
) per l'accesso all'API e la condivisione dei segreti. - Esperienza utente coerente:** Mantenere l'identità visiva e di fiducia dell'organizzazione con i clienti e i partner.
- Includere nella formazione dei dipendenti:** Utilizzare i domini personalizzati per rafforzare le pratiche di sicurezza e i flussi di lavoro dell'organizzazione.
Funzione premium I domini personalizzati sono disponibili sul nostro piano Identity Plus. Configurazione in pochi minuti con le nostre opzioni di configurazione facili da usare. Per saperne di più. ::
Utilizzo dell'API con domini personalizzati
Sezione intitolata “Utilizzo dell'API con domini personalizzati”Quando si utilizza un dominio personalizzato, tutti gli endpoint API seguono la stessa struttura:
https://secrets.example.com/api
Stato del sistema
Sezione intitolata “Stato del sistema”GET https://REGION.onetimesecret.com/api/v1/status
Stato attuale del sistema.
Parametri: Nessuno
$ curl -u 'USERNAME:APITOKEN' https://eu.onetimesecret.com/api/v1/status{"status": "nominale"}
$ curl -u 'USERNAME:APITOKEN' https://us.onetimesecret.com/api/v1/status{"status": "nominale"}