Files

Malin bc9f96cbd4 feat: rebrand Hemmelig to paste.es for cloudhost.es

- Set Spanish as default language with ephemeral/encrypted privacy focus
- Translate all user-facing strings and legal pages to Spanish
- Replace Norwegian flag with Spanish flag in footer
- Remove Hemmelig/terces.cloud links, add cloudhost.es sponsorship
- Rewrite PrivacyPage: zero data collection, ephemeral design emphasis
- Rewrite TermsPage: Spanish law, RGPD, paste.es/CloudHost.es references
- Update PWA manifest, HTML meta tags, package.json branding
- Rename webhook headers to X-Paste-Event / X-Paste-Signature
- Update API docs title and contact to paste.es / cloudhost.es

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-02-24 09:30:19 +01:00

1.9 KiB

Raw Blame History

SDK Generation

Disclaimer: The Hemmelig API is subject to change without notice. Generated SDKs may break with future updates. Use at your own risk.

Hemmelig exposes an OpenAPI 3.0 specification that can be used to generate client SDKs in various programming languages.

OpenAPI Specification

The OpenAPI spec is available at:

Swagger UI: /api/docs - Interactive API explorer
OpenAPI JSON: /api/openapi.json - Raw specification

Generating an SDK

We recommend using OpenAPI Generator which supports 50+ languages.

Installation

npm install -g @openapitools/openapi-generator-cli

Generate SDK

# TypeScript
openapi-generator-cli generate \
  -i https://your-instance.com/api/openapi.json \
  -g typescript-axios \
  -o ./hemmelig-sdk

# Python
openapi-generator-cli generate \
  -i https://your-instance.com/api/openapi.json \
  -g python \
  -o ./hemmelig-sdk

# Go
openapi-generator-cli generate \
  -i https://your-instance.com/api/openapi.json \
  -g go \
  -o ./hemmelig-sdk

View all available generators:

openapi-generator-cli list

Authentication

The API supports two authentication methods:

Bearer Token (API Key)

const client = new HemmeligApi({
    baseURL: 'https://your-instance.com/api',
    headers: {
        Authorization: 'Bearer hemmelig_your_api_key_here',
    },
});

For browser-based applications, session cookies are automatically handled after authentication via /auth endpoints.

Important: Client-Side Encryption

Generated SDKs handle API communication only. You must implement client-side encryption before sending secrets to the API.

Hemmelig uses AES-256-GCM encryption. See the encryption documentation for implementation details.

The decryption key should be passed via URL fragments (#decryptionKey=...) which are never sent to the server.

1.9 KiB Raw Blame History