// 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:
Content-Type: application/json
X-Requested-With: XMLHttpRequest
PHP SDK
Installation via Composer — unterstützt PHP 7.4 und höher:
// 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)
<groupId>de.ncod3v</groupId>
<artifactId>ai-sdk</artifactId>
<version>4.1.0</version>
</dependency>
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)
-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:
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.
$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
{ "code": "string", "language": "auto|php|java|python|js|sql|go|..." }
{
"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
{
"prompt": "string",
"type": "blog|marketing|email|readme|summary|general",
"tone": "professional|casual|technical|persuasive|formal",
"language": "Deutsch|Englisch|..."
}
{ "result": "generierter Text", "tokens_out": 820, "duration_ms": 2100 }
Quantum-Chat
Endpoint: POST /api/chat.php — Unterstützt Multi-Turn via messages-Array.
{
"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
}
{ "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.
{
"document": "Dokumenten-Text (max. 8000 Zeichen)",
"task": "summary|extract|classify|qa"
}
{ "result": "strukturierte Analyse", "tokens_out": 610, "duration_ms": 2400 }
Übersetzungsmatrix
Endpoint: POST /api/translate.php
{
"text": "Zu übersetzender Text",
"target_lang": "Englisch",
"source_lang": "auto", // oder z.B. "Deutsch"
"domain": "general|technical|legal|medical|marketing"
}
{ "result": "Übersetzung", "tokens_out": 290, "duration_ms": 980 }
SQL-Generator
Endpoint: POST /api/sql.php
{
"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"
}
{
"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
{
"cv": "Lebenslauf-Text",
"job": "Stellenausschreibungs-Text",
"mode": "optimize|coverletter|ats|gap"
}
{ "result": "optimierter CV / Anschreiben / Gap-Analyse", "tokens_out": 1240 }
DSGVO-Checker
Endpoint: POST /api/datenschutz.php
{
"text": "Datenschutzerklärung / AGB / Einwilligung",
"doc_type": "datenschutzerklaerung|agb|einwilligung|auftragsverarbeitung|impressum"
}
{
"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
{
"notes": "Rohnotizen / Stichwörter",
"title": "Sprint Planning Q2", // optional
"date": "2025-05-26", // optional
"participants": ["Max Mustermann", "Anna Schmidt"] // optional
}
{ "result": "## Meeting-Protokoll\n\n**Datum:** ...", "tokens_out": 920 }
E-Mail-Triage
Endpoint: POST /api/email-triage.php
{
"email": "Betreff + E-Mail-Inhalt",
"context": "Ich bin Geschäftsführer eines SaaS-Unternehmens" // optional
}
{
"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
{
"content": "Seiten-Text / Artikel (max. 6000 Zeichen)",
"keyword": "KI-Code-Analyse", // optional
"url": "https://example.de/seite" // optional
}
{
"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.
{
"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"
}
{
"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.
{
"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
}
{
"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.
Risikoklauseln, Nachverhandlungs-Guide, Due-Diligence.
/api/contract.php→ Dokumentation & Spezifikation
Legacy-Code modernisieren: PHP 5→8, jQuery→Vanilla, Monolith→Microservices.
/api/migrate.php→ Dokumentation & Spezifikation
Massenanalyse von Reviews, Tickets, NPS — Pain-Points & Feature-Priorisierung.
/api/feedback.php→ Dokumentation & Spezifikation
Claude auf Ihrer eigenen Wissensbasis. Quellenangabe garantiert.
/api/rag.php→ Dokumentation & Spezifikation
Vollständige WP-Plugins on-demand. Exklusiv im Kundenportal (Pro+).
/portal/→ Dokumentation & Spezifikation
Fehlerbehandlung
Alle Endpoints geben HTTP 200 zurück. Fehler werden über das error-Feld signalisiert:
| 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
{
"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
}
{
"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
+ 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
+ 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)