跳转到内容

创造秘密

更新日期 2025-04-02

数据地点和区域选择*

POST https://REGION.onetimesecret.com/api/v1/share

使用该端点存储秘密值并创建一次性使用链接。

Terminal window
$ curl -X POST -u 'USERNAME:APITOKEN' -d 'secret=SECRET&ttl=NUMBER_IN_SECONDS' https://us.onetimesecret.com/api/v1/share
Terminal window
$ curl -X POST -d 'secret=SECRET&ttl=3600' https://us.onetimesecret.com/api/v1/share
  • secret:密文值,存储前已加密。根据您的计划,会有一个最大长度(1k-10k)。
  • 密码:接收者必须知道的字符串,用于查看密文。该值也用于加密密文,并在存储前进行加密,因此我们只在传输过程中拥有该值。
  • ttl:密文存活的最长时间(即有效时间),以秒为单位。一旦过期,密文将被删除,无法恢复。
  • 收件人**:电子邮件地址。我们将发送一封包含秘密链接(而非秘密本身)的友好电子邮件。
  • share_domain:生成秘密链接时使用的自定义域。如果未提供,则使用默认域(例如 eu.onetimesecret.com)。
  • custid**:创建秘密的账户的用户名。对于匿名请求,该值将是 “anon”。
  • metadata_key:元数据的唯一密钥。请勿共享。
  • secret_key:你创建的秘密的唯一密钥。这是可以共享的密钥。
  • ttl:指定的生存时间(以秒为单位)(即不是剩余时间)
  • metadata_ttl:元数据的剩余生存时间(秒)。
  • secret_ttl:秘密的剩余生存时间(秒)。
  • recipient**:如果指定了收件人,这是电子邮件地址的混淆版本。
  • 创建:密文创建时间,以 unix 时间(UTC)表示
  • updated**:同上,但是是最后一次更新的时间。
  • passphrase_required:如果密文创建时提供了口令,则此值为 true。否则显然为假。
  • share_domain:生成秘密链接时使用的自定义域。否则为""。

“json { “custid”: “USERNAME”、 “metadata_key”: “qjpjroeit8wra0ojeyhcw5pjsgwtuq7”、 “secret_key”:“153l8vbwqx5taskp92pf05uvgjefvu9”, “ttl”: “3600”、 “share_domain”:"", “updated”:“1324174006”, “created”:“1324174006” }

## 生成一个秘密
`POST https://REGION.onetimesecret.com/api/v1/generate`
生成一个简短、唯一的密码。这对临时密码、Onetime 密码笺、盐等非常有用。
### 验证请求
```bash
$ curl -X POST -u 'USERNAME:APITOKEN' -d 'ttl=NUMBER_IN_SECONDS' https://us.onetimesecret.com/api/v1/generate
Terminal window
$ curl -X POST -d 'ttl=3600' https://us.onetimesecret.com/api/v1/generate

“json { “custid”: “USERNAME”、 “value”:“3Rg8R2sfD3?a”, “metadata_key”: “2b6bjmudhmtiqjn2qmdaqjkqxp323gi”、 “secret_key”: “pgcdv7org3vtdurif809sygnt0mstw6”、 “ttl”: “3600”、 “share_domain”:"", “updated”:“1324174095”, “created”:“1324174095” }

#### 属性
与上面的 "分享秘密 "相同,但增加了 "值 "字段。