Olay türlerini seçme

Varsayılan olarak izlediğiniz her hesabın tüm olay türlerini alırsınız. Bunu hesap bazında daraltabilirsiniz: bir hesap size yalnızca yeni doğrulanmış takipçilerini gönderirken bir diğeri paylaştığı her şeyi gönderebilir. Seçim aboneliğe aittir, bu yüzden her hesap için ayrı yapılır.

Neleri seçebilirsiniz

Aşağıdaki her olay türü, her hesap için tek tek açılıp kapatılabilir. Anahtar kelime eşleşmeleri (search.match) bu listede yoktur: bunlar hesaplardan değil, anahtar kelimelerden gelir.

Tür	Kategori	Anlamı
`tweet.create`	Gönderiler	Hesap yeni bir şey paylaştı
`tweet.reply`	Gönderiler	Birine yanıt verdi; `reply_to` yanıtlanan gönderiyi metni ve medyasıyla taşır
`tweet.retweet`	Gönderiler	Birini yeniden gönderdi; `retweet_of` özgün gönderiyi eksiksiz taşır
`tweet.quote`	Gönderiler	Birini alıntıladı; `quoted` alıntılanan gönderiyi eksiksiz taşır
`tweet.edit`	Gönderiler	Bir gönderiyi düzenledi; olay yeni sürümü, `edit_of` ise bu sürümün yerini aldığı sürümü taşır
`tweet.delete`	Gönderiler	Hesabın yayımlamış olduğu bir gönderi kayboldu
`profile.name`	Profil	Görünen ad değişti
`profile.screen_name`	Profil	Kullanıcı adı değişti
`profile.bio`	Profil	Biyografi değişti
`profile.location`	Profil	Konum değişti
`profile.url`	Profil	Profil bağlantısı değişti
`profile.avatar`	Profil	Avatar değişti; `old` ve `new` görsel URL'leridir
`profile.banner`	Profil	Banner değişti; `old` ve `new` görsel URL'leridir
`profile.pinned`	Profil	Sabitlenmiş gönderi değişti; `tweet` ve `old_tweet` gönderilerin kendisini taşır
`profile.verified`	Profil	Doğrulama rozeti belirdi veya kayboldu
`follow.add`	Takip grafiği	Hesap birini takip etmeye başladı; `user` o hesabın tam profilidir
`follow.remove`	Takip grafiği	Hesap birini takip etmeyi bıraktı
`followers.verified.add`	Takip grafiği	Doğrulanmış bir hesap onu takip etmeye başladı; `user` biyografi, sayaçlar, konum ve katılım tarihini taşır
`account.status`	Hesap	Hesap korumalı, askıya alınmış veya erişilemez oldu ya da yeniden etkin

Sık kullanılan seçimler

Sağ sütundaki değeri event_types olarak gönderin. Türler serbestçe birleştirilebilir; ihtiyacınız kadarını listeleyin.

İstediğiniz	`event_types`
Yalnızca hesabın yeni doğrulanmış takipçileri	`["followers.verified.add"]`
Yalnızca özgün gönderileri	`["tweet.create"]`
Yalnızca yanıtları	`["tweet.reply"]`
Yayımladığı her şey: gönderiler, yanıtlar, yeniden gönderiler, alıntılar ve düzenlemeler	`["tweet.create", … 5 tür]`
Gönderileri ve bir gönderiyi sildiğinde	`["tweet.create", "tweet.delete"]`
Yalnızca profil değişiklikleri (dokuz profil türünün tümü)	`["profile.name", … 9 tür]`
Yalnızca kimi takip edip takibi bıraktığı	`["follow.add", "follow.remove"]`
Her şey (varsayılan)	`null`

Nasıl ayarlanır

Hesabı izlemeye başlarken seçin ya da sonradan istediğiniz zaman değiştirin. İki çağrı da targets:write kapsamını gerektirir.

Bir seçimle izlemeye başlama

curl -X POST https://api.xsignalfeed.com/v1/monitor/targets \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"screen_name": "elonmusk", "event_types": ["followers.verified.add"]}'

Seçimi sonradan değiştirme

curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"event_types": ["tweet.create", "tweet.reply"]}'

Tüm türlere dönme

curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"event_types": null}'

Hesabın geçerli seçimi event_types alanındadır; hiçbir şey filtrelenmiyorsa event_types_all değeri true olur.

GET /v1/monitor/targets/elonmusk

{
  "target": {
    "id": "44196397",
    "screen_name": "elonmusk",
    "name": "Elon Musk",
    "state": "subscribed",
    "…": "…",
    "event_types": [
      "tweet.create",
      "tweet.reply"
    ],
    "event_types_all": false
  }
}

Kurallar

Bir hesabı izlemeye başlarken event_types göndermemek tüm türler demektir.
event_types göndermek seçimin tamamını değiştirir; ekleme yapmaz. İzleme çağrısını event_types olmadan yeniden göndermek geçerli seçimi korur.
null ya da [] tüm türler demektir. Listedeki tüm türleri seçmek de aynı şekilde kaydedilir.
Seçim akışa, webhook'lara ve GET /v1/events çağrısına aynı şekilde uygulanır. Açık bir bağlantı değişikliği hemen değil, bir sonraki yenilemede alır.
Bir gönderinin türünü değiştiren update (kind_was taşır), iki türden biri seçiminizdeyse size ulaşır. tweet.create seçip tweet.quote seçmediyseniz, gönderinin alıntı olduğunu gösteren update yine de gelir ve onu atabilirsiniz; tweet.quote seçip tweet.create seçmediyseniz, böyle bir alıntı size ilk olarak o update ile ulaşır.
Seçimi genişletirseniz eklenen türler o andan itibaren gelir. Değişiklikten önceki bu türdeki olayların GET /v1/events ile alınabileceği garanti edilmez.
Bir anahtarın, isteğiniz üzerine bizim ayarladığımız anahtar genelinde bir listesi de olabilir (GET /v1/account içindeki event_types). Bir olay yalnızca iki liste de izin veriyorsa size ulaşır.
Bilinmeyen bir tür 400 invalid_request ile reddedilir; details.unknown onu belirtir, details.allowed kullanabileceklerinizi listeler. Tam liste GET /v1/meta/event-types ile alınır.
Anahtar kelimeler burada değil, anahtar kelime başına seçilir: bir anahtar kelimeyi izleyerek ya da izlemeyi bırakarak search.match olaylarını almaya başlar ya da bırakırsınız.

Seçilemeyenler

Doğrulanmamış yeni takipçiler olay olarak sunulmaz, bu yüzden seçilemez. Yalnızca yeni doğrulanmış takipçiler sunulur (followers.verified.add).
Seçim yalnızca olay türüne göredir, içeriğe göre değil. "10.000'den fazla takipçisi olan doğrulanmış takipçiler", "yalnızca görselli gönderiler" ya da "yalnızca İngilizce" gibi koşulları, yükteki alanları (örneğin user.followers, media, lang) kullanarak kendi tarafınızda uygulayın.