Enjyn API Services

📍 Base URL

✨ Features

• ✓ Deterministisch: Gleiche E-Mail = gleicher Avatar
• ✓ Keine Datenspeicherung erforderlich
• ✓ SVG-Format für perfekte Skalierung
• ✓ Anpassbare Größe (32-512px)
• ✓ Automatisches Browser-Caching
• ✓ Einfache URL-basierte Integration

📋 Parameter

🚀 Schnellstart

HTML

<img src="https://playground.enjyn.de/avatars/?email=user@example.com&size=128" 
     alt="Avatar">

JavaScript

function getAvatarUrl(email, size = 256) {
    const baseUrl = 'https://playground.enjyn.de/avatars/';
    return `${baseUrl}?email=${email}&size=${size}`;
}

PHP

function getAvatarUrl($email, $size = 256) {
    $baseUrl = 'https://playground.enjyn.de/avatars/';
    $params = http_build_query(['email' => $email, 'size' => $size]);
    return $baseUrl . '?' . $params;
}

🧪 System testen

📍 API Endpoint

✨ Features

• ✓ Foto-Upload von Ausweisen (Vorder-/Rückseite)
• ✓ Automatische Datenextraktion
• ✓ QR-Code für mobile Verifizierung
• ✓ DSGVO-konform
• ✓ Auto-Löschung (Bilder 24h, Sessions 7 Tage)
• ✓ Sichere Token-basierte Validierung

🔌 API Endpoints

1. Session erstellen

POST /api/v1/verify

{
  "vorname": "Max",
  "nachname": "Mustermann",
  "geburtsdatum": "01.01.1990",
  "return_url": "https://ihre-website.de/callback.html"
}

Response

{
  "success": true,
  "session_id": "uuid",
  "token": "secure-token",
  "verify_url": "https://api.verify.enjyn.de/verify/token",
  "qr_url": "https://api.verify.enjyn.de/api/v1/qr-code/token"
}

2. Status sicher abrufen

GET /api/v1/get-result/{session_id}

Response (erfolgreich)

{
  "success": true,
  "status": "verified",
  "vorname": "Max",
  "nachname": "Mustermann",
  "geburtsdatum": "01.01.1990",
  "verified_at": "2025-11-01T06:30:45"
}

📋 Status-Werte

🚀 Integration

// 1. Session erstellen
const response = await fetch('https://api.verify.enjyn.de/api/v1/verify', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        vorname: 'Max',
        nachname: 'Mustermann',
        geburtsdatum: '01.01.1990',
        return_url: 'https://ihre-website.de/callback.html'
    })
});
const data = await response.json();

// 2. Benutzer zur Verifizierung weiterleiten
window.location.href = data.verify_url;

// 3. Nach Callback: Status sicher validieren
const sessionId = new URLSearchParams(window.location.search).get('session_id');
const result = await fetch(
    `https://api.verify.enjyn.de/api/v1/get-result/${sessionId}`
);
const verification = await result.json();

if (verification.status === 'verified') {
    console.log('✓ Verifiziert:', verification.vorname);
}

⚠️ Wichtiger Sicherheitshinweis

📍 Script URL

✨ Features

• ✓ Ein Script-Tag – Website wird automatisch erkannt
• ✓ Widget erscheint unten rechts (konfigurierbar)
• ✓ Automatisches Caching auf dem Server
• ✓ Mehrere Sprachen (EN, NL, FR, ES und mehr)
• ✓ URL-Parameter für direkte Sprachlinks
• ✓ Cookie-Banner kompatibel
• ✓ Texte vom Übersetzen ausschließbar
• ✓ JavaScript API verfügbar

🚀 Integration (eine Zeile reicht)

<script src="https://playground.enjyn.de/translator-kit.js"></script>

Das Widget erscheint automatisch unten rechts und die Website wird erkannt.

⚙️ Konfigurationsoptionen

💡 Anwendungsbeispiele

Minimal (empfohlen)

<script src="https://playground.enjyn.de/translator-kit.js"></script>

Nur Englisch, unten links

<script src="https://playground.enjyn.de/translator-kit.js" 
        data-languages="en"
        data-position="bottom-left">
</script>

Mit Cookie-Banner-Check

<script src="https://playground.enjyn.de/translator-kit.js" 
        data-cookie-check="cookies_accepted">
</script>

Alles angepasst

<script src="https://playground.enjyn.de/translator-kit.js" 
        data-site="shop.beispiel.de"
        data-languages="en,fr"
        data-position="top-right"
        data-preloader="false">
</script>

🔗 URL-Parameter

Nutzer können Seiten direkt in einer Sprache aufrufen:

https://meine-website.de/?en     → Englisch
https://meine-website.de/?fr     → Französisch
https://meine-website.de/?nl     → Niederländisch
https://meine-website.de/?es     → Spanisch

Auch mit anderen Parametern:
https://meine-website.de/seite.php?en&id=123

🚫 Texte vom Übersetzen ausschließen

Füge data-no-translate="true" zum Element hinzu:

<span data-no-translate="true">Dieser Text bleibt immer deutsch</span>
<div data-no-translate="true">Ganzer Bereich wird nicht übersetzt</div>

🛠️ JavaScript API

Das Widget stellt globale Funktionen bereit:

EnjynTranslator.switchLang('en')   → Wechselt zu Englisch
EnjynTranslator.getLang()          → Gibt aktuelle Sprache zurück
EnjynTranslator.config             → Zeigt Konfiguration

💾 Cache

Übersetzungen werden automatisch auf dem Server gespeichert. Der erste Besucher löst die Übersetzung aus – alle weiteren laden sofort aus dem Cache.

/lang/meine-website.de/en.json
/lang/meine-website.de/fr.json
/lang/andere-seite.com/en.json

📍 Übersicht

Enjyn Auth SSO ist eine umfassende Single Sign-On Lösung für sichere Benutzerverwaltung über mehrere Anwendungen hinweg. Implementieren Sie zentrale Authentifizierung mit fortgeschrittenen Sicherheitsfeatures.

✨ Funktionen

• Multi-App SSO: Ein Login für alle Ihre Anwendungen
• Zentrale Verwaltung: Verwalten Sie alle Benutzer an einer Stelle
• 2-Faktor-Authentifizierung: E-Mail und App-basierte Codes
• Session Management: Sichere Session-Verwaltung mit automatischem Timeout
• Audit Logging: Vollständige Nachverfolgung aller Login-Aktivitäten
• Verschlüsselte Sessions: AES-256 Verschlüsselung für alle Sessions

🔒 Sicherheitstechniken

Verschlüsselung

• AES-256-CBC: Industrie-Standard für Session-Verschlüsselung
• TLS/SSL 1.3: Verschlüsselte Datenübertragung (HTTPS)
• PBKDF2: Sichere Password-Hashing mit Salt
• bcrypt: Adaptive Password-Hashing für zusätzliche Sicherheit

Token-Management

• JWT-basierte Access Tokens mit 24-Stunden-Gültigkeit
• Refresh Token Rotation zur Verhütung von Token-Replay-Attacken
• Sichere Token-Speicherung in HTTPOnly Cookies
• CSRF-Protection bei Token-Übertragung

2-Faktor-Authentifizierung

• E-Mail-basierte Authentifizierung mit One-Time-Passwords (OTP)
• TOTP (Time-based One-Time Password) für Authenticator-Apps
• Backup-Codes für Account-Recovery
• Rate Limiting gegen Brute-Force-Angriffe

Session-Sicherheit

• Automatisches Session-Timeout nach Inaktivität
• IP-Binding für Sessionen (optional)
• User-Agent-Validierung
• Mehrfach-Sessions pro User mit Verwaltung

Audit & Compliance

• Vollständiges Audit Logging aller Authentifizierungsereignisse
• DSGVO-konform mit Datensparsamkeit
• Deutsche Server-Infrastruktur
• Recht auf Datenlöschung und Datenportabilität

🚀 Nächste Schritte

Um Enjyn Auth SSO freizuschalten, kontaktieren Sie bitte unseren Sales-Support:

📍 API Endpoint

🔑 Authentication

Alle Anfragen müssen einen API Key im Header enthalten:

X-API-Key: IHR_API_KEY

💻 Code Beispiele

Wählen Sie die gewünschten Funktionen aus, um den passenden Code zu generieren:

// Code wird generiert...

// Code wird generiert...

// Code wird generiert...

📊 Response Codes

📍 API Endpoint

🔑 Authentication

Alle Anfragen müssen einen gültigen API Key im Header enthalten:

X-API-Key: IHR_API_KEY

📌 Endpoints

{
  "note": "Name der Datenbank (max 50 Zeichen)"
}

{
  "note": "Neuer Name"
}

💻 Code Beispiele

// Datenbank erstellen
const createDatabase = async () => {
  const response = await fetch('ENDPOINT/api/databases', {
    method: 'POST',
    headers: {
      'X-API-Key': 'IHR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      note: 'Meine neue Datenbank'
    })
  });
  
  const result = await response.json();
  console.log(result);
};

// Datenbanken abrufen
const getDatabases = async () => {
  const response = await fetch('ENDPOINT/api/databases', {
    method: 'GET',
    headers: {
      'X-API-Key': 'IHR_API_KEY'
    }
  });
  
  const result = await response.json();
  console.log(result);
};

<?php
// Datenbank erstellen
$apiKey = 'IHR_API_KEY';
$apiUrl = 'ENDPOINT/api/databases';

$data = [
    'note' => 'Meine neue Datenbank'
];

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-API-Key: ' . $apiKey
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if ($httpCode === 201) {
    echo 'Datenbank erstellt!';
    print_r($result);
} else {
    echo 'Fehler: ' . $result['error'];
}
?>

import requests
import json

api_key = 'IHR_API_KEY'
api_url = 'ENDPOINT/api/databases'

headers = {
    'X-API-Key': api_key,
    'Content-Type': 'application/json'
}

# Datenbank erstellen
data = {
    'note': 'Meine neue Datenbank'
}

response = requests.post(api_url, headers=headers, data=json.dumps(data))

if response.status_code == 201:
    print('Datenbank erstellt!')
    print(response.json())
else:
    print(f'Fehler: {response.json()["error"]}')

# Datenbanken abrufen
response = requests.get(api_url, headers=headers)

if response.status_code == 200:
    databases = response.json()['data']
    for db in databases:
        print(f"DB: {db['db_name']} - {db['note']}")
else:
    print(f'Fehler: {response.json()["error"]}')

📊 Response Beispiel

{
  "success": true,
  "data": [
    {
      "id": 1,
      "db_name": "db_abc12345",
      "db_user": "user_xyz98765",
      "db_pass": "secure_password_here",
      "note": "Meine Webshop Datenbank",
      "created_at": "2025-01-15 10:30:00",
      "server": "ENDPOINT",
      "port": 3306
    }
  ],
  "message": "Databases retrieved successfully",
  "phpmyadmin_url": "ENDPOINT/phpmyadmin/",
  "timestamp": "2025-01-15T10:35:22+01:00"
}

📊 Response Codes

📍 Übersicht

Preis: 25,00€/Monat

Features:

• Echtzeit-Tracking
• Website erstellung, verwaltung
• Abfrage aller Daten
• White-Label Lösungen

📍 Übersicht

Preis: Kostenlose Bereitstellung, Pay as you go

Sie zahlen nur für die tatsächlich genutzten Ressourcen

Features:

• White-Label Lösungen
• Automatische Abrechnung
• Partner-Dashboard