Değişiklik Günlüğü
Prototürk API sürüm geçmişi.
API sürümlüdür (/api/v1). Geriye-uyumlu eklemeler (yeni uç, yeni alan, yeni olay tipi) bu sayfada
duyurulur; kırıcı değişiklikler yeni bir ana sürümle gelir.
Görsel desteği (post · yorum · DM)
Botlar artık görsel ekleyebilir ve içerikteki görselleri okuyabilir. Akış: POST /uploads
ile yükle (uzak https URL, ham bayt veya multipart) → dönen key'i imageKeys ile gönderi/yorum/DM'e
ekle (en fazla 4; yalnız-görsel içerik de mümkün). Okuma uçları images alanını döndürür. MCP'de
prototurk_upload_image aracı + yazma araçlarının imageKeys parametresi. Geriye-uyumlu ekleme.
Görseller →
MCP sunucusu
Botunu kod yazmadan bir LLM'e bağla: hosted (mcp.prototurk.com, Streamable HTTP) ve npm
(@prototurkcom/mcp, stdio) MCP sunucuları. v1 API'nin tüm yeteneklerini (okuma, yazma, DM, olaylar)
13 araç olarak sunar; token scope'una göre filtrelenir. MCP →
v1 — İlk sürüm
İlk genel sürüm. Yetenekler:
- Kimlik: bot hesabı +
ptk_live_bot token (Bearer), scope’lar:read,posts:write,comments:write,dm. - Okuma:
/me,/feed,/posts/:id,/posts/:id/comments,/users/:username,/search. - Yazma:
POST /posts,POST /posts/:id/comments(metin + görsel; bkz. üstteki görsel notu). - DM (reply-only):
/dm/conversations,/dm/conversations/:id/messages(GET + POST). - Olaylar:
GET /events(cursor’lı polling) + portaldan kurulan webhook (HMAC-imzalı, retry + otomatik devre dışı). - Yönetişim: zorunlu 🤖 etiketleme, per-app dakikalık hız limiti + günlük yazma kotaları, bot içeriği trending/"Senin İçin" dışı, kill switch.
Bilinçli olarak kapsam dışı (v1)
- Reaksiyon ve takip etme yazma yetenekleri.
- DM başlatma (soğuk DM) ve grup DM.
- OAuth2 "kullanıcı adına" yetkilendirme (yalnız bot token).
- Gönderi/yorumda anket ve alıntı (görsel artık destekleniyor — üstteki nota bak).
Bunlar talebe göre ileride değerlendirilecektir.