# Sosyotrend

> Sosyotrend, haberself platformunda yayın yapan Türkçe bir haber sitesidir. Bu sitenin üyeleri ve yetkilendirdikleri yapay zekâ ajanları API ile taslak haber yazabilir.

Bu dosya yapay zekâ ajanları içindir. Haber yazmak için bu sitenin API'sini kullan; sayfaları kazıyarak (scraping) form doldurma.

## Hızlı başlangıç

1. Bir insan bu sitede üye olur ve Ayarlar → API ve Yapay Zekâ bölümünden bir anahtar oluşturur (https://sosyotrend.com/index.php?c=ayarlar&sayfa=api). Anahtar `hsk_` ile başlar ve yalnız bir kez gösterilir.
2. Her istekte başlık gönder: `Authorization: Bearer hsk_...`
3. Anahtar yalnız bu sitede geçerlidir; temel adres: `https://sosyotrend.com/api/v2`
4. Bağlantıyı test et: `GET https://sosyotrend.com/api/v2/ben/`
5. Kategorileri al: `GET https://sosyotrend.com/api/v2/kategoriler/`
6. Tek çağrıda taslak oluştur: `POST https://sosyotrend.com/api/v2/haberler/` (JSON: baslik, spot, metin, kategoriler, kapak_url)
7. Dönen `haber.id` ile düzelt (`PATCH /haberler/{id}/`), eksikleri kontrol et (`GET /haberler/{id}/kontrol/`).

## Önemli kurallar

- API'den gelen haberler TASLAK olarak kalır; yayına alma şimdilik site panelinden insan onayıyla yapılır (`POST /yayinla` anahtarla 403 `moderasyon_bekliyor` döner).
- Yalnız doğrulanmış, kaynağı belli bilgi yaz. Uydurma alıntı, sahte kaynak, nefret söylemi, kişilik haklarını ihlal eden ya da yanıltıcı içerik yazma.
- Başkasının metnini olduğu gibi kopyalama; kendi cümlelerinle yaz ve kaynağı metinde belirt.
- Görsel olarak yalnız kullanım hakkı olan görselleri kullan.
- Hız limiti: anahtar başına dakikada 60 istek, günde 30 yeni taslak. Aşınca 429 + `Retry-After`.

## İçerik biçimi

- `metin` (makale düzeni): izinli HTML etiketleri `p, h2, h3, b, i, ul, li, a, br` ve YouTube `iframe`. Diğer etiketler ve tüm öznitelikler (href/src hariç) temizlenir. Düz metin de olur: boş satır = yeni paragraf.
- Metin içine görsel: önce `POST /haberler/{id}/gorseller/` ile `yer=govde` ve `bolum_id` göndererek yükle, dönen `gorsel.id`yi metne `(img:#ID)` olarak yaz.
- Liste haberleri ("10 maddede…"): `listeturu=numarali` ve `bolumler: [{baslik, metin}]`.
- Başlık 10–110 karakter, spot 1–2 cümle (en fazla 400 karakter önerilir).

## Yanıt biçimi

Başarı: `{"ok":true, ...}`. Hata: `{"ok":false, "hata":"kod", "mesaj":"Türkçe açıklama"}` ve uygun HTTP durum kodu (401 anahtar, 403 yetki, 404 yok, 422 geçersiz alan, 429 limit).

## Belgeler

- [OpenAPI şeması](https://sosyotrend.com/api/v2/openapi.json): tüm uçlar, makine tarafından okunur
- [Geliştirici sayfası](https://sosyotrend.com/gelistirici/): insanlar için örneklerle anlatım

## Optional

- [Tam API rehberi](https://sosyotrend.com/llms-full.txt): her ucun alanlarıyla birlikte metin hali