Temel kavramlar
Hedefler ve anahtar kelimeler farklı şeylerdir
Hedef, izlediğiniz bir hesaptır; yaptığı her şeyi ya da yalnızca seçtiğiniz olay türlerini alırsınız. Anahtar kelime, tüm X üzerinde izlediğiniz bir sorgudur; ona uyan gönderileri, kim paylaşmış olursa olsun, search.match olayları olarak alırsınız. Hedefler kullanıcı adıyla, anahtar kelimeler sorgu metniyle tanımlanır ve bir anahtar, planının üst sınırlarına kadar her ikisinden istediği sayıda tutabilir.
Hesap kullanıcı adı değil, kimliğidir
Bir hesabı izlersiniz; hesap sayısal X kimliğiyle (Target üzerindeki id) tanınır. Hesap kullanıcı adını (screen_name) veya görünen adını istediği zaman değiştirebilir: olaylarını almaya devam edersiniz, sonraki olaylar yeni kullanıcı adını target.screen_name içinde taşır ve bir profile.screen_name ya da profile.name olayı neyin değiştiğini bildirir. Kayıtlarınızı id üzerinden anahtarlayın. API'nin bir hesap istediği her yerde onu user_id, geçerli kullanıcı adı veya daha önce kullandığı bir kullanıcı adıyla belirtebilirsiniz.
İki aşamalı teslimat: önce create, sonra update
Bazı gönderi olayları iki çerçevede teslim edilir. İlki, op: "create", temel bilgileri — gönderi kimliği, yazar ve metin — taşır; böylece hemen harekete geçebilirsiniz. Kısa bir süre sonra aynı olay kimliği bu kez op: "update" ile yeniden gelir; artık medyayı, alıntılanan veya yanıtlanan özgün gönderiyi, sayaçları ve geri kalan her şeyi taşır. İlk görüldüğünde eksiksiz olan olayların ikinci çerçevesi yoktur; GET /v1/meta/event-types hangi türlerde olabileceğini söyler.
create üzerinden hareket edin. Gönderinin tamamı gerekiyorsa aynı id için update olayını bekleyin. Her iki durumda da depolamanızı id üzerinden anahtarlayın ve sonradan gelen bir update sakladığınızın üzerine yazsın. Tür iki çerçeve arasında yalnızca bir şekilde değişir: kind_final: false taşıyan ilk tweet.create tweet.quote olabilir. Özgün gönderileri ve alıntıları farklı işliyorsanız böyle bir çerçeveyi update geldikten sonra sınıflandırın.En az bir kez, asla tam olarak bir kez
İzlenen her hesap aynı anda birkaç bağımsız yol tarafından izlenir; böylece başarısız olan tek bir yol size hiçbir şeye mal olmaz. Belirli bir değişikliği ilk bildiren kazanır ve olay olur; diğerleri yeniden teslim edilmek yerine doğrulama olarak kaydedilir. Ancak bir yeniden bağlanma sırasında zaten sahip olduğunuz bir olayı görebilirsiniz. id üzerinden yinelenenleri ayıklayın.
Konum ve yeniden oynatma
Her olay bir sid taşır — günlüğümüzdeki konumu. İşlediğiniz son değeri kalıcı olarak saklayın; yeniden bağlanırken onu ?last_id= olarak geçin, biz de canlı akışa dönmeden önce ondan sonraki her şeyi gönderelim. Günlük 24 saat tutulur ve tek bir yeniden bağlanma en fazla 5.000 olay yeniden oynatır. Bir soket açıkken eklediğiniz hedefler veya anahtar kelimeler 30 saniye içinde o soketten akmaya başlar; yeniden bağlanmanız gerekmez.