API Documentation

Incorporate Vanisec into your software applications

Create a Secret

POST/api/secrets

Generate a new confidential entry and receive a distributable URL.

Request Body

{
  "secret": "string (required)",
  "password": "string (optional)",
  "expiresIn": number (optional, hours, default: 24)
}

Response

{
  "id": "string",
  "url": "string"
}

Example Usage

cURL

curl -X POST https://vanisec.clouddrove.com/api/secrets \
  -H "Content-Type: application/json" \
  -d '{
    "secret": "my-secret-api-key",
    "password": "optional-password",
    "expiresIn": 24
  }'

JavaScript

const response = await fetch('https://vanisec.clouddrove.com/api/secrets', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    secret: 'my-secret-api-key',
    password: 'optional-password',
    expiresIn: 24
  })
});

const data = await response.json();
console.log(data.url); // Share this URL

Rate Limits

Presently, the API operates without rate restrictions. We maintain the option to introduce rate limiting subsequently to guarantee equitable usage across all users.

Open Source

Vanisec operates as open-source software. You can examine the codebase, participate in development, or deploy your own version.

View on GitHub