Zum Inhalt springen
DE

REST API v1

Einmallinks aus Ihrem Code.

Erstellen Sie Geheimnisse und Anfragen aus Ihrer eigenen Anwendung, Ihrem Helpdesk oder einem Skript. Die API ist in den Paketen Pro und Pro Plus verfügbar.

API-Schlüssel erstellen Pakete mit API

Authentifizierung

Erstellen Sie einen API-Schlüssel unter Konto → API. Senden Sie ihn im Header Authorization als Bearer-Token. Alle Anfragen laufen über HTTPS.

Authorization: Bearer kx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

GET https://kriptano.com/api/v1/me

Das Anfragelimit hängt vom Paket ab (Pro 60/Min., Pro Plus 300/Min.). Erstellte Geheimnisse zählen zum monatlichen Kontingent des Pakets.

Geheimnis erstellen

Am einfachsten: Senden Sie Klartext über HTTPS – der Server verschlüsselt ihn mit demselben Algorithmus wie der Browser, speichert den Schlüssel nicht und gibt den vollständigen Link samt Schlüssel zurück.

curl -X POST https://kriptano.com/api/v1/secrets \
  -H "Authorization: Bearer $KRIPTANO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "secret": "User: anna\nPassword: Gx7!pQ2m",
    "expires": 604800,
    "views": 1,
    "passphrase": "",
    "label": "Hosting – client Smith",
    "notify": true
  }'

Antwort (201):

{
  "id": "7GkQ2mPzr9XtWbHa",
  "url": "https://kriptano.com/s/7GkQ2mPzr9XtWbHa/#k9Xv3…Qe1s",
  "status": "active",
  "views": 0,
  "max_views": 1,
  "expires_at": "2026-11-13T09:00:00+00:00"
}
FeldBeschreibung
secretText des Geheimnisses (bis ca. 90.000 Zeichen).
filesOptional: [{"name","type","data"(base64)}] – Anhänge, sofern das Paket sie erlaubt.
expiresGültigkeit in Sekunden: 3600, 86400, 259200, 604800, 1209600, 2592000, 7776000, 15552000, 31536000 (bis zum Limit des Pakets).
viewsAnzahl der Aufrufe (Standard 1).
passphraseOptional: zusätzliches Passwort, das der Empfänger eingeben muss.
labelInterne Bezeichnung (nur für Sie sichtbar; keine geheimen Daten eintragen).
notifytrue = E-Mail-Benachrichtigung, wenn das Geheimnis geöffnet wird.
uploadsOptional: [{"id","token"}] – bereits hochgeladene große Anhänge (siehe Große Anhänge); nur mit Chiffrat.
deliver_toOptional (Pro, Pro Plus): bis zu 5 Adressen, an die Kriptano den Link sofort per E-Mail sendet. Funktioniert, wenn Sie Klartext senden (secret).
deliver_noteOptional: eine kurze Nachricht an den Empfänger (bis 500 Zeichen, ohne HTML). Keine vertraulichen Daten eintragen – die Nachricht ist nicht verschlüsselt.

Für vollständiges Zero-Knowledge verschlüsseln Sie auf Ihrer Seite (nächster Abschnitt) – dann sieht der Server weder den Klartext noch den Schlüssel.

Passwort-Generator

GET oder POST /password liefert zufällige Passwörter, Passphrasen oder PINs. Funktioniert in jedem Paket: ohne API-Schlüssel (pro IP-Adresse begrenzt) oder mit Schlüssel in Pro und Pro Plus (Limit Ihres Pakets). Nichts wird gespeichert oder protokolliert; die Antwort hat Cache-Control: no-store. Für maximale Privatsphäre im Browser auf der Seite Passwort-Generator erzeugen.

curl "https://kriptano.com/api/v1/password?length=20&count=3"

curl "https://kriptano.com/api/v1/password?type=passphrase&words=6&separator=-&capitalize=first&wordlist=de&format=text"

Antwort (201):

{
  "type": "password",
  "passwords": ["q7#Vt9…", "…", "…"],
  "password": "q7#Vt9…",
  "length": 20,
  "entropy_bits": 131.1,
  "strength": "very_strong",
  "charset_size": 94
}
FeldBeschreibung
typepassword (Standard), passphrase, pin oder pronounceable.
lengthLänge: password 4–128 (20), pin 4–12 (6), pronounceable 6–64 (18).
countWie viele auf einmal: 1–100.
lowercase, uppercase, numbers, symbolsZeichenarten (true/false; standardmäßig alle an). Mindestens ein Zeichen jeder aktiven Art.
symbol_set, extended_symbols, exclude, exclude_similarEigene Sonderzeichen, erweiterte Sonderzeichen, auszuschließende Zeichen, ohne ähnliche Zeichen (I l 1 | O 0 o).
min_numbers, min_symbols, start_with_letterMindestanzahl Zahlen und Sonderzeichen (Standard 1), erstes Zeichen ein Buchstabe.
words, separator, capitalize, include_number, include_symbol, wordlistPassphrase: 3–20 Wörter, Trennzeichen (- . _ space none digit symbol), capitalize (none, first, upper, random), Zahl und Sonderzeichen, Wortliste en, de, fr, it, es, bcms oder sl.
formatjson (Standard) oder text – ein Passwort pro Zeile.

Erzeugen und senden in einem Aufruf: "generate" statt "secret" in POST /secrets (Pro, Pro Plus). Der Server erzeugt das Passwort, verschlüsselt es als Einmal-Geheimnis und liefert Link und Passwort (außer mit "return_password": false).

curl -X POST https://kriptano.com/api/v1/secrets \
  -H "Authorization: Bearer $KRIPTANO_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "generate": { "type": "password", "length": 24 }, "expires": 86400, "views": 1, "deliver_to": ["anna@client.com"] }'

→ { "id": "…", "url": "https://kriptano.com/s/…#…", "password": "…", "status": "active", … }

Limits ohne Schlüssel: 30 Anfragen pro Minute und 1.000 pro Tag und IP-Adresse (bei Überschreitung HTTP 429). Mit Schlüssel: 60 (Pro) oder 300 (Pro Plus) pro Minute.

Verschlüsselung auf Ihrer Seite

Format: AES-256-GCM, 32-Byte-Schlüssel, 12-Byte-IV, Chiffrat = "v1." + base64url(IV) + "." + base64url(Chiffrat+Tag). Der Inhalt ist JSON {"v":1,"t":"Text"}. Das Token „auth” = base64url(SHA-256(Schlüssel ‖ "kriptano-auth")). Empfohlen: Feld „link” = base64url(SHA-256(Schlüssel ‖ "kriptano-link")) – Nachweis, dass Sie den Link besitzen; ohne dieses Feld verbraucht ein falsches zusätzliches Passwort auch dann Versuche, wenn jemand nur die ID kennt.

// Node.js 18+ / browser (Web Crypto)
const te = new TextEncoder();
const b64u = (b) => Buffer.from(b).toString('base64url');
const raw = crypto.getRandomValues(new Uint8Array(32));          // key – stays with you
const iv  = crypto.getRandomValues(new Uint8Array(12));
const key = await crypto.subtle.importKey('raw', raw, 'AES-GCM', false, ['encrypt']);
const body = te.encode(JSON.stringify({ v: 1, t: 'Password: Gx7!pQ2m' }));
const ct  = new Uint8Array(await crypto.subtle.encrypt({ name: 'AES-GCM', iv }, key, body));
const auth = b64u(new Uint8Array(await crypto.subtle.digest('SHA-256',
  new Uint8Array([...raw, ...te.encode('kriptano-auth')]))));

const res = await fetch('https://kriptano.com/api/v1/secrets', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.KRIPTANO_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ ciphertext: `v1.${b64u(iv)}.${b64u(ct)}`, auth, expires: 86400, views: 1 })
}).then(r => r.json());

console.log(res.url + '#' + b64u(raw));   // link for the recipient

Mit zusätzlichem Passwort: endgültiger Schlüssel = PBKDF2-SHA256(Passwort, Salt = Schlüssel aus dem Link, 600.000 Iterationen, 32 Byte); damit verschlüsseln und „auth” berechnen, und der Anfrage "passphrase": true, "kdf": 600000 hinzufügen.

Liste, Status und Löschen

GET    https://kriptano.com/api/v1/secrets?status=active&page=1&per_page=25
GET    https://kriptano.com/api/v1/secrets/{id}
DELETE https://kriptano.com/api/v1/secrets/{id}

Die Antwort enthält nur Metadaten (Status, Anzahl der Aufrufe, Zeit) – nie den Inhalt. Die Gesamtzahl steht im Header X-Total-Count.

<?php
$ch = curl_init( 'https://kriptano.com/api/v1/secrets' );
curl_setopt_array( $ch, [
  CURLOPT_POST           => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [ 'Authorization: Bearer ' . getenv( 'KRIPTANO_KEY' ), 'Content-Type: application/json' ],
  CURLOPT_POSTFIELDS     => json_encode( [ 'secret' => 'PIN: 4821', 'expires' => 3600 ] ),
] );
$res = json_decode( curl_exec( $ch ), true );
echo $res['url'];

Große Anhänge (bis 10 GB)

Kleinere Anhänge können im Feld files mitgesendet werden (base64, bis 25 MB, vom Server verschlüsselt). Größere Dateien verschlüsseln Sie auf Ihrer Seite in Teilen und senden sie über signierte Links direkt an den Speicher – der Kriptano-Server sieht weder Inhalt noch Schlüssel. Bricht die Verbindung ab, fordern Sie neue Links nur für die fehlenden Teile an.

POST https://kriptano.com/kx-api/uploads            (Authorization: Bearer kx_live_…)
{ "files": [ { "size": 734003200 } ] }
→ { "chunk": 16777216, "tag": 16, "ttl": 10800,
    "uploads": [ { "id": "…", "token": "…", "parts": 44, "urls": [ "https://…", … ] } ] }

PUT  urls[n-1]          ← encrypted chunk n (chunk + 16 B; the last one may be shorter)
POST https://kriptano.com/kx-api/uploads/{id}/urls     { "token": "…", "parts": [7, 8] }   (new links)
POST https://kriptano.com/kx-api/uploads/{id}/complete { "token": "…" }

POST https://kriptano.com/api/v1/secrets
{ "ciphertext": "v1.…", "auth": "…", "uploads": [ { "id": "…", "token": "…" } ] }

Format: Jeder Teil ist AES-256-GCM mit dem Dateischlüssel (256 Bit), Nonce = 3 Null-Bytes ‖ Index des Teils (64 Bit, Big-Endian) ‖ 1 Byte (1 für den letzten Teil), AAD = „kriptano-file-v1”. Dateischlüssel und Dateidaten (id, Name, Typ, Größe, Teilgröße) kommen in den verschlüsselten Inhalt des Geheimnisses als {"f":[{"v":2,"id","n","m","s","k","c"}]}. Referenzimplementierung: assets/js/files.js.

Versand per E-Mail

Mit deliver_to sendet Kriptano den Link selbst an den Empfänger – von Ihrer E-Mail-Domain oder über Ihren SMTP-Server (Pro Plus), sonst von einer Kriptano-Adresse. Der Schlüssel steckt im Link, daher wird die E-Mail nur gesendet, wenn der Server ihn kennt (Klartext); bei Geheimnissen, die Sie selbst verschlüsseln, senden Sie den Link selbst. Die Antwort enthält delivered und, falls der Versand fehlschlug, delivery_error – das Geheimnis wird trotzdem erstellt.

POST https://kriptano.com/api/v1/secrets
{ "secret": "VPN: user / password", "expires": 86400,
  "deliver_to": [ "anna@client.com" ], "deliver_note": "Access for the new office." }
→ { "id": "…", "url": "https://…/s/…#…", "delivered": true, … }

POST https://kriptano.com/api/v1/requests
{ "label": "FTP access", "public_key": "…", "deliver_to": [ "mark@client.com" ] }

Anfragen nach Geheimnissen

Eine Anfrage verschlüsselt die Antworten mit Ihrem öffentlichen RSA-Schlüssel. Das Schlüsselpaar erzeugen Sie selbst; der private Schlüssel bleibt bei Ihnen, damit entschlüsseln Sie die Antworten.

POST https://kriptano.com/api/v1/requests
{ "label": "FTP access", "instructions": "Please send the host, username and password.",
  "public_key": "<SPKI RSA-OAEP 2048, base64url>", "expires_days": 14, "max_responses": 1 }

GET  https://kriptano.com/api/v1/requests/{id}/responses
→ [ { "id": "…", "ciphertext": "r1.<RSA-OAEP(AES key)>.<iv>.<AES-GCM ciphertext>", "created_at": "…" } ]

Protokoll

Die Ereignisse Ihres Kontos (Pro, Pro Plus) für ein SIEM oder Archiv: Zeitraum (from, to), Typ, bis zu 500 pro Seite. Das Protokoll enthält nie den Inhalt von Geheimnissen, Schlüssel oder Links; das Land stammt aus einer lokalen Geolokalisierungsdatenbank. Dieselben Daten wie in der CSV-Datei: Konto → Protokoll → CSV exportieren.

GET https://kriptano.com/api/v1/log?from=2026-11-01&to=2026-11-30&type=secret_viewed&page=1&per_page=100
→ [ { "id": 812, "time": "2026-11-08T09:14:02+00:00", "type": "secret_viewed", "event": "Secret opened",
      "user": null, "country": "HR", "object_id": "…", "message": "…" } ]      (X-Total-Count: 37)

Webhooks

Pro und Pro Plus: Fügen Sie unter Mein Konto → Webhooks eine HTTPS-Adresse hinzu und wählen Sie Ereignisse. Kriptano sendet unmittelbar danach einen JSON-POST; Inhalt, Schlüssel und Link des Geheimnisses sind nie enthalten (der Server kennt sie nicht).

Ereignisse: secret.created, secret.viewed, secret.locked, secret.deleted, secret.expired, request.created, request.answered, team.member_joined, team.member_removed, ping.

POST https://example.com/hooks/kriptano
Content-Type: application/json; charset=utf-8
Kriptano-Event: secret.viewed
Kriptano-Delivery: evt_3kT9…
Kriptano-Signature: t=1762770000,v1=5f2c…e91a

{ "id": "evt_3kT9…", "type": "secret.viewed", "created": "2026-11-10T09:14:02Z",
  "data": { "secret": { "id": "Qm7x…", "label": "Hosting – client Smith", "status": "burned",
            "views": 1, "max_views": 1, "has_passphrase": true, "files": false, "source": "web",
            "created_at": "…", "expires_at": "…", "viewed_at": "…" },
            "viewer": { "country": "HR" } } }

Prüfen Sie die Signatur: HMAC-SHA256 über „t.Body” mit dem Schlüssel whsec_… muss v1 entsprechen, und t darf höchstens 5 Minuten alt sein. Verwenden Sie den unveränderten Request-Body (vor dem JSON-Parsing).

// Node.js
const crypto = require('crypto');
function verify(rawBody, header, secret) {           // header = req.headers['kriptano-signature']
  const p = Object.fromEntries(header.split(',').map(s => s.split('=')));
  if (Math.abs(Date.now() / 1000 - Number(p.t)) > 300) return false;
  const mac = crypto.createHmac('sha256', secret).update(p.t + '.' + rawBody).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(p.v1));
}

# PHP
$p = []; parse_str(str_replace(',', '&', $_SERVER['HTTP_KRIPTANO_SIGNATURE']), $p);
$ok = abs(time() - (int) $p['t']) <= 300
   && hash_equals(hash_hmac('sha256', $p['t'] . '.' . file_get_contents('php://input'), $secret), $p['v1']);

Antworten Sie innerhalb von 10 Sekunden mit 2xx. Bei Fehlern oder Zeitüberschreitung folgen Wiederholungen nach 1 min, 5 min, 30 min, 2 h, 6 h und 12 h; Status 410 beendet die Zustellung. Nach 50 Fehlschlägen in Folge wird der Webhook deaktiviert. Dasselbe Ereignis kann doppelt ankommen – nutzen Sie das Feld id (Kriptano-Delivery) zur Deduplizierung.

Fehler

HTTPBeschreibung
400Ungültige Daten (Meldung im Feld "message").
401API-Schlüssel fehlt oder ist ungültig.
402Das Paket enthält keine API.
403Paketlimit überschritten (Gültigkeit, Anzahl der Aufrufe, Anhänge).
404 / 410Das Geheimnis existiert nicht, wurde bereits geöffnet oder ist abgelaufen.
413Der Inhalt ist zu groß.
429Zu viele Anfragen oder das Monatskontingent ist aufgebraucht.

Integrationen

Wann sich die REST-API lohnt

Die Integration ist für Teams, die Passwörter aus eigenen Systemen versenden: ein Helpdesk, der ein temporäres Passwort schickt, ein CRM, das einem neuen Kunden Zugangsdaten übermittelt, oder ein Skript, das nach dem Einrichten eines Servers einen Einmallink sendet.

Sie können das Geheimnis selbst verschlüsseln (Web Crypto, AES-256-GCM – siehe die MDN-Dokumentation) und nur das Chiffrat senden, oder Sie senden Klartext über HTTPS – der Server verschlüsselt ihn im selben Format und speichert den Schlüssel nie.

Einen API-Schlüssel erstellen Sie im Konto in den Paketen Pro und Pro Plus (Pakete vergleichen). Erstellte Geheimnisse zählen zum monatlichen Kontingent des Pakets.

Die Antwort enthält den Link mit dem Schlüssel nach dem #, den Ablauf und die Anzahl der verbleibenden Aufrufe. Den Link geben Sie wie jeden anderen weiter – per E-Mail, Nachricht oder in der Oberfläche Ihrer Anwendung. Öffnet der Nutzer das Geheimnis, wird das Chiffrat gelöscht, und in Ihrer Liste erscheint es als geöffnet.

Eine Anfrage nach einem Geheimnis funktioniert umgekehrt: Ihr System erstellt einen Link, über den der Kunde die Daten eingibt, und die Antwort wird mit einem öffentlichen Schlüssel verschlüsselt, den Sie selbst erzeugt haben. So bleiben die Antworten für alle außer Ihnen unlesbar.

  1. Kriptano REST-API – Geheimnis, Verschlüsselung, Link und einmaliges ÖffnenGeheimnis eingeben
  2. Im Browser verschlüsseltIm Browser verschlüsselt
  3. Link sendenLink senden
  4. Einmal geöffnet, dann wegEinmal geöffnet, dann weg