Felo API PlatformFelo API Platform

Felo X Gönderi Yanıtları

Sağlayıcı: Felo · Platform bakiyesinden ödenir

İhtiyacınız olan veri için işlemi seçin. Beş uç noktanın tamamı POST kullanır ve ortak bir data sarmalayıcısı olmadan JSON’u kökte döndürür.

Tüm örnekler genel bakış içindeki FELO_API_KEY’i kullanır. Çağrılar Felo Pro kredilerini değil, platform bakiyesini kullanır. Yanıt örnekleri açıklayıcıdır; canlı içerik ve isteğe bağlı alanlar değişebilir.

5. Yanıtları okuyun

POST /api/v1/data/x/tweet/replies

AlanTürGerekliAnlamı
tweet_idsstring or string arrayEvetTek bir gönderi kimliği veya en fazla 20 kimliklik bir toplu istek
cursorstringHayırEn fazla 4.000 karakter; tek bir gönderi kimliğiyle kullanın
since_timeintegerHayırUnix saniyeleri cinsinden başlangıç zamanı
until_timeintegerHayırUnix saniyeleri cinsinden bitiş zamanı

Yer tutucuyu gerçek bir gönderi kimliğiyle değiştirin:

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/tweet/replies" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tweet_ids":["POST_ID"]}'

Zaman çizelgesi ve gönderi aramasının aksine, yanıtlar results altında gruplanır. Her girişin kendi sayfalama durumu vardır:

{"results":[{"tweet_id":"POST_ID","replies":[],"total":0,"has_next":false,"next_cursor":null}]}

İstek başına yanıt sınırları

Her istek, her tweet_id için bir üst akış yanıt sayfası okur ve en fazla 100 yanıt tutar; tüm yanıt sayfalarını otomatik olarak getirmez. En fazla 20 kimliklik bir toplu istekte, 100 yanıt sınırı her results girdisi için ayrı ayrı geçerlidir. Gerçek sayılar daha düşük olabilir.

Her girdinin total değeri, o girdide dönen yanıt sayısıdır; gönderinin tam yanıt sayısı değildir. Devam etmek için, o girdinin next_cursor değerini kullanın ve sonraki istekte yalnızca tek gönderi kimliğini gönderin. İstek başına sınırı artırmak için bir limit parametresi yoktur.

Sayfalama ve maliyet kontrolü

total, geçerli yanıttaki ilgili diziyi sayar: gönderi sorguları için üst düzey gönderiler veya yanıt sorguları için her sonuç girdisindeki yanıtlar. Bu, genel bir eşleşme sayısı, bir gönderinin tam yanıt sayısı ya da nihai faturalandırılabilir sayı değildir.

  1. İlk isteği cursor olmadan gönderin.
  2. Yanıttan has_next ve next_cursor değerlerini okuyun. Yanıtlar için, bunları her sonuç girdisinde okuyun.
  3. Başka bir sayfa varsa ve cursor boş değilse, aynı sorguyla değiştirmeden gönderin. Bir yanıt toplu isteği için her gönderi için ayrı ayrı devam edin.
  4. Sonraki sayfa yoksa, bir cursor tekrar ederse veya kendi sayfa ya da harcama sınırınıza ulaşıldıysa durun.

Sayfalama meta verileri, son üst akış yanıtını yansıtır; dönen koleksiyon sonuç sınırında kesilmiş olabilir. has_next=false olması bile tüm X geçmişinin veya yanıtlarının alındığının garantisi değildir. Sınırlı bir sonuç kümesini mevcut tüm veri olarak etiketlemek yerine, gerçek dönen sayıyı gösterin.

Her başarılı sayfa bir ücret oluşturabilir. Bu beş işlem dönen sonuçlara göre faturalandırılır, sabit bir istek ücretiyle değil. İç içe yanıtlar ve diğer dönen kayıtlar, faturalandırılan sayımı etkileyebilir; maliyeti yalnızca üst düzey dizinin uzunluğuna göre tahmin etmeyin. Güncel fiyatları ve konsoldaki kullanımı kontrol edin. Tam nesne alanları OpenAPI şemasında yer alır.

Yardım mı gerekiyor?