🎉 Yeni üyelere özel %50 indirim! Sepette YENI50 kodunu kullanın. Hemen ücretsiz üye ol →
SSiberMakale

API Dokümantasyonu

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.

🚀 Hızlı başlangıç

  1. Ücretsiz hesap açın veya giriş yapın, sonra bu sayfadan API anahtarı oluşturun.
  2. POST ?r=articles ile konu ve anahtar kelimeleri gönderin.
  3. GET ?r=jobs&id=… ile durumu "done" olana kadar sorgulayın.
  4. GET ?r=article&id=… ile makalenin tamamını alın.

Temel adres: https://sibermakale.info/api/v1.php · Tüm yanıtlar JSON (UTF-8) · Makale başına 1 makale hakkı kullanılır.

🔑 API anahtarlarınız

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

Giriş yap Ü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.

🛡 Kimlik doğrulama

Her istekte anahtarınızı Authorization başlığında gönderin:

Authorization: Bearer sm_ANAHTARINIZ

Alternatif: X-API-Key: sm_ANAHTARINIZ

📡 Uç noktalar

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

Son tamamlanan makaleleriniz (en fazla 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>"}}

🧩 Makale parametreleri (POST ?r=articles)

Gövde JSON (Content-Type: application/json) veya form olarak gönderilebilir.

AlanTürZorunluAçıklama
topicmetinEvet*Makale konusu / başlık fikri (en az 3 karakter).
topicsdizi / satırlarHayırToplu yazım: her eleman ayrı makale (en fazla 10). Verilirse topic yerine kullanılır.
keywordsdizi / virgüllü metinEvetAnahtar kelimeler (1–10).
languagemetinHayırDil kodu, ör. tr, en, de. Varsayılan tr.
lengthsayıHayırHedef kelime sayısı (options → length). Varsayılan 1000.
tonemetinHayırYazım tonu (options → tone). Varsayılan profesyonel.
content_typemetinHayırİçerik türü: blog, rehber, liste, karşılaştırma… (options → content_type).
seoboolHayırSEO optimizasyonu. API'de varsayılan açık.
highlightdiziHayırVurgu şablonları (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 görsel.
use_brandboolHayırMarka Profilinizdeki bilgilerle yaz.
link_urlmetinHayırMakalede link verilecek web siteniz.
webhook_urlhttps adresiHayırİş bitince sonuç bu adrese JSON olarak POST edilir.

* topic veya topics'ten biri gereklidir.

🔄 Tipik akış

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. Makale durumu: pending, running, done, failed.

🪝 Webhook

Sorgulamak yerine webhook_url verirseniz iş bittiğinde şu gövde adresinize POST edilir:

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

Doğrulama: X-SiberMakale-Signature başlığı, gövdenin 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).

💻 Kod örnekleri

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}'

⚠ Hata kodları

{"ok":false,"error":{"type":"invalid_request","message":"En az bir anahtar kelime girin."}}
HTTPtypeAnlamı
401unauthorizedAnahtar eksik veya geçersiz.
402insufficient_creditsYetersiz makale hakkı.
404not_foundİş / makale bulunamadı veya uç nokta yok.
422invalid_requestEksik veya hatalı parametre (mesajda ayrıntı yazar).
429rate_limitedDakikada 60 istek sınırı aşıldı (Retry-After başlığına bakın).
500server_errorBeklenmeyen hata; tekrar deneyin.

📏 Limitler ve ücretlendirme

  • Dakikada 60 istek (anahtar başına).
  • 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 Paketler sayfasına bakın.