🎉 Taybet ji bo endamên nû %50 erzanî! Di selikê de YENI50 koda xwe bi kar bînin. Niha bi belaş bibin endam →
SSiberMakale

Belgeyên API

SiberMakale girêbidin bi serîlêdana xwe, malpera xwe an otomasyonên xwe (Zapier, Make, n8n): gotaran çêbikin, rewşa wan bişopînin, naverokê bi awayê HTML / Markdown bistînin.

🚀 Destpêka bilez

  1. Hesabê belaş vekin an têkevin, paşê ji vê rûpelê mifteyeke API çêbikin.
  2. POST ?r=articles û mijar û peyvên sereke bişînin.
  3. GET ?r=jobs&id=… û bipirsin heta rewş bibe "done".
  4. GET ?r=article&id=… bi temamî gotarê bistînin.

Navnîşana bingehîn: https://sibermakale.info/api/v1.php · Hemû bersiv JSON (UTF-8) ne · Ji bo her gotarê 1 mafê gotarê tê bikaranîn.

🔑 Mifteyên we yên API

Ji bo afirandina kilîta API-yê têkevinê.

Têkeve Qeydkirina belaş

Kilîta xwe bi kesî re parve nekin û di koda giştî ya gerokê de cih nekin; li aliyê serverê biparêzin. Kilît tenê wekî xulase tê hilanîn, em jî nikarin bibînin.

🛡 Piştrastkirina nasnameyê

Di her daxwazê de mifteya xwe Authorization di sernavê de bişînin:

Authorization: Bearer sm_ANAHTARINIZ

Alternatîf: X-API-Key: sm_ANAHTARINIZ

📡 Xalên dawî

GET?r=me

Agahiyên hesab û balansê (mafê gotarê, krediya amûran, bidawîbûna pakêta bêsînor).

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

Lîsteya ziman, ton, dirêjahî, cureya naverok, wêne û nirxên tekezî yên ku hûn dikarin bikar bînin.

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

Karê gotarê dide destpêkirin. Her gotar 1 mafê gotarê bikar tîne; mafê gotarên ku xeletî didin bixweber tê vegerandin. Ji bo parametreyên bedenê li jêr binêrin.

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

Rewşa kar. Her pirs karekî gavekê pêş dixe; heya status "done" bibe, her 10–20 çirkeyan carekê bipirsin (an jî webhook_url bikar bînin).

Bersiva mînak
{"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

Gotarên we yên dawî yên temamkirî (herî zêde 100).

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

Gotara bi temamî. format: html (pêşwext), markdown an text.

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

🧩 Parametreyên gotarê (POST ?r=articles)

Laşê JSON (Content-Type: application/json) an jî wek form dikare were şandin.

QadCureMecbûrîDanasîn
topictextErê*Mijara gotarê / ramana sernavê (kêmtirîn 3 tîp).
topicsrêzik / rêzNaNivîsandina komî: her hêman gotarek cuda ye (herî zêde 10). Heke were dayîn li şûna topic tê bikaranîn.
keywordsarray / texta bi vîrgulErêPeyvên sereke (1–10).
languagetextNaKoda ziman, mînak tr, en, de. Pêşwext tr.
lengthhejmarNaHejmara peyvan a armanc (options → length). Standard 1000.
tonetextNaTonê nivîsê (options → tone). Pêşwext profesyonel.
content_typetextNaCureyê naverokê: blog, rêber, lîste, berawird… (options → content_type).
seoboolNaOptîmîzasyona SEO. Di API-yê de pêşwext vekirî ye.
highlightrêzefîlmNaŞablonên tekezkirinê (options → highlight).
faq / toc / takeaways / aeo / citationsboolNaPirsên pirtûk, naverok, yên pêşîn, guncanbûna ji bo lêgerînên AI-yê, çavkanî.
image_strategytextNanone (pêşwext), ai an web (options → image_strategy).
images_per_articlehejmarNa1–5 wêne.
use_brandboolNaBi agahiyên Profîla Markeya xwe binivîse.
link_urltextNaMalpera we ya ku di gotarê de girêdan jê re tê dayîn.
webhook_urlnavnîşana httpsNaDema kar qediya, encam bi awayê JSON ji vê navnîşanê re tê POST kirin.

* Yek ji topic an topics pêwîst e.

🔄 Herikîna asayî

POST articles→job.status: di plansaziyê de→running→done ✓→GET article

Gotarek li gorî mîhengan bi gelemperî di 1–4 deqîqeyan de amade dibe. Rewşa kar: planning, running, done, failed. Rewşa gotarê: pending, running, done, failed.

🪝 Webhook

Li şûna pirsînê webhook_url ger hûn bidin, dema kar qediya bi vê laşê ji navnîşana we re POST tê kirin:

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

Piştrastkirin: X-SiberMakale-Signature sernav, ya laşê HMAC-SHA256 îmze ye; wekî mifte, kurteya SHA-256 ya mifteya API-yê ku kar dest pê kir tê bikar anîn: hash_hmac('sha256', $govde, hash('sha256', $apiAnahtari)). Kar, tewra hûn nepirsin jî di paşxanê de berdewam dike û dema qediya webhook tê şandin (tenê navnîşanên https).

💻 Mînakên kodê

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

⚠ Kodên çewtiyê

{"ok":false,"error":{"type":"invalid_request","message":"En az bir anahtar kelime girin."}}
HTTPtypeWateya wê
401unauthorizedMifte kêm e an nederbasdar e.
402insufficient_creditsMafê gotaran têrê nake.
404not_foundKar / gotar nehat dîtin an xala dawî tune.
422invalid_requestParametreya kêm an çewt (hûrgilî di peyamê de ye).
429rate_limitedSînorê 60 daxwazên di deqîqeyê de derbas bû (binêrin sernivîsa Retry-After).
500server_errorÇewtiyeke neçaverêkirî; dîsa biceribîne.

📏 Sînor û bihayan

  • 60 daxwaz di deqîqeyê de (ji bo her mifteyê).
  • Di daxwazekê de herî zêde 10 gotar; her gotar 1 mafê gotarê ye. Di pakêtên bêsînor de sînorê bikaranîna adilane ya rojane derbasdar e.
  • API bi xwe belaş e; tenê gotarên ku hûn çêdikin ji mafê we tê kêmkirin. Ji bo pakêtan Pakêt rûpelê binêrin.