Catatan Pengguna X Felo

Pilih operasi untuk data yang anda perlukan. Semua lima titik akhir menggunakan POST dan memulangkan JSON pada akar, tanpa pembungkus data yang umum.

Semua contoh menggunakan FELO_API_KEY daripada gambaran keseluruhan. Panggilan menggunakan baki platform, bukan kredit Felo Pro. Contoh respons adalah ilustratif; kandungan langsung dan medan pilihan berbeza.

3. Dapatkan garis masa pengguna

POST /api/v1/data/x/user/tweets

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/user/tweets" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"OpenAI","limit":20,"include_replies":false}'

Respons mengandungi tweets, total, has_next dan next_cursor. Menetapkan limit di bawah 20 tidak menjamin item yang dipulangkan lebih sedikit atau bil yang lebih kecil. Menyertakan balasan boleh menambah data yang dipulangkan dan hasil yang boleh dibilkan.

Had hasil dan balasan bersarang

limit ialah bilangan sasaran catatan aras atas untuk permintaan ini, bukan kiraan hasil yang dijamin. Pelaksanaan semasa menggunakan sasaran sekurang-kurangnya 20: sasaran 20 membaca satu halaman huluan; sasaran yang lebih besar secara automatik mengambil sehingga 50 halaman. Sebelum setiap halaman, ia menyemak masa berlalu dan berhenti mengambil halaman seterusnya apabila ia melebihi 60 saat. Semakan ini bukan jaminan bahawa keseluruhan permintaan HTTP selesai dalam 60 saat.

Pengumpulan juga berhenti apabila sasaran dicapai, huluan tiada halaman seterusnya, halaman kosong, atau cursor hilang. Respons berjaya oleh itu boleh mengandungi lebih sedikit catatan daripada limit. Gunakan has_next dan next_cursor untuk meneruskan apabila tersedia.

Dengan include_replies=true, setiap catatan yang dipulangkan mendapat sehingga 5 halaman tambahan dan paling banyak 100 balasan bersarang. Pengumpulan boleh berhenti lebih awal apabila tiada halaman seterusnya, halaman kosong, atau cursor tidak boleh bergerak. Balasan bersarang ini berada di luar limit dan total aras atas, tetapi boleh menambah hasil yang boleh dibilkan.

Balasan bersarang replies bukan arkib balasan yang lengkap dan tidak mendedahkan cursor penerusan berasingan untuk pengumpulan tambahan ini. Untuk paginasi balasan secara bebas, gunakan operasi Baca balasan dan cursor yang dipulangkan. Jangan guna semula cursor catatan aras atas untuk balasan.

Paginasi dan kawalan kos

total mengira tatasusunan yang sepadan dalam respons semasa: catatan aras atas untuk pertanyaan catatan, atau balasan dalam setiap entri hasil untuk pertanyaan balasan. Ia bukan kiraan padanan global, bukan kiraan balasan lengkap catatan, dan bukan kiraan boleh dibilkan akhir.

1. Hantar permintaan pertama tanpa cursor.
2. Baca has_next dan next_cursor daripada respons. Untuk balasan, baca pada setiap entri hasil.
3. Jika ada halaman lain dan cursor tidak kosong, hantar semula tanpa perubahan dengan pertanyaan yang sama. Untuk kelompok balasan, teruskan setiap catatan secara berasingan.
4. Berhenti apabila tiada halaman seterusnya, apabila cursor berulang, atau apabila had halaman atau perbelanjaan anda dicapai.

Metadata paginasi mencerminkan respons huluan terakhir; koleksi yang dipulangkan boleh dipotong pada had hasil. Malah has_next=false bukan jaminan bahawa semua sejarah X atau balasan telah diambil. Paparkan kiraan sebenar yang dipulangkan dan bukannya melabelkan set hasil terhad sebagai semua data yang tersedia.

Setiap halaman berjaya boleh menanggung caj. Lima operasi ini dibilkan mengikut hasil yang dipulangkan, bukan yuran permintaan tetap. Balasan bersarang dan rekod lain yang dipulangkan boleh mempengaruhi kiraan yang dibilkan; jangan anggarkan kos semata-mata berdasarkan panjang tatasusunan aras atas. Semak harga semasa dan penggunaan dalam konsol. Medan objek lengkap ada dalam skema OpenAPI.