Създаване на тайни
Актуализирано 2025-04-02
:::бележка Избор на местоположение на данните и регион
- Изберете между центрове за данни в САЩ (
us.onetimesecret.com
) или ЕС (eu.onetimesecret.com
) - Вземете предвид фактори като суверенитет на данните, латентност и изисквания за съответствие
- ЗАБЕЛЕЖКА: По подразбиране
onetimesecret.com
продължава да функционира и да насочва към активен център за данни, като се препоръчва използването на конкретно местоположение, тъй като тази функционалност може да бъде премахната в бъдеще. :::
Създаване на тайна
Section titled “Създаване на тайна”POST https://REGION.onetimesecret.com/api/v1/share
Използвайте тази крайна точка, за да съхраните секретна стойност и да създадете връзка за еднократно използване.
Удостоверена заявка
Section titled “Удостоверена заявка”$ curl -X POST -u 'USERNAME:APITOKEN' -d 'secret=SECRET&ttl=NUMBER_IN_SECONDS' https://us.onetimesecret.com/api/v1/share
Анонимна заявка
Section titled “Анонимна заявка”$ curl -X POST -d 'secret=SECRET&ttl=3600' https://us.onetimesecret.com/api/v1/share
Параметри на заявката
Section titled “Параметри на заявката”- secret: тайната стойност, която се криптира, преди да бъде съхранена. Има максимална дължина в зависимост от вашия план, която се прилага (1k-10k).
- пасфраза: низ, който получателят трябва да знае, за да види тайната. Тази стойност също се използва за криптиране на тайната и се bcrypted преди да бъде съхранена, така че ние имаме тази стойност само при пренос.
- ttl: максималният период от време в секунди, който тайната трябва да издържи (т.е. време до живот). След като това време изтече, тайната ще бъде изтрита и няма да може да бъде възстановена.
- получател: имейл адрес. Ще изпратим приятелски имейл, съдържащ връзката към тайната (НЕ самата тайна).
- домейн за споделяне: потребителският домейн, който да се използва при генерирането на тайната връзка. Ако не е предоставен, се използва домейнът по подразбиране (напр. eu.onetimesecret.com).
Атрибути
Section titled “Атрибути”- custid: потребителското име на акаунта, който е създал тайната. Тази стойност ще бъде
anon
за анонимни заявки. - metadata_key: уникалният ключ за метаданните. НЕ го споделяйте.
- secret_key: уникалният ключ за създадената тайна. Това е ключ, който можете да споделяте.
- ttl: Времето до края на живота (в секунди), което е посочено (т.е. не оставащото време).
- metadata_ttl: Оставащото време (в секунди), което остава на метаданните.
- secret_ttl: Оставащото време (в секунди), което остава на тайната.
- получател: ако е посочен получател, това е замаскирана версия на имейл адреса.
- създаден: Време, в което тайната е създадена в уникс време (UTC).
- актуализирана: същото, но времето на последната актуализация.
- пасфраза_задължителна: Ако при създаването на тайната е била предоставена парола, това ще бъде вярно. В противен случай очевидно е false.
- share_domain: потребителският домейн, който да се използва при генерирането на тайната връзка. В противен случай "".
Примерен отговор:
Section titled “Примерен отговор:”{ "custid": "USERNAME", "metadata_key": "qjpjroeit8wra0ojeyhcw5pjsgwtuq7", "secret_key":"153l8vbwqx5taskp92pf05uvgjefvu9", "ttl": "3600", "share_domain": "", "updated":"1324174006", "created":"1324174006"}
Генериране на тайна
Section titled “Генериране на тайна”POST https://REGION.onetimesecret.com/api/v1/generate
Генерирайте кратка, уникална тайна. Това е полезно за временни пароли, подложки Onetime, соли и др.
Удостоверена заявка
Section titled “Удостоверена заявка”$ curl -X POST -u 'USERNAME:APITOKEN' -d 'ttl=NUMBER_IN_SECONDS' https://us.onetimesecret.com/api/v1/generate
Анонимна заявка
Section titled “Анонимна заявка”$ curl -X POST -d 'ttl=3600' https://us.onetimesecret.com/api/v1/generate
{ "custid": "USERNAME", "value":"3Rg8R2sfD3?a", "metadata_key": "2b6bjmudhmtiqjn2qmdaqjkqxp323gi", "secret_key": "pgcdv7org3vtdurif809sygnt0mstw6", "ttl": "3600", "share_domain": "", "updated":"1324174095", "created":"1324174095"}
Атрибути
Section titled “Атрибути”Същото като при “Споделяне на тайна” по-горе, но с добавяне на полето стойност
.