Sosyotrend sitesine kendi uygulaman ya da bir yapay zekâ ajanı ile haber taslağı yazabilirsin. API anahtarını oluştur, ajanına llms.txt adresini ver; gerisini o halleder.
Ayarlar → API ve Yapay Zekâ bölümünden anahtar oluştur. Anahtar yalnız bir kez gösterilir.
Ajanına anahtarı ve https://sosyotrend.com/llms.txt adresini ver.
Ajan tek çağrıda başlık, spot, metin, kategori ve kapak görseliyle taslak açar.
Taslak "Haberlerim"de görünür; kontrol edip editörden yayınlarsın.
Her istekte Authorization: Bearer hsk_… başlığını gönder. Anahtar yalnız bu sitede (https://sosyotrend.com) geçerlidir.
curl https://sosyotrend.com/api/v2/ben/ -H "Authorization: Bearer $HABERSELF_ANAHTAR"
curl -X POST https://sosyotrend.com/api/v2/haberler/ \
-H "Authorization: Bearer $HABERSELF_ANAHTAR" \
-H "Content-Type: application/json" \
-d '{
"baslik": "Samsun'da yeni sahil parkı hizmete açıldı",
"spot": "Atakum sahilindeki park yürüyüş yolu ve oyun alanlarıyla açıldı.",
"metin": "<p>Park bugün düzenlenen törenle açıldı.</p><h2>Neler var?</h2><p>…</p>",
"kategoriler": [3],
"kapak_url": "https://ornek.com/park.jpg"
}'
API ile açılan haberler şimdilik taslak olarak kalır; yayınlama, içerik denetimi katmanı devreye girene kadar site panelinden yapılır.
Ajana şunu söyle: “https://sosyotrend.com/llms.txt dosyasını oku ve bu anahtarla taslak haber yaz.”
Şema olarak /api/v2/openapi.json adresini içe aktar; kimlik doğrulama: API Key → Bearer.
Herhangi bir HTTP istemcisiyle JSON gönder. Hatalar Türkçe mesaj alanıyla döner.
Temel adres: https://sosyotrend.com/api/v2 · Ayrıntılı metin hali: llms-full.txt
| Metot | Yol | Açıklama |
|---|---|---|
| GET | /ben/ |
Kimlik doğrulanan üye ve siteAnahtarın hangi üye ve siteye ait olduğunu döner. Bağlantıyı test etmek için ilk çağrı. |
| GET | /kategoriler/ |
Sitenin kategorileriDüz liste: id, adi, ust_id (0 = kök). |
| GET | /haberler/ |
Son haberlerimBu sitedeki taslak ve yayındaki haberlerin (en yeniden). Sorgu: limit (en fazla 100). |
| POST | /haberler/ |
Yeni taslak oluşturTek çağrıda tam taslak: üst alanlar + gövde + kapak görseli. Haber TASLAK olarak oluşur. |
| GET | /haberler/{id}/ |
Haberi getirEditörün gördüğü tüm durum: alanlar, bölümler, görseller, yerleşim. |
| PATCH | /haberler/{id}/ |
Haberi güncelleYalnız gönderilen alanlar yazılır. |
| DELETE | /haberler/{id}/ |
Taslağı silYalnız taslak durumundaki haber silinir. |
| GET | /haberler/{id}/kontrol/ |
Yayın kontrolüengel[] (yayını durdurur) ve uyari[] (eksik ama yayınlanabilir) listeleri. |
| POST | /haberler/{id}/yayinla/ |
YayınlaAPI anahtarıyla şu an KAPALI: API'den gelen haberler moderasyon katmanı açılana kadar taslak kalır ve site panelinden yayınlanır. |
| POST | /haberler/{id}/taslak/ |
Yayından kaldırHaberi taslağa alır; manşet/anasayfa yerleşimleri kapanır. |
| POST | /haberler/{id}/bolumler/ |
Bölüm ekleGövdeye yeni bölüm ekler (makalede ara başlıklı bölüm, listede madde). |
| PATCH | /haberler/{id}/bolumler/{bid}/ |
Bölümü güncelle |
| DELETE | /haberler/{id}/bolumler/{bid}/ |
Bölümü sil |
| POST | /haberler/{id}/bolumler/sira/ |
Bölüm sırasıBölüm kimliklerini istenen sırayla gönder. |
| POST | /haberler/{id}/gorseller/ |
Görsel yüklemultipart/form-data (dosya alanı: dosya) ya da JSON {yer, url}. Makale içine görsel için yer=govde ile yükleyip dönen id ile metne (img:#id) yaz. |
| DELETE | /haberler/{id}/gorseller/{yer}/ |
Görseli kaldıryer=bolum için sona bölüm kimliği ekle: /gorseller/bolum/{bid} |
| POST | /haberler/{id}/yerler/ |
YerleşimAnasayfa/manşet/sürmanşet görünürlüğü; üyenin yetkisi gerekir. Taslakta açılan yer, haber yayınlanınca devreye girer. |
429 ve Retry-After.