Documentation

Documentation

The application has a small and simple plain text API specifically tailored to create secrets and passwords using curl. The settings for views and days are defaulted to 3 and 5, respectively. They can be overridden by providing the views and days query or post parameters. The API will return json data if the Accept header is application/json

Create secret

A secret can be provided as a query parameter, post parameter or as post data in the request.

Examples

Create a secret using post data

curl -d "lots of secret content" https://secrets.glesys.com/api

Create a secret using post data loaded from a file, with changed views and days

curl --data-binary @/path/to/file.txt "https://secrets.glesys.com/api?days=1&views=1"

Create a secret using post from stdin

./some-script-that-generates-passwords.sh | curl --data-binary @- https://secrets.glesys.com/api

Generate a password

Generate a secure password by performing a GET request or create a secret for the password by performing a POST request.

Examples

Generate a password

curl https://secrets.glesys.com/api/password

Generate a password and create a secret, with changed views and days.

curl -d "days=1" -d "views=1" https://secrets.glesys.com/api/password