🎉 Für neue Mitglieder %50 Rabatt! Warenkorb YENI50 Nutze deinen Code! Jetzt kostenlos registrieren →
SSiberMakale

API-Dokumentation

Verbinden Sie SiberMakale mit Ihrer eigenen Anwendung, Website oder Automatisierungen (Zapier, Make, n8n): Generieren Sie Artikel, verfolgen Sie deren Status und rufen Sie den Inhalt als HTML / Markdown ab.

🚀 Schnellstart

  1. Kostenloses Konto erstellen oder melden Sie sich an, dann erstellen Sie auf dieser Seite einen API-Schlüssel.
  2. POST ?r=articles und Thema sowie Keywords senden.
  3. GET ?r=jobs&id=… und abfragen, bis der Status „done“ ist.
  4. GET ?r=article&id=… und erhalten Sie den vollständigen Artikel.

Basis-URL: https://sibermakale.info/api/v1.php · Alle Antworten als JSON (UTF-8) · Pro Artikel wird 1 Artikel-Guthaben verwendet.

🔑 Ihre API-Schlüssel

Melden Sie sich an, um einen API-Schlüssel zu erstellen.

Anmelden Kostenlose Registrierung

Geben Sie Ihren Schlüssel nicht an Dritte weiter und platzieren Sie ihn nicht in öffentlich zugänglichem Client-Code; speichern Sie ihn serverseitig. Der Schlüssel wird nur als Hash gespeichert und ist auch für uns unsichtbar.

🛡 Authentifizierung

Senden Sie Ihren Schlüssel bei jeder Anfrage Authorization im Header senden:

Authorization: Bearer sm_ANAHTARINIZ

Alternative: X-API-Key: sm_ANAHTARINIZ

📡 Endpunkte

GET?r=me

Kontoinformationen und Guthaben (Artikel-Guthaben, Werkzeug-Credits, Ablaufdatum des Flatrate-Pakets).

Beispielantwort
{"ok":true,"user":{"id":12,"name":"Ayşe","email":"ayse@ornek.com","article_credits":18,"tool_credits":5,"unlimited_until":null}}
GET?r=options

Liste der verfügbaren Sprachen, Töne, Längen, Inhaltsformate, Bilder und Hervorhebungswerte.

Beispielantwort
{"ok":true,"options":{"language":["tr","en","de",…],"tone":["profesyonel",…],"length":[500,1000,1500,…],…}}
POST?r=articles

Startet einen Artikelauftrag. Jeder Artikel verbraucht 1 Artikel-Guthaben; Guthaben für fehlgeschlagene Artikel wird automatisch erstattet. Für Body-Parameter siehe unten.

Beispielantwort
{"ok":true,"job":{"id":345,"status":"planning","total":1,"done":0,"articles":[{"id":901,"status":"pending","title":""}]}}
GET?r=jobs&id=345

Auftragsstatus. Jede Abfrage bringt den Auftrag einen Schritt voran; fragen Sie alle 10–20 Sekunden ab, bis der Status "done" lautet (oder verwenden Sie webhook_url).

Beispielantwort
{"ok":true,"job":{"id":345,"status":"done","total":1,"done":1,"articles":[{"id":901,"status":"done","title":"Kahve Makinesi Nasıl Seçilir?","word_count":1540,"originality":96.4}]}}
GET?r=articles&limit=20

Ihre zuletzt fertigen Artikel (max. 100).

Beispielantwort
{"ok":true,"articles":[{"id":901,"job_id":345,"title":"…","slug":"kahve-makinesi-nasil-secilir","word_count":1540}]}
GET?r=article&id=901&format=html

Der vollständige Artikel. Format: html (Standard), markdown oder text.

Beispielantwort
{"ok":true,"article":{"id":901,"title":"…","seo_title":"…","meta_description":"…","slug":"…","format":"html","content":"<h2>…</h2><p>…</p>"}}

🧩 Artikelparameter (POST ?r=articles)

JSON-Body (Content-Type: application/json) oder als Formular gesendet werden.

FeldTypErforderlichBeschreibung
topicTextJa*Thema / Titelidee für den Artikel (mindestens 3 Zeichen).
topicsArray / ZeilenNeinMassenproduktion: Jedes Element ist ein separater Artikel (maximal 10). Ersetzt das Thema, falls angegeben.
keywordsArray / kommagetrennter TextJaKeywords (1–10).
languageTextNeinSprachcode, z. B. tr, en, de. Standard ist tr.
lengthZahlNeinZiel-Wortanzahl (options → length). Standard 1000.
toneTextNeinSchreibstil (Optionen → tone). Standard ist professionell.
content_typeTextNeinInhaltstyp: Blog, Leitfaden, Liste, Vergleich… (options → content_type).
seoboolNeinSEO-Optimierung. In der API standardmäßig aktiv.
highlightSerieNeinHervorhebungsvorlagen (options → highlight).
faq / toc / takeaways / aeo / citationsboolNeinFAQ, Inhaltsverzeichnis, Highlights, Optimierung für KI-Suchen, Quellenangabe.
image_strategyTextNeinnone (Standard), ai oder web (Optionen → image_strategy).
images_per_articleZahlNein1–5 Bilder.
use_brandboolNeinMit Ihrem Markenprofil schreiben.
link_urlTextNeinIhre Website, auf die im Artikel verlinkt wird.
webhook_urlhttps-AdresseNeinWenn der Auftrag abgeschlossen ist, wird das Ergebnis als JSON an diese Adresse gesendet (POST).

* topic oder topics ist erforderlich.

🔄 Typischer Ablauf

POST articles→job.status: planning→running→done ✓→GET article

Ein Artikel ist je nach Einstellung meist in 1–4 Minuten fertig. Auftragsstatus: planning, running, done, failed. Artikelstatus: pending, running, done, failed.

🪝 Webhook

Statt abzufragen webhook_url wenn angegeben, wird beim Abschluss des Auftrags folgender Body an Ihre Adresse gesendet POST :

{"event":"job.done","job":{"id":345,"status":"done","total":1,"done":1,"articles":[…]}}

Verifizierung: X-SiberMakale-Signature den Titel, des Inhalts HMAC-SHA256 imzasıdır; anahtar olarak işi başlatan API anahtarının SHA-256 özeti kullanılır: hash_hmac('sha256', $govde, hash('sha256', $apiAnahtari)). Die Verarbeitung läuft im Hintergrund ab, auch wenn Sie keine Abfrage senden, und bei Fertigstellung wird ein Webhook gesendet (nur https-Adressen).

💻 Codebeispiele

curl -X POST "https://sibermakale.info/api/v1.php?r=articles" \
  -H "Authorization: Bearer sm_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"topic":"Kahve makinesi nasıl seçilir","keywords":["kahve makinesi","espresso"],"language":"tr","length":1500,"faq":true}'

⚠ Fehlercodes

{"ok":false,"error":{"type":"invalid_request","message":"En az bir anahtar kelime girin."}}
HTTPtypeBedeutung
401unauthorizedSchlüssel fehlt oder ist ungültig.
402insufficient_creditsNicht genügend Artikel-Credits.
404not_foundAuftrag / Artikel nicht gefunden oder Endpunkt fehlt.
422invalid_requestFehlender oder ungültiger Parameter (Details in der Meldung).
429rate_limitedLimit von 60 Anfragen pro Minute überschritten (siehe Retry-After-Header).
500server_errorUnerwarteter Fehler; versuchen Sie es erneut.

📏 Limits & Preise

  • 60 Anfragen pro Minute (pro Schlüssel).
  • Maximal 10 Artikel pro Anfrage; jeder Artikel kostet 1 Artikelguthaben. Bei unbegrenzten Tarifen gilt ein tägliches Fair-Use-Limit.
  • Die API selbst ist kostenlos; es werden lediglich Artikel von Ihrem Guthaben abgezogen. Für Tarife Pläne Seite.