API Reference

Secure Compact Tokenization — REST API v1

Base URL

https://sct.simosphereai.com/api/v1

Authentication

Authorization: Bearer sct_xxxxx

API Key oder JWT Token

Pseudonymisierung

POST/api/v1/pseudonymizeDaten pseudonymisieren (JSON/CSV/XML)
POST/api/v1/de-pseudonymizeDaten de-pseudonymisieren mit Key
POST/api/v1/detect-piiPII-Erkennung in Text
POST/api/v1/pseudonymize/fileDatei pseudonymisieren (Multipart)
POST/api/v1/de-pseudonymize/fileDatei de-pseudonymisieren

E2E Encrypted DataStream

POST/api/v1/stream/e2eSingle-Shot E2E-verschlüsselte Verarbeitung
POST/api/v1/stream/sessionStreaming-Session öffnen
POST/api/v1/stream/chunkChunk in Session verarbeiten
GET/api/v1/stream/session/:idSession-Status abfragen
GET/api/v1/stream/session/:id/auditAudit Trail einer Session
POST/api/v1/stream/session/:id/closeSession schließen

Tokenizer Speedup

POST/api/v1/tokenizer/optimizeText für LLM-Tokens optimieren
POST/api/v1/tokenizer/countToken-Anzahl zählen

LLM Proxy

POST/api/v1/llm/proxyPseudonymize → LLM → De-Pseudonymize
GET/api/v1/llm/configLLM-Konfiguration abrufen
PUT/api/v1/llm/configLLM-Konfiguration speichern

Authentifizierung

POST/api/v1/auth/registerNeuen Account erstellen
POST/api/v1/auth/loginAnmelden und JWT erhalten
GET/api/v1/auth/meAktuellen Benutzer abrufen
POST/api/v1/auth/api-keysNeuen API Key erstellen
GET/api/v1/auth/api-keysAPI Keys auflisten

Webhooks

POST/api/v1/webhooksWebhook registrieren
GET/api/v1/webhooksWebhooks auflisten
DELETE/api/v1/webhooks/:idWebhook entfernen

Nutzung & Kosten

GET/api/v1/usageNutzungsstatistiken
GET/api/v1/usage/costsKostenaufschlüsselung

Quick Start

1. API Key erstellen

curl -X POST https://sct.simosphereai.com/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"secure123","name":"Your Name"}'

2. Daten pseudonymisieren

curl -X POST https://sct.simosphereai.com/api/v1/pseudonymize \
  -H "Authorization: Bearer sct_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"data":"{\"name\":\"Max Mustermann\",\"email\":\"[email protected]\"}","format":"json"}'

3. Mit Key entschlüsseln

curl -X POST https://sct.simosphereai.com/api/v1/de-pseudonymize \
  -H "Authorization: Bearer sct_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"data":"<pseudonymized>","encryption_key":"<key_from_step_2>"}'