🎉 Только для новых участников Скидка 50%! В корзине YENI50 используйте код. Зарегистрируйтесь бесплатно →
SSiber Makale

Документация API

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.

🚀 Быстрый старт

  1. Создать бесплатный аккаунт или войдите, затем создайте API-ключ на этой странице.
  2. POST ?r=articles и отправьте тему и ключевые слова.
  3. GET ?r=jobs&id=… и опрашивайте, пока статус не станет «done».
  4. GET ?r=article&id=… ile makalenin tamamını alın.

Базовый адрес: https://sibermakale.com/api/v1.php · Все ответы в JSON (UTF-8) · Makale başına 1 makale hakkı kullanılır.

🔑 Ваши API-ключи

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

Войти Ü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.

🛡 Аутентификация

Передавайте ключ в каждом запросе Authorization başlığında gönderin:

Authorization: Bearer sm_ANAHTARINIZ

Alternatif: X-API-Key: sm_ANAHTARINIZ

📡 Эндпоинты

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

Последние готовые статьи (до 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>"}}

🧩 Параметры статьи (POST ?r=articles)

Тело JSON (Content-Type: application/json) или отправлены как форма.

AlanТипZorunluОписание
topicmetinEvet*Makale konusu / başlık fikri (en az 3 karakter).
topicsмассив / строкиHayırToplu yazım: her eleman ayrı makale (en fazla 10). Verilirse topic yerine kullanılır.
keywordsdizi / virgüllü metinEvetКлючевые слова (1–10).
languagemetinHayırDil kodu, ör. tr, en, de. Varsayılan tr.
lengthsayıHayırЦелевой объём (options → length). По умолчанию 1000.
tonemetinHayırYazım tonu (options → tone). Varsayılan profesyonel.
content_typemetinHayırТип контента: блог, руководство, список, сравнение… (options → content_type).
seoboolHayırSEO optimizasyonu. API'de varsayılan açık.
highlightсериалHayırШаблоны выделения (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 изображений.
use_brandboolHayırПисать по данным профиля бренда.
link_urlmetinHayırВаш сайт для ссылок в статье.
webhook_urlадрес httpsHayırİş bitince sonuç bu adrese JSON olarak POST edilir.

* Требуется topic или topics.

🔄 Типичный сценарий

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. Статус статьи: pending, running, done, failed.

🪝 Webhook

Вместо опроса webhook_url verirseniz iş bittiğinde şu gövde adresinize POST :

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

Проверка: X-SiberMakale-Signature заголовок, текста 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).

💻 Примеры кода

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

⚠ Коды ошибок

{"ok":false,"error":{"type":"invalid_request","message":"En az bir anahtar kelime girin."}}
HTTPtypeAnlamı
401unauthorizedAnahtar eksik veya geçersiz.
402insufficient_creditsНедостаточно статей.
404not_foundЗадание / статья не найдены или нет эндпоинта.
422invalid_requestОтсутствует или неверный параметр (подробности в сообщении).
429rate_limitedDakikada 60 istek sınırı aşıldı (Retry-After başlığına bakın).
500server_errorBeklenmeyen hata; tekrar deneyin.

📏 Лимиты и тарификация

  • 60 запросов в минуту (на ключ).
  • 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 Тарифы страницу.