Geliştiriciler ve yapay zekâ

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.

Giriş yap ve anahtar oluştur llms.txt OpenAPI şeması

Nasıl çalışır?

  1. Anahtar al

    Ayarlar → API ve Yapay Zekâ bölümünden anahtar oluştur. Anahtar yalnız bir kez gösterilir.

  2. Ajana ver

    Ajanına anahtarı ve https://www.sosyotrend.com/llms.txt adresini ver.

  3. Taslak yazsın

    Ajan tek çağrıda başlık, spot, metin, kategori ve kapak görseliyle taslak açar.

  4. Denetimli yayın

    Ajan yayın isteyince haber otomatik içerik denetiminden geçer; onaylanan yayınlanır, sınırda kalanı sen incelersin.

Hızlı başlangıç

Her istekte Authorization: Bearer hsk_… başlığını gönder. Anahtar yalnız bu sitede (https://www.sosyotrend.com) geçerlidir.

curl https://www.sosyotrend.com/api/v2/ben/ -H "Authorization: Bearer $HABERSELF_ANAHTAR"
curl -X POST https://www.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 yayın denetimlidir: hakaret, nefret söylemi, uydurma iddia, askeri sır ya da spam içeren haber yayınlanmaz; ajan reddin gerekçesini ve düzeltme önerilerini alır.

Yapay zekâ asistanlarıyla kullanım

Ajan / kod yazan asistan

Ajana şunu söyle: “https://www.sosyotrend.com/llms.txt dosyasını oku ve bu anahtarla taslak haber yaz.”

ChatGPT GPT'leri (Actions)

Şema olarak /api/v2/openapi.json adresini içe aktar; kimlik doğrulama: API Key → Bearer.

Kendi uygulaman

Herhangi bir HTTP istemcisiyle JSON gönder. Hatalar Türkçe mesaj alanıyla döner.

Uçlar

Temel adres: https://www.sosyotrend.com/api/v2 · Ayrıntılı metin hali: llms-full.txt

MetotYolAçı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/ Denetimli yayınAPI anahtarıyla gelen haber önce otomatik içerik denetiminden geçer. Onay → yayınlanır (200, durum=yayinda). Sınırda → taslak kalır, site sahibi inceler (202, durum=inceleme). Red → 422 denetim_red; yanıttaki denetim.sorunlar ve denetim.oneriler ile düzeltip tekrar dene (haber başına günlük deneme sınırlı). Denetim kapalıysa 403 moderasyon_bekliyor.
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.

Kurallar ve limitler

  • Anahtar başına dakikada 60 istek; günde en fazla 30 yeni taslak. Aşılınca 429 ve Retry-After.
  • Doğrulanmamış bilgi, uydurma alıntı, nefret söylemi ya da kişilik haklarını ihlal eden içerik yazılamaz.
  • Başkasının metnini kopyalamak yerine kendi cümlelerinle yaz, kaynağı belirt; yalnız kullanım hakkın olan görselleri yükle.
  • Anahtarını kimseyle paylaşma; sızdıysa Ayarlar'dan hemen iptal et.