找回秘密
更新日期 2025-04-02
注 数据位置和区域选择*
- 选择一个 [区域]({getRelativeLocaleUrl(Astro.currentLocale ??‘en’, ‘regions’)}) （例如
us.onetimesecret.com,eu.onetimesecret.com) 数据中心 - 考虑数据主权、延迟和合规要求等因素
- ** 注：** 默认情况下，
onetimesecret.com仍可运行并路由至活动数据中心，建议使用特定位置，因为此功能将来可能会过时。 :::
POST https://REGION.onetimesecret.com/api/v1/secret/SECRET_KEY
$ curl -X POST -u 'USERNAME:APITOKEN' https://eu.onetimesecret.com/api/v1/secret/SECRET_KEY$ curl -X POST https://eu.onetimesecret.com/api/v1/secret/SECRET_KEY- SECRET_KEY：该密文的唯一密钥。
- 口令**（如需要）：只有在创建秘密时才需要口令。
- secret_key：您创建的秘密的唯一密钥。这是可以共享的密钥。
- value：实际秘密。不言而喻，它只能使用一次。
POST https://REGION.onetimesecret.com/api/v1/private/METADATA_KEY
每个秘密都有相关的元数据。元数据仅供秘密创建者使用（即不供接收者使用），一般应保密。由于元数据密钥与秘密密钥不同，因此你可以放心使用元数据密钥来获取关于秘密本身的基本信息（如是否或何时被查看）。
$ curl -X POST -u 'USERNAME:APITOKEN' https://eu.onetimesecret.com/api/v1/private/METADATA_KEY- METADATA_KEY：该元数据的唯一密钥。
- custid**：创建秘密的账户的用户名。对于匿名请求，该值将是 “anon”。
- metadata_key：元数据的唯一密钥。请勿共享。
- secret_key：你创建的秘密的唯一密钥。这是可以共享的密钥。
- ttl：指定的生存时间（即不是剩余时间）
- metadata_ttl：元数据的剩余生存时间（以秒为单位）。
- secret_ttl：秘密的剩余生存时间（秒）。
- recipient**：如果指定了收件人，这是电子邮件地址的混淆版本。
- 创建：元数据的创建时间，以 unix 时间（UTC）表示
- updated**：同上，不过是最后一次更新的时间。
- received**：收到**：收到秘密的时间。
- passphrase_required：如果在创建密文时提供了口令，则此值为 true。否则显然为假。
燃烧一个秘密
Section titled “燃烧一个秘密”POST https://REGION.onetimesecret.com/api/v1/private/METADATA_KEY/burn
烧掉一个尚未被读取的秘密。
$ curl -X POST -u 'USERNAME:APITOKEN' https://eu.onetimesecret.com/api/v1/private/METADATA_KEY/burn- 无
- 与状态为已烧毁的元数据属性相同。
检索最近的元数据
Section titled “检索最近的元数据”** 获取 https://onetimesecret.com/api/v1/private/recent**
读取最近的元数据列表。
$ curl -u 'USERNAME:APITOKEN' https://eu.onetimesecret.com/api/v1/private/recent- 无
- 与元数据属性相同，但它是一个列表，密钥值始终为空。
警告 需要验证 注意： 元数据和管理操作（检索元数据、刻录密文、最近元数据）仅适用于通过身份验证的用户。 :::