🎉 Exklusiv für neue Mitglieder 50 % Rabatt! Im Warenkorb YENI50 ein. Jetzt kostenlos registrieren →
SSiber Makale

API-Dokumentation

SiberMakale'yi kendi uygulamanıza, sitenize veya otomasyonlarınıza (Zapier, Make, n8n) bağlayın: makale üretin, durumunu takip edin, içeriği HTML / Markdown olarak alın.

🚀 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=… ile makalenin tamamını alın.

Basis-URL: https://sibermakale.com/api/v1.php · Alle Antworten als JSON (UTF-8) · Makale başına 1 makale hakkı kullanılır.

🔑 Ihre API-Schlüssel

API anahtarı oluşturmak için giriş yapın.

Anmelden Ücretsiz kayıt

Anahtarınızı kimseyle paylaşmayın ve tarayıcıda çalışan herkese açık koda koymayın; sunucu tarafında saklayın. Anahtar yalnızca özet olarak saklanır, biz de göremeyiz.

🛡 Authentifizierung

Senden Sie Ihren Schlüssel bei jeder Anfrage Authorization başlığında gönderin:

Authorization: Bearer sm_ANAHTARINIZ

Alternatif: X-API-Key: sm_ANAHTARINIZ

📡 Endpunkte

GET?r=me

Hesap bilgisi ve bakiyeler (makale hakkı, araç kredisi, sınırsız paket bitişi).

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

Kullanabileceğiniz dil, ton, uzunluk, içerik türü, görsel ve vurgu değerlerinin listesi.

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

Makale işi başlatır. Her makale 1 makale hakkı kullanır; hata alan makalenin hakkı otomatik iade edilir. Gövde parametreleri için aşağıya bakın.

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

İşin durumu. Her sorgu işi bir adım ilerletir; status "done" olana kadar 10–20 saniyede bir sorgulayın (ya da webhook_url kullanın).

Örnek yanıt
{"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).

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

Makalenin tamamı. format: html (varsayılan), markdown veya text.

Örnek yanıt
{"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.

AlanTypZorunluBeschreibung
topicmetinEvet*Makale konusu / başlık fikri (en az 3 karakter).
topicsArray / ZeilenHayırToplu yazım: her eleman ayrı makale (en fazla 10). Verilirse topic yerine kullanılır.
keywordsdizi / virgüllü metinEvetKeywords (1–10).
languagemetinHayırDil kodu, ör. tr, en, de. Varsayılan tr.
lengthsayıHayırZiel-Wortanzahl (options → length). Standard 1000.
tonemetinHayırYazım tonu (options → tone). Varsayılan profesyonel.
content_typemetinHayırInhaltstyp: Blog, Leitfaden, Liste, Vergleich… (options → content_type).
seoboolHayırSEO optimizasyonu. API'de varsayılan açık.
highlightSerieHayırHervorhebungsvorlagen (options → highlight).
faq / toc / takeaways / aeo / citationsboolHayırS.S.S., içindekiler, öne çıkanlar, yapay zeka aramalarına uygunluk, kaynakça.
image_strategymetinHayırnone (varsayılan), ai veya web (options → image_strategy).
images_per_articlesayıHayır1–5 Bilder.
use_brandboolHayırMit Ihrem Markenprofil schreiben.
link_urlmetinHayırIhre Website, auf die im Artikel verlinkt wird.
webhook_urlhttps-AdresseHayırİş bitince sonuç bu adrese JSON olarak POST edilir.

* topic oder topics ist erforderlich.

🔄 Typischer Ablauf

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

Bir makale ayarlara göre genellikle 1–4 dakikada hazır olur. İş durumu: planning, running, done, failed. Artikelstatus: pending, running, done, failed.

🪝 Webhook

Statt abzufragen webhook_url verirseniz iş bittiğinde şu gövde adresinize 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)). İş siz sorgulamasanız da arka planda ilerler ve bitince webhook gönderilir (yalnızca https adresleri).

💻 Codebeispiele

curl -X POST "https://sibermakale.com/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."}}
HTTPtypeAnlamı
401unauthorizedAnahtar eksik veya geçersiz.
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_limitedDakikada 60 istek sınırı aşıldı (Retry-After başlığına bakın).
500server_errorBeklenmeyen hata; tekrar deneyin.

📏 Limits & Preise

  • 60 Anfragen pro Minute (pro Schlüssel).
  • Tek istekte en fazla 10 makale; her makale 1 makale hakkı. Sınırsız paketlerde günlük adil kullanım sınırı geçerlidir.
  • API'nin kendisi ücretsizdir; yalnızca ürettiğiniz makaleler hakkınızdan düşer. Paketler için Pakete Seite.