// API-DOKUMENTATION

Technische Referenz

Vollständige API-Dokumentation, SDK-Guides und Code-Beispiele für alle 10 KI-Dienste.

Quickstart

In unter 5 Minuten zur ersten KI-Anfrage. Alle Dienste sind per REST-API aufrufbar und über unser PHP- und Java-SDK direkt integrierbar. Für eine erste Orientierung empfiehlt sich die Live-Demo ohne API-Key.

1. API-Key erhalten

Wählen Sie einen Plan oder kontaktieren Sie uns über das Kontaktformular. Nach Freischaltung erhalten Sie Ihren Key per E-Mail im Format ncod3v_xxxxxxxxxxxxxxxxxxxx.

2. Authentifizierung

Jede API-Anfrage benötigt zwei Header:

HTTP-Header
X-API-Key: ncod3v_ihr_key_hier
Content-Type: application/json
X-Requested-With: XMLHttpRequest

PHP SDK

Installation via Composer — unterstützt PHP 7.4 und höher:

bash
composer require ncod3v/ai-sdk
PHP — Vollständige Initialisierung
use Ncod3v\AI\Client;

// API-Key aus Umgebungsvariable (empfohlen)
$ai = new Client(
  apiKey: $_ENV['NCOD3V_API_KEY'],
  timeout: 60, // Sekunden
  retries: 2 // Auto-Retry bei 429/503
);

// Verfügbare Methoden:
$ai->analyzeCode($code, $language);
$ai->generateText($prompt, $type, $tone);
$ai->chat($messages, $persona);
$ai->analyzeDocument($text, $task);
$ai->translate($text, $targetLang);
$ai->generateSQL($description, $dialect);
$ai->optimizeCV($cv, $jobDescription, $mode);
$ai->checkPrivacy($text, $docType);
$ai->generateMeetingProtocol($notes, $title);
$ai->triageEmail($emailContent);
$ai->analyzeSEO($content, $keyword);

Java SDK (Maven)

pom.xml
<dependency>
  <groupId>de.ncod3v</groupId>
  <artifactId>ai-sdk</artifactId>
  <version>4.1.0</version>
</dependency>
Java — Initialisierung & Nutzung
import de.ncod3v.ai.*;

NcAiClient ai = new NcAiClient.Builder()
  .apiKey(System.getenv("NCOD3V_API_KEY"))
  .timeout(Duration.ofSeconds(60))
  .build();

// Code-Analyse
AnalysisResult r = ai.analyzeCode(
  CodeRequest.builder()
    .code(sourceCode)
    .language("java")
    .build()
);
System.out.println(r.getQualityScore()); // 0–100

// SQL generieren
SqlResult sql = ai.generateSql("Alle User der letzten 30 Tage", "MySQL");
System.out.println(sql.getSql());

REST API (curl)

curl — universelles Beispiel
curl -X POST https://ai.noclone.de/api/analyze.php \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: ncod3v_ihr_key' \
  -H 'X-Requested-With: XMLHttpRequest' \
  -d '{"code":"<?php echo $_GET[\"q\"]; ?>","language":"php"}'

JavaScript Widget (Quantum-Chat)

Den Chatbot in 2 Zeilen auf jeder Seite einbinden:

HTML
<script
  src="https://ai.noclone.de/widget/chat.js"
  data-key="ncod3v_ihr_key"
  data-persona="Support-Bot"
  data-color="#00ff88"
  data-position="bottom-right"
></script>

Webhooks & Cron-Integration

Alle Dienste lassen sich in automatisierte Pipelines integrieren. Typisches Muster: IMAP / Webhook → KI → Datenbank / Slack / Jira.

PHP — E-Mail-Triage via IMAP (Cron alle 5 Min)
$inbox = imap_open('{mail.server.de:993/imap/ssl}INBOX', $user, $pass);
$mails = imap_search($inbox, 'UNSEEN') ?: [];
$ai = new AIClient();

foreach ($mails as $id) {
  $body = quoted_printable_decode(imap_fetchbody($inbox, $id, '1'));
  $result = $ai->triageEmail($body);
  $p = json_decode($result['text'], true);

  if ($p['priority'] === 'critical') {
    postToSlack('#urgent', $p['summary']);
  }
  saveToDatabase($p);
}

Code-Analyse

Endpoint: POST /api/analyze.php

// Request
{ "code": "string", "language": "auto|php|java|python|js|sql|go|..." }
// Response
{
  "result": "Zusammenfassung",
  "parsed": {
    "language": "PHP",
    "quality_score": 82, // 0–100
    "bugs": [{ "line": 12, "severity": "critical", "description": "...", "fix": "..." }],
    "security_issues": [{ "type": "SQL-Injection", "description": "..." }],
    "suggestions": ["Tipp 1", "Tipp 2"],
    "summary": "Gesamtbewertung"
  },
  "tokens_in": 340, "tokens_out": 520, "duration_ms": 1840
}

Neuro-Text

Endpoint: POST /api/generate.php

// Request
{
  "prompt": "string",
  "type": "blog|marketing|email|readme|summary|general",
  "tone": "professional|casual|technical|persuasive|formal",
  "language": "Deutsch|Englisch|..."
}
// Response
{ "result": "generierter Text", "tokens_out": 820, "duration_ms": 2100 }

Quantum-Chat

Endpoint: POST /api/chat.php — Unterstützt Multi-Turn via messages-Array.

// Request
{
  "messages": [
    { "role": "user", "content": "Erste Nachricht" },
    { "role": "assistant", "content": "Antwort" },
    { "role": "user", "content": "Folge-Frage" }
  ],
  "persona": "n0cl0n3.AI", // optional
  "system_extra": "Kontext-Text" // optionaler System-Prompt-Zusatz
}
// Response
{ "result": "Antwort des Assistenten", "tokens_in": 180, "tokens_out": 340, "duration_ms": 1200 }

Doc-Scanner

Endpoint: POST /api/analyze.php — Wird durch das document-Feld vom Code-Analyse-Endpoint unterschieden.

// Request
{
  "document": "Dokumenten-Text (max. 8000 Zeichen)",
  "task": "summary|extract|classify|qa"
}
// Response
{ "result": "strukturierte Analyse", "tokens_out": 610, "duration_ms": 2400 }

Übersetzungsmatrix

Endpoint: POST /api/translate.php

// Request
{
  "text": "Zu übersetzender Text",
  "target_lang": "Englisch",
  "source_lang": "auto", // oder z.B. "Deutsch"
  "domain": "general|technical|legal|medical|marketing"
}
// Response
{ "result": "Übersetzung", "tokens_out": 290, "duration_ms": 980 }

SQL-Generator

Endpoint: POST /api/sql.php

// Request
{
  "description": "Alle User der letzten 30 Tage mit Bestellanzahl > 3",
  "dialect": "MySQL|PostgreSQL|SQLite|Microsoft SQL Server|Oracle",
  "schema": "CREATE TABLE users (...)", // optional
  "mode": "generate|explain|optimize|fix"
}
// Response
{
  "result": "SELECT ...",
  "parsed": {
    "sql": "SELECT u.*, COUNT(o.id) AS order_count FROM ...",
    "explanation": "Erklärung auf Deutsch",
    "performance_notes": ["Index auf last_login empfohlen"],
    "indexes_suggested": ["CREATE INDEX idx_login ON users(last_login)"],
    "warnings": []
  },
  "tokens_out": 380, "duration_ms": 1540
}

CV/Bewerbungs-Optimierer

Endpoint: POST /api/cv.php

// Request
{
  "cv": "Lebenslauf-Text",
  "job": "Stellenausschreibungs-Text",
  "mode": "optimize|coverletter|ats|gap"
}
// Response
{ "result": "optimierter CV / Anschreiben / Gap-Analyse", "tokens_out": 1240 }

DSGVO-Checker

Endpoint: POST /api/datenschutz.php

// Request
{
  "text": "Datenschutzerklärung / AGB / Einwilligung",
  "doc_type": "datenschutzerklaerung|agb|einwilligung|auftragsverarbeitung|impressum"
}
// Response
{
  "result": "Gesamtbewertung",
  "parsed": {
    "compliance_score": 72,
    "risk_level": "low|medium|high|critical",
    "issues": [{ "article": "Art. 13 DSGVO", "severity": "critical", "description": "...", "recommendation": "..." }],
    "missing_elements": ["Fehlendes Pflichtfeld"],
    "positive_aspects": ["Gut umgesetzt"]
  }
}

Meeting-Protokoll

Endpoint: POST /api/meeting.php

// Request
{
  "notes": "Rohnotizen / Stichwörter",
  "title": "Sprint Planning Q2", // optional
  "date": "2025-05-26", // optional
  "participants": ["Max Mustermann", "Anna Schmidt"] // optional
}
// Response
{ "result": "## Meeting-Protokoll\n\n**Datum:** ...", "tokens_out": 920 }

E-Mail-Triage

Endpoint: POST /api/email-triage.php

// Request
{
  "email": "Betreff + E-Mail-Inhalt",
  "context": "Ich bin Geschäftsführer eines SaaS-Unternehmens" // optional
}
// Response
{
  "result": "Kurze Zusammenfassung",
  "parsed": {
    "priority": "critical|high|medium|low",
    "category": "Anfrage|Beschwerde|Info|Aufgabe|Meeting|...",
    "sentiment": "positiv|neutral|negativ|dringend",
    "key_points": ["Punkt 1"],
    "action_items": ["Aufgabe bis Fr"],
    "suggested_reply": "Antwort-Entwurf",
    "suggested_subject": "Re: ..."
  }
}

SEO-Content-Analyse

Endpoint: POST /api/seo.php

// Request
{
  "content": "Seiten-Text / Artikel (max. 6000 Zeichen)",
  "keyword": "KI-Code-Analyse", // optional
  "url": "https://example.de/seite" // optional
}
// Response
{
  "result": "Gesamtbewertung",
  "parsed": {
    "overall_score": 68,
    "readability_score": 74,
    "issues": [{ "type": "...", "severity": "warning", "fix": "..." }],
    "meta_suggestions": { "title": "...", "description": "..." }
  }
}

📱 Social Media Generator NEU · PRO+

Endpoint: POST /api/social.php — Plattform-optimierter Content für 7 Netzwerke. Algorithmus-Regeln und Zeichenlimits werden pro Plattform automatisch angewendet.

// Request
{
  "topic": "Unser neues KI-Tool spart 80% Entwicklungszeit",
  "platforms": ["instagram", "linkedin", "twitter", "tiktok"],
  "tone": "professional", // professional|casual|viral|educational|motivational
  "industry": "Tech", // optional
  "keywords": ["KI", "Startup"], // optional
  "cta": "Jetzt testen", // optional
  "language": "Deutsch"
}
// Response
{
  "parsed": {
    "topic_analysis": "Zielgruppen-Analyse...",
    "content": {
      "instagram": { "post": "...", "hashtags": [], "story_idea": "..." },
      "linkedin": { "post": "...", "hashtags": [] },
      "twitter": { "tweet": "...", "thread": [] },
      "tiktok": { "script": "...", "hook": "...", "sound_suggestion": "..." }
    },
    "best_times": { "instagram": "Di-Fr 11-13 Uhr" },
    "engagement_tips": []
  },
  "tokens_in": 420, "tokens_out": 1840, "duration_ms": 3200
}

📊 Startup Kalkulator NEU · PRO+

Endpoint: POST /api/startup.php — Vollständige Geschäftsideen-Analyse: Erfolgswahrscheinlichkeit, 3 Finanzszenarien, Markt-TAM/SAM/SOM, Risikoanalyse und 12-Monats-Aktionsplan.

// Request
{
  "idea": "KI-gestützte Buchhaltung für Freelancer",
  "industry": "FinTech",
  "target_group": "Selbstständige & Freelancer",
  "location": "Deutschland",
  "capital": 25000,
  "founders": 2,
  "experience": "hoch", // gering|mittel|hoch|experte
  "business_model": "saas" // B2B|B2C|saas|marketplace|ecommerce
}
// Response
{
  "parsed": {
    "success_probability": { "overall": 73, "factors": { "markt": { "score": 80, "reason": "..." } } },
    "financial_projection": {
      "startup_costs": { "einmalig": 18000, "laufend_monat": 2400 },
      "break_even_months": 14,
      "revenue_scenarios": { "realistisch": { "monat12": 8500 } }
    },
    "risks": [{ "risk": "...", "probability": "mittel", "mitigation": "..." }],
    "action_plan": { "monat_1_3": [], "monat_4_6": [], "monat_7_12": [] },
    "verdict": "EMPFOHLEN",
    "recommended_legal_form": { "form": "UG (haftungsbeschränkt)", "reason": "..." }
  }
}

Enterprise-Module

Die folgenden Module sind ausschließlich im Enterprise-Plan verfügbar und erfordern eine persönliche Beratung für Setup und Integration. Alle Enterprise-Module können On-Premise betrieben werden.

📄 Vertrags-Analyse

Risikoklauseln, Nachverhandlungs-Guide, Due-Diligence.

/api/contract.php
→ Dokumentation & Spezifikation
🔄 Code-Migration

Legacy-Code modernisieren: PHP 5→8, jQuery→Vanilla, Monolith→Microservices.

/api/migrate.php
→ Dokumentation & Spezifikation
📊 Feedback-Analyse

Massenanalyse von Reviews, Tickets, NPS — Pain-Points & Feature-Priorisierung.

/api/feedback.php
→ Dokumentation & Spezifikation
🧠 RAG-Pipeline

Claude auf Ihrer eigenen Wissensbasis. Quellenangabe garantiert.

/api/rag.php
→ Dokumentation & Spezifikation
🔌 WordPress Plugin Generator

Vollständige WP-Plugins on-demand. Exklusiv im Kundenportal (Pro+).

/portal/
→ Dokumentation & Spezifikation
Enterprise anfragen →

Fehlerbehandlung

Alle Endpoints geben HTTP 200 zurück. Fehler werden über das error-Feld signalisiert:

{ "error": "Demo-Limit erreicht (5/Tag). Bitte API-Key verwenden." }
Fehler Bedeutung & Lösung
Kein API-Key konfiguriert CLAUDE_API_KEY fehlt in .env — Key auf console.anthropic.com erstellen
Demo-Limit erreicht 5 Demo-Anfragen/24h pro Dienst überschritten — API-Key einsetzen
Ungültige Anfrage Kein POST oder fehlender X-Requested-With Header
Keine Eingabe übermittelt Pflichtfeld (code / text / document etc.) fehlt im JSON-Body
Claude API Fehler (HTTP 401) CLAUDE_API_KEY ungültig oder abgelaufen
Claude API Fehler (HTTP 429) Rate-Limit der Claude API erreicht — kurz warten, dann retry
Claude API Fehler (HTTP 529) Anthropic überlastet — exponentielles Retry empfohlen
Verbindungsfehler (cURL) Server kann api.anthropic.com nicht erreichen — Firewall prüfen

Rate Limits

Plan Token-Limit Requests/Min Dienste
Demo (kein Key) 5 Req/Dienst/Tag 1/Min 6 Core-Dienste
Starter 500K/Monat 10/Min 6 Core-Dienste + SQL + CV
Pro 5M/Monat 60/Min Alle 10 Core-Dienste
Enterprise Unbegrenzt Custom Alle Dienste inkl. Enterprise

Universelles Response-Format

Alle Endpoints folgen demselben Grundschema:

{
  "result": "string", // Haupt-Ergebnis (Text oder SQL oder ...)
  "parsed": {...}, // Strukturierte Daten (dienstspezifisch, nur wenn JSON-Output)
  "tokens_in": integer, // Verbrauchte Input-Tokens
  "tokens_out": integer, // Verbrauchte Output-Tokens
  "duration_ms": integer, // Antwortzeit in Millisekunden
  "error": "string|null" // Fehlertext, sonst nicht vorhanden
}

🔌 WordPress Plugin Generator PORTAL-EXKLUSIV · PRO+

Der WordPress Plugin Generator ist kein öffentlicher API-Endpoint — er ist ausschließlich im Kundenportal verfügbar und nutzt eine Session-basierte Authentifizierung. Pro Nutzer und Tag sind 10 Generierungen möglich.

Interner Endpoint (nur Portal-Session): POST /api/wordpress.php

// Request (nur mit aktiver Portal-Session, kein X-API-Key)
{
  "plugin_name": "My Awesome Plugin",
  "description": "Beschreibung was das Plugin tun soll",
  "plugin_type": "general", // general|woocommerce|gutenberg|widget|shortcode|rest-api
  "features": ["AJAX-Formulare", "Custom Post Type", "E-Mail-Benachrichtigung"],
  "has_admin": true, // Admin-Backend (Settings API)
  "has_css": true, // CSS-Styling für Frontend + Admin
  "has_editor": false // Gutenberg-Block oder Shortcode-Interface
}
// Response
{
  "parsed": {
    "plugin_name": "My Awesome Plugin",
    "slug": "my-awesome-plugin",
    "version": "1.0.0",
    "files": {
      "main.php": "<?php /* vollständiger Plugin-Code */",
      "includes/class-main.php": "<?php /* Hauptklasse */",
      "admin/settings.php": "<?php /* Admin-Backend */",
      "assets/css/style.css": "/* Frontend-CSS */",
      "assets/js/script.js": "/* JavaScript */",
      "readme.txt": "=== Plugin Name ==="
    },
    "shortcodes": ["[my-plugin]"],
    "requirements": { "wp_version": "5.0+", "php_version": "7.4+" },
    "install_instructions": "1. ZIP herunterladen 2. WP Admin → Plugins → hochladen..."
  },
  "daily_used": 3, // Heute bereits generiert (max. 10)
  "tokens_in": 680, "tokens_out": 4200, "duration_ms": 18400
}

// ZIP-DOWNLOAD

Nach der Generierung kann das Plugin als vollständige WordPress-kompatible .zip-Datei heruntergeladen werden — direkt installierbar via WP Admin → Plugins → Plugin hochladen. Die ZIP enthält die korrekte Ordnerstruktur: plugin-slug/main.php, alle Unterordner und Security-index.php-Dateien.

→ Vollständige Funktionsbeschreibung & Portal-Zugang

Changelog

v4.2.0 2026-05-04
+ SQL-Generator (4 Modi: generate, explain, optimize, fix)
+ CV/Bewerbungs-Optimierer (optimize, coverletter, ats, gap)
+ DSGVO-Checker (Compliance-Score, Risikoklassen, Artikel-Referenzen)
+ Meeting-Protokoll-Generator (Markdown-Output, Download)
+ E-Mail-Triage (Priorität, Kategorie, Auto-Antwort)
+ SEO-Content-Analyse (Score, Meta-Generator, Keyword-Empfehlungen)
+ Enterprise-Dokumentation: Vertrags-Analyse, Code-Migration, Feedback-Analyse, RAG-Pipeline
+ Footer System-Status auf alle 13 Dienste erweitert
+ Dokumentation vollständig mit allen Endpoints
v4.0.0 2025-05-26
+ Launch ai.noclone.de
+ 6 Core-Dienste: Code-Analyse, Neuro-Text, Quantum-Chat, Doc-Scanner, Übersetzung, API-Synthesizer
+ PHP & Java SDK
+ Rate-Limiting (Demo: 5/Tag/Dienst)
+ .env-Loader (PHP 7.4+ kompatibel)