Hoppa till innehåll

Du visar förhandsversionen av dokumentationenInnehållet här är för testning och kan skilja sig från den publika dokumentationen.

Gå till den publika dokumentationen

Klientbibliotek

Den officiella klienten är onetime-ruby, som stöder API v1 och v2, alla regionala domäner och anpassade bas-URL:er.

Allt annat på den här sidan underhålls av communityn. De flesta av dessa bibliotek är äldre än API v2 och de regionala domänerna, så de anropar vanligtvis de utfasade v1-slutpunkterna mot onetimesecret.com – läs statusnoteringen för varje post och kontrollera att ett bibliotek fungerar mot din region eller självhostade instans innan du förlitar dig på det.

Språk Bibliotek Senaste aktivitet¹ Regional / anpassad domän
Ruby onetime-ruby (officiell) 2026-06 ✅ alla regioner + anpassad bas-URL
Go go-onetimesecret 2026-05 US-värd
Python onetimesecret-cli 2024-11 regionsalternativ US / EU
Go otsgo 2024-03 inte dokumenterat
PowerShell OneTimeSecret 2021-06 anpassad bas-URL
Bash onetimesecret-bash 2020-05 anpassad värd
Python py_onetimesecret 2019-05 ❌ (från Python 2-eran)
C# OneTimeSharp 2018-05 ❌
Java onetime-java 2014-06 endast självhostad URL
Perl Net::OneTimeSecret 2012-02 ❌

¹ Senaste commit eller utgåva vid tidpunkten för den senaste granskningen (2026-07).

GitHub-sida - onetime-ruby av Delano – officiell klient, underhålls aktivt (senaste commit 2026-06). Stöder API v1 (utfasat) och v2, regionala domäner och anpassade bas-URL:er. Kräver Ruby 3.1+, inga körtidsberoenden.

require 'onetime/api'
api = Onetime::API.new('YOUR_EMAIL', 'YOUR_OTS_APIKEY')
options = {
secret: 'Jazz, jazz and more jazz.',
recipient: 'example@onetimesecret.com',
ttl: 7200
}
ret = api.post('/share', options)
puts ret['secret_key']

GitHub-sida - onetimesecret-cli av slashpass – underhålls av communityn (senaste commit 2024-11). Stöder ett regionsalternativ (us / eu).

from onetimesecret import OneTimeSecretCli
cli = OneTimeSecretCli(ONETIMESECRET_USER, ONETIMESECRET_KEY)
cli.create_link("secret") # return a link like https://onetimesecret.com/secret/xxxxxxxxxxx

GitHub-sida - py_onetimesecret av Vladislav Stepanov – underhålls inte (senaste commit 2019; exemplet nedan är Python 2). Använder det utfasade v1-API:et mot enbart onetimesecret.com.

from onetimesecret import OneTimeSecret
o = OneTimeSecret("YOUR_EMAIL", "YOUR_OTS_APIKEY")
secret = o.share(u"test")
print o.retrieve_secret(secret["secret_key"])
# {u'secret_key': u'dtr7ixukiolpx1i4i87kahmhyoy2q65',
# u'value': u'test'}

Net::OneTimeSecret på CPAN av Kyle Dawkins – underhålls inte (senaste utgåva 0.04, 2012-02). Äldre än API v2 och de regionala domänerna.

#!/usr/bin/env perl
use Net::OneTimeSecret;
# Note: replace these with yours in order for this to work!
my $customerId = 'YOUR_EMAIL';
my $testApiKey = 'YOUR_OTS_APIKEY';
my $api = Net::OneTimeSecret->new( $customerId, $testApiKey );
my $result = $api->shareSecret( 'Jazz, jazz and more jazz.',
passphrase => 'thepassword',
recipient => 'kyle@shoffle.com',
ttl => 7200,
);
printf( "%s\n", $result->{secret_key} );
my $secret = $api->retrieveSecret( $result->{secret_key}, passphrase => "thepassword" );
printf( "%s\n", $secret->{value} );

GitHub-sida - onetime-java av Marcin Pawlowski – underhålls inte (senaste commit 2014-06). Tar emot en instans-URL, så det kan fungera självhostat, men det är äldre än API v2.

OneTimeSecret ots = new OneTimeSecretRestImpl(
"https://path/to/ots/instance",
"ots-username",
"ots-apikey");
GenerateResponse generateResponse = ots.generate(
new GenerateRequest.Builder()
.withPassphrase("supersecret")
.build());
RetrieveResponse retrieveResponse = ots.retrieve(
new RetrieveRequest.Builder()
.withSecretKey(generateResponse.getSecretKey())
.withPassphrase("supersecret")
.build());
assertEquals(generateResponse.getValue(), retrieveResponse.getValue());

GitHub-sida - OneTimeSharp av Vladislav Stepanov – underhålls inte (senaste commit 2018-05). Använder det utfasade v1-API:et mot enbart onetimesecret.com.

// You can use OneTimeSharp in any of your projects which are compatible with .NET (4.0+) or Mono (2.10.8+).
using VStepanov.OneTimeSharp;
class Test
{
static void Main(string[] args)
{
var ots = new OneTimeSecret("YOUR_EMAIL", "YOUR_OTS_APIKEY");
var generated = ots.GenerateSecret();
Console.WriteLine(generated.Value); // LR*?us*A(UT*
Console.WriteLine(generated.SecretKey); // ikzx3m77j5by8411cg5lk5fvfylvl0i
Console.WriteLine(ots.GetSecretLink(generated)); // https://onetimesecret.com/secret/ikzx3m77j5by8411cg5lk5fvfylvl0i
var shared = ots.ShareSecret("Hello, OTS!");
Console.WriteLine(shared.MetadataKey); // kd6rgsucl98qbgu9eavjq4k5sdxsom0
Console.WriteLine(ots.GetMetadataLink(shared)); // https://onetimesecret.com/private/kd6rgsucl98qbgu9eavjq4k5sdxsom0
}
}

GitHub-sida - go-onetimesecret av Corbalt – underhålls av communityn (senaste commit 2026-05, uppdaterad för värden us.onetimesecret.com). Innehåller ett CLI.

import ots "github.com/corbaltcode/go-onetimesecret"
client := ots.Client{
Username: "user@example.com",
Key: "my api key",
}
metadata, err := client.Put("the launch codes", "passphrase", 0, "")
if err != nil {
// handle error
}
secret, err := client.Get(metadata.SecretKey, "passphrase")
if err != nil {
// handle error
}
// prints "the launch codes"
print(secret)
Terminalfönster
$ go install github.com/corbaltcode/go-onetimesecret/cmd/ots@latest
$ ots put 'what is essential is invisible to the eye'
hdjk6p0ozf61o7n6pbaxy4in8zuq7sm ifipvdpeo8oy6r8ryjbu8y7rhm9kty9
$ ots get hdjk6p0ozf61o7n6pbaxy4in8zuq7sm
what is essential is invisible to the eye
$ ots gen
rVjbS$twCJkS 4nwhy7v4fnabayqc5auv4ogh0nfr20 flsdlaun6hwczqu9utmc0vts5xj9xu1
$ ots burn flsdlaun6hwczqu9utmc0vts5xj9xu1
flsdlaun6hwczqu9utmc0vts5xj9xu1

GitHub-sida - otsgo av Emídio Neto – underhålls av communityn (senaste utgåva v1.1.0, 2024-03). Stöd för regionala domäner är inte dokumenterat.

// Build a new client
client := ots.NewClient(
WithUsername("otsuser@domain.com"),
WithApiKey("xxxxxxxx"),
)
// Send a request with context
ctx := context.Background()
response, err := client.GetStatus(ctx)
if err != nil {
panic(err)
}
fmt.Println(response.Status)

GitHub-sida - OneTimeSecret av Craig Gumbley – underhålls inte (senaste utgåva 2021-06). Stöder en anpassad -BaseUrl, så det kan peka mot en region eller en självhostad instans, men det är äldre än API v2.

Terminalfönster
# Install from the PowerShell gallery
Install-Module -Name OneTimeSecret -Scope CurrentUser
# Set connection information
Set-OTSAuthorizationToken -Username user@mail.com -APIKey xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Generate a new shared secret
New-OTSSharedSecret -Secret "Very Secret" -Passphrase 1234 -Recipient user@mail.com
# Retrieve a secret
Get-OTSSecret -SecretKey qqevnp70b4uoiax4knzhwlhros6ne7x -Passphrase 1234
# View all functions that are available
Get-Command -Module OneTimeSecret | Select Name

GitHub-sida - onetimesecret-bash av Eric Engstrom – underhålls inte (senaste commit 2020-05). Stöder en anpassad värd via ots_set_host, men är äldre än API v2 och de regionala domänerna.

Terminalfönster
# source for use anonymously (secrets created anonymously)
source ots.bash
# or, source with specific auth credentials
APIUSER="USERNAME"
APIKEY="APIKEY"
source ots.bash -u $APIUSER -k $APIKEY
# check status of server
ots_status
# create a secret and get back the URL
URL=$(echo "secret" | ots_share)
# share a multi line secret via HEREDOC.
URL=$(ots_share <<-EOF
This is a Secret
... on multiple lines
EOF
)
# pass options to share or generate.
URL=$(ots_share ttl=600 \
passphrase="shared-secret" \
recipient="someone@somewhere.com" <<< "SECRET")
# fetch the secret data
local DATA="$(ots_retrieve "$URL")"
# share/generate a new secret, and get back the private metadata key
local KEY=$(ots_metashare <<< "SECRET")
local KEY=$(ots_metagenerate)
# get a list of private metadata keys recently created.
# note that this requires valid authentication credentials
local -a RECENT=( $(ots_recent) )
# check on the current state of a secret, given the private key
ots_state $KEY
# burn a secret, given the private key
ots_burn $KEY
Terminalfönster
# Share a secret (from stdin)
./ots share
SECRET
^D
# Share a secret (via HEREDOC)
./ots share <<-EOF
This is a multi-line secret via HEREDOC.
Something else goes here.
EOF
# Get/Retrieve a secret:
./ots get <key|url>
./ots retrieve <key|url>
# Burn a secret, given its private metadata key:
./ots burn <key>