Nesneler

Yukarıda başvurulan biçimler, alan alan. Türler resmî değildir: string[] bir dize dizisidir, A | null bulunmayabilir.

Zarf

Her olayda bulunur: akışta, GET /v1/events içinde ve webhook teslimatlarında.

Alan	Tür	Anlamı
`v`	int	Zarf sürümü. Bugün `1`
`t`	string	Olay türü, aşağıdaki tablodan
`op`	create \| update \| delete	`create`, `update` (aynı kimliğin zenginleştirilmesi) veya `delete`
`id`	string	Kararlı kimlik. Yinelenenleri bunun üzerinden ayıklayın
`ts`	int (ms)	X'te ne zaman olduğu, epoch'tan bu yana ms. X profil değişikliklerinin, takip etme ve takibi bırakmanın, yeni doğrulanmış takipçilerin ve gönderi silmenin zamanını vermez: bu olaylarda bizim fark ettiğimiz andır
`sid`	string	Yeniden oynatma için akış konumu; akışta ve geçmişte bulunur
`target.id`	string	İzlenen hesabın sayısal X kimliği (`search.match` için gönderi yazarınınki)
`target.screen_name`	string	İzlenen hesabın kullanıcı adı
`target.name`	string	Hesabın görünen adı
`d`	object	Türe özgü yük

Tweet yükü

tweet.create, tweet.reply, tweet.retweet ve tweet.quote olaylarının d alanı ve search.match olayının temeli.

Alan	Tür	Anlamı
`tweet_id`	string	Gönderinin kimliği, dize olarak
`kind`	tweet \| reply \| retweet \| quote	Ne tür bir gönderi olduğu
`text`	string	Tam metin (uzun gönderiler dahil)
`lang`	string \| null	X'in algıladığı dil
`author`	User	Gönderiyi yayımlayan hesap, tam bir User nesnesi olarak — `search.match` yazarıyla aynı nesne: kullanıcı adı, ad, biyografi, avatar, kapak, sayılar, doğrulama, konum, bağlantı ve katılma tarihi. İnce ilk çerçevede hesabın en son okunan hali; `update` ise gönderiyle birlikte okunan hali taşır
`reply_to`	Brief+ \| null	Yanıtlar için: yanıtlanan gönderi — bir Özet artı yazarının `screen_name`, `tweet_id` ve `user_id` değerleri
`retweet_of`	Brief \| null	Yeniden gönderiler için: özgün gönderi
`quoted`	Brief \| null	Alıntılar için: alıntılanan gönderi
`media`	string[]	Düz görsel URL'leri, medya öğesi başına bir tane
`media_items`	Media[]	Türü, video varyantları ve boyutlarıyla her medya öğesi
`urls`	string[]	Gönderideki genişletilmiş bağlantılar
`article`	Article \| null	Bir X makalesine bağlantı veren gönderilerde: makale
`counts`	{reply, rt, like, quote, bookmark}	Okuduğumuz andaki yanıt, yeniden gönderi, beğeni, alıntı ve yer imi sayıları
`views`	int \| null	Görüntülenme sayısı, X sunduğunda
`url`	string	Gönderinin kanonik bağlantısı
`full`	bool	İlk, ince `create` çerçevesinde `false`; olay gönderinin tamamını taşıdığında `true`
`kind_final`	bool	`kind` kesinleştiğinde `true`. `false` yalnızca `kind` değeri `tweet` olan ince ilk çerçevede görülür: gönderi yine de alıntı çıkabilir ve aynı `id` ile gelen `update` bunu kesinleştirir
`kind_was`	tweet \| null (update only)	Yalnızca gönderinin türünü kesinleştiren `update` olayında ve yalnızca ilk çerçeve farklı bir tür söylediyse bulunur: o çerçevenin türü (alıntı çıkan bir gönderi için `tweet`)
`edit_of`	Brief \| null	`tweet.edit` olayında: bu sürümün yerini aldığı sürüm (kimliği ve elimizdeyse metni ile yazarı)

Özet

Başka bir olaya gömülü kompakt bir gönderi: yeniden gönderinin özgünü, alıntılanan gönderi, yanıtlanan gönderi veya sabitlenmiş gönderi.

Alan	Tür	Anlamı
`id`	string	Gönderi kimliği
`user`	string	Yazarın kullanıcı adı
`name`	string	Yazarın görünen adı
`user_id`	string	Yazarın sayısal kimliği
`text`	string	Tam metin
`media`	string[]	Düz görsel URL'leri
`media_items`	Media[]	Türü ve video varyantlarıyla medya öğeleri
`created_ms`	int	Ne zaman paylaşıldığı, epoch'tan bu yana ms
`url`	string	Gönderinin bağlantısı

Medya

Bir resim, video veya GIF. Videolar bulabildiğimiz en yüksek bit hızlı MP4'ü taşır; url poster karesidir.

Alan	Tür	Anlamı
`type`	photo \| video \| animated_gif	Medya türü
`url`	string	Görsel URL'si veya bir videonun poster karesi
`expanded_url`	string	Gönderinin X'teki medya sayfası
`video_url`	string (video)	MP4 URL'si, mevcut en yüksek bit hızı
`bitrate`	int (video)	O MP4'ün bit hızı
`duration_ms`	int (video)	Video uzunluğu
`width`	int	Piksel cinsinden özgün genişlik
`height`	int	Piksel cinsinden özgün yükseklik

Makale

Bir gönderinin bağlantı verdiği X makalesi (uzun biçimli gönderi). İlk çerçeve title ve preview taşır; aynı id ile gelen update makalenin tamamını getirene kadar text değeri null olur.

Alan	Tür	Anlamı
`id`	string	Makale kimliği
`title`	string	Başlık
`preview`	string	Makalenin ilk satırları
`text`	string \| null	Tam metin, paragraflar boş satırlarla ayrılır; ilk çerçevede `null`
`cover`	string \| null	Kapak görselinin URL'si
`images`	string[]	Makaledeki görseller
`url`	string	Makalenin X'teki bağlantısı

Silme yükü

tweet.delete olayının d alanı. Yalnızca görmüş olduğumuz ve artık var olmayan bir gönderi için gönderilir. ts silmenin fark edildiği andır; gönderinin kendi zamanı daha önceki create çerçevesindedir.

Alan	Tür	Anlamı
`tweet_id`	string	Silinen gönderinin kimliği
`url`	string	Eskiden bulunduğu yer

Profil değişikliği yükü

Her profile.* olayının d alanı. Bunlarda op, update olur.

Alan	Tür	Anlamı
`field`	string	Hangi profil alanının değiştiği; türdeki `profile.` sonrasındaki sözcüğün aynısı
`old`	any	Önceki değer
`new`	any	Yeni değer
`tweet`	Brief (pinned only)	`profile.pinned` için: yeni sabitlenmiş gönderi
`old_tweet`	Brief (pinned only)	`profile.pinned` için: elimizde varsa önceki sabitlenmiş gönderi

Takip yükü

follow.add, follow.remove ve followers.verified.add olaylarının d alanı.

Alan	Tür	Anlamı
`user`	User	Diğer hesap, tam bir Kullanıcı olarak

Hesap durumu yükü

account.status olayının d alanı. Durum active, protected (gönderiler yalnızca onaylı takipçilere görünür), suspended (X tarafından askıya alınmış) veya unavailable (devre dışı bırakılmış, silinmiş ya da başka bir nedenle görünmez) değerlerinden biridir. ts değişikliği fark ettiğimiz andır.

Alan	Tür	Anlamı
`old`	active \| protected \| suspended \| unavailable	Önceki durum
`new`	active \| protected \| suspended \| unavailable	Şimdiki durum
`reason`	string \| null	Varsa X'in kendi ifadesi (örneğin `Suspended`)

Kullanıcı

Takip olaylarına ve search.match olayına gömülü haliyle tam bir hesap profili.

Alan	Tür	Anlamı
`id`	string	Sayısal kimlik
`screen_name`	string	Kullanıcı adı
`name`	string	Görünen ad
`bio`	string	Biyografi metni
`avatar`	string	Avatar görseli URL'si
`banner`	string \| null	Banner görseli URL'si
`followers`	int	Takipçi sayısı
`following`	int	Takip edilen sayısı
`tweets`	int	Gönderi sayısı
`location`	string	Serbest metin konum
`url`	string \| null	Genişletilmiş profil bağlantısı
`verified`	bool	Doğrulama rozeti var
`verified_type`	string \| null	`blue`, `business`, `government` veya `null`
`protected`	bool	Gönderiler yalnızca onaylı takipçilere görünür
`created_at`	string (ISO-8601)	Hesabın ne zaman oluşturulduğu
`category`	string \| null	Hesap ayarladıysa profesyonel kategori

Arama eşleşmesi yükü

search.match olayının d alanı: bir Tweet yükü artı eşleşmeyle ilgili üç alan. Zarfın target alanı gönderinin yazarıdır; hedeflerinizden biri olması gerekmez.

Alan	Tür	Anlamı
`keyword.id`	int	Eşleşen anahtar kelimenin kimliği
`keyword.query`	string	Sorgusu
`keyword.label`	string \| null	Ayarladıysanız etiketi
`author`	User	Yazarın tam profili
`author_is_target`	bool	Yazar aynı zamanda bu sistemde izlenen bir hesapsa `true`
`…`	TweetPayload	Tweet yükünün her alanı

Hedef

İzlediğiniz bir hesap, bu anahtarın gördüğü haliyle.

Alan	Tür	Anlamı
`id`	string	Sayısal X kimliği. Hiç değişmez: kayıtlarınızı buna göre anahtarlayın
`screen_name`	string	Geçerli kullanıcı adı. Değişebilir; `profile.screen_name` bunu bildirir
`name`	string	Görünen ad
`previous_screen_names`	string[]	Hesabın daha önce kullandığı kullanıcı adları, en yenisi önce. Her biri `/v1/monitor/targets/{target}` içinde hesabı hâlâ gösterir
`push_ready`	bool	Bu hesap için abone olduğunuz tüm olay türleri gerçek zamanlı toplanıyor. `false` hiçbir şeyi bekletmez: hesap abone olunduğu andan itibaren izlenir ve olayları toplandıkça iletilir; bu yüzden olayları işlemek için bu bayrağı beklemeyin
`last_push_at`	datetime \| null	Onun için son gerçek zamanlı olayın geldiği zaman
`last_poll_at`	datetime \| null	Zaman çizelgesinin son okunduğu zaman
`state`	"subscribed"	Burada her zaman `subscribed`; bekleyen çözümlemelerin kendi biçimi vardır
`event_types`	string[]	Bu hesap için iletilen olay türleri; boşsa anahtarınızın izin verdiği tümü
`event_types_all`	bool	`event_types` boşsa `true`

Bekleyen hedef

İstediğiniz bir hesap hâlâ çözümlenirken GET /v1/monitor/targets/{target} adresinin döndürdüğü.

Alan	Tür	Anlamı
`screen_name`	string \| null	Kullanıcı adıyla istediyseniz, istediğiniz kullanıcı adı
`user_id`	string \| null	Kimlikle istediyseniz, istediğiniz kullanıcı kimliği
`state`	"queued"	Her zaman `queued`
`queued_at`	int (unix s)	Ne zaman istediğiniz
`event_types`	string[]	Bunun için seçilen olay türleri; çözümlendiğinde uygulanır
`event_types_all`	bool	`event_types` boşsa `true`

Anahtar kelime

X aramasında izlediğiniz bir sorgu.

Alan	Tür	Anlamı
`id`	int	Sayısal kimlik; silmek için kullanın
`query`	string	Sorgu, X arama söz dizimiyle
`label`	string \| null	Etiketiniz, her eşleşmede geri döner
`active`	bool	Operatör duraklattıysa `false`
`hits`	int	Şimdiye kadar teslim edilen eşleşmeler
`last_hit_at`	datetime \| null	Son eşleşme
`last_run_at`	datetime \| null	Son arama

Hesap

GET /v1/account adresinin kullandığınız anahtar hakkında döndürdüğü.

Alan	Tür	Anlamı
`name`	string	Anahtarın verildiği haliyle adı
`plan`	string	Plan ön ayarı
`key_id`	string	Anahtarın kısa kimliği; destek taleplerinde güvenle belirtilebilir
`scopes`	string[]	Anahtarın sahip olduğu kapsamlar
`event_types`	string[]	Anahtar genelinde, bizim yönettiğimiz olay türü izin listesi; boş, tümü demektir
`event_types_all`	bool	Filtre boşken `true`
`limits.max_targets`	int	İzlenen hesap üst sınırı
`limits.max_conns`	int	Eşzamanlı WebSocket üst sınırı
`limits.max_keywords`	int	Anahtar kelime üst sınırı
`limits.requests_per_minute`	int	Dakikalık istek bütçesi
`usage.targets`	int	Şu anda izlenen hesaplar
`usage.keywords`	int	Şu anda izlenen anahtar kelimeler

Webhook

GET /v1/account/webhook adresinin döndürdüğü.

Alan	Tür	Anlamı
`url`	string \| null	Kayıtlı uç nokta
`stats`	{ok, http_`…}`	Teslimat sayaçları: `ok` ve görülen her hata durumu için bir `http_<code>`

Alan	Tür	Anlamı
`count`	int	Bu sayfadaki öğeler
`has_more`	bool	Başka bir sayfa olup olmadığı
`next_cursor`	string \| null	`?cursor=` olarak geri geçin; sonda `null`

Toplu işlem sonucu

POST /v1/monitor/targets:batch adresine gönderilen her öğe için bir kayıt, aynı sırada.

Alan	Tür	Anlamı
`index`	int	Öğenin isteğinizdeki konumu
`status`	int	Tek öğeli uç noktanın döndüreceği HTTP durumu
`data`	object (on success)	Başarıda tek öğeli yanıt gövdesi
`error`	{code, message, details?} (on failure)	Hatada olağan hata nesnesi

Profil (okuma)

GET /v1/users/{screen_name}, /v1/users/by-id/{user_id} ve /v1/users/batch adreslerinin hesap başına döndürdüğü.

Alan	Tür	Anlamı
`id`	string	Sayısal kimlik
`name`	string	Görünen ad
`screen_name`	string	Kullanıcı adı
`bio`	string	Biyografi metni
`location`	string	Serbest metin konum
`url`	string \| null	Profil bağlantısı
`avatar`	string	Avatar görseli URL'si
`banner`	string \| null	Banner görseli URL'si
`pinned`	string \| null	Sabitlenmiş gönderinin kimliği
`verified`	bool	Doğrulama rozeti var
`protected`	bool	Gönderiler yalnızca onaylı takipçilere görünür
`followers`	int	Takipçi sayısı
`following`	int	Takip edilen sayısı
`tweets`	int	Gönderi sayısı

Tweet (okuma)

Okuma uç noktalarının döndürdüğü haliyle bir gönderi. Tweet yüküyle aynı bilgi, ayrıştırıcımızın ürettiği daha düz biçimde.

Alan	Tür	Anlamı
`id`	int	Gönderi kimliği, sayısal
`created_ms`	int	Ne zaman paylaşıldığı, epoch'tan bu yana ms
`user_id`	int	Yazarın sayısal kimliği
`user`	string	Yazarın kullanıcı adı
`name`	string	Yazarın görünen adı
`text`	string	Tam metin
`lang`	string \| null	X'in algıladığı dil
`reply_to`	string \| null	Yanıtlanan kullanıcı adı
`reply_to_status_id`	string \| null	Yanıtlanan gönderinin kimliği
`reply_to_user_id`	string \| null	Yanıtlanan hesabın kimliği
`conversation_id`	string	Dizinin kök gönderisinin kimliği
`is_rt`	bool	Bir yeniden gönderidir
`rt_of`	Brief \| null	Yeniden gönderiler için özgün gönderi
`is_quote`	bool	Başka bir gönderiyi alıntılıyor
`quoted`	Brief \| null	Alıntılanan gönderi
`media`	string[]	Düz görsel URL'leri
`media_items`	Media[]	Türü ve video varyantlarıyla medya öğeleri
`urls`	string[]	Genişletilmiş bağlantılar
`views`	int \| null	Görüntülenme sayısı
`counts`	{reply, rt, like, quote, bookmark}	Yanıt, yeniden gönderi, beğeni, alıntı ve yer imi sayıları
`article`	Article \| null	Gönderinin bağlantı verdiği X makalesi, varsa (başlık, önizleme, kapak, görseller; tam metin `GET /v1/tweets/{tweet_id}/article` adresindedir)
`edit_of`	int \| null	Düzenlenmiş bir sürümse ilk sürümün kimliği, değilse `null`
`edit_ids`	int[]	Tüm sürümlerin kimlikleri, en eskisi önce; hiç düzenlenmemiş bir gönderi yalnızca kendisini listeler
`source`	string \| null	Gönderinin paylaşıldığı istemci, X'in verdiği şekliyle (bir HTML bağlantısı, örneğin `Twitter for iPhone`)

Kullanıcı referansı

Takip listesi okumalarında kullanılan kompakt biçim.

Alan	Tür	Anlamı
`id`	string	Sayısal kimlik
`screen_name`	string	Kullanıcı adı
`name`	string	Görünen ad