Felo X Posty użytkownika

Wybierz operację dla danych, których potrzebujesz. Wszystkie pięć punktów końcowych używa POST i zwraca JSON w korzeniu, bez wspólnego opakowania data.

Wszystkie przykłady używają FELO_API_KEY z przeglądu. Wywołania korzystają z salda platformy, a nie z kredytów Felo Pro. Przykłady odpowiedzi mają charakter poglądowy; rzeczywista treść i opcjonalne pola mogą się różnić.

3. Pobierz oś czasu użytkownika

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}'

Odpowiedź zawiera tweets, total, has_next i next_cursor. Ustawienie limit poniżej 20 nie gwarantuje mniejszej liczby zwróconych elementów ani niższej opłaty. Uwzględnienie odpowiedzi może dodać zwrócone dane i płatne wyniki.

Limity wyników i zagnieżdżonych odpowiedzi

limit jest docelową liczbą postów najwyższego poziomu dla tego żądania, a nie gwarantowaną liczbą wyników. Bieżąca implementacja używa celu co najmniej 20: cel 20 odczytuje jedną nadrzędną stronę; większe cele automatycznie pobierają do 50 stron. Przed każdą stroną sprawdzany jest upływ czasu i pobieranie kolejnych stron zatrzymuje się po przekroczeniu 60 sekund. To sprawdzenie nie gwarantuje, że całe żądanie HTTP zakończy się w ciągu 60 sekund.

Zbieranie zatrzymuje się również, gdy osiągnięto cel, nadrzędne źródło nie ma następnej strony, strona jest pusta lub kursor jest brakujący. Udana odpowiedź może więc zawierać mniej niż limit postów. Użyj has_next i next_cursor, aby kontynuować, gdy są dostępne.

Przy include_replies=true każdy zwrócony post otrzymuje do 5 dodatkowych stron i maksymalnie 100 zagnieżdżonych odpowiedzi. Zbieranie może zakończyć się wcześniej, gdy nie ma następnej strony, strona jest pusta lub kursor nie może przejść dalej. Te zagnieżdżone odpowiedzi są poza górnym limit i total, ale mogą zwiększać liczbę wyników podlegających rozliczeniu.

Zagnieżdżone replies nie stanowią kompletnego archiwum odpowiedzi i nie udostępniają osobnego kursora kontynuacji dla tego dodatkowego zbierania. Aby stronicować odpowiedzi niezależnie, użyj operacji odczytu odpowiedzi i zwróconego przez nią kursora. Nie używaj ponownie kursora postu najwyższego poziomu do odpowiedzi.

Stronicowanie i kontrola kosztów

total zlicza odpowiednią tablicę w bieżącej odpowiedzi: posty najwyższego poziomu dla zapytań o posty albo odpowiedzi w każdym wpisie wyniku dla zapytań o odpowiedzi. Nie jest to globalna liczba dopasowań, pełna liczba odpowiedzi posta ani końcowa liczba rozliczeniowa.

1. Wyślij pierwsze żądanie bez cursor.
2. Odczytaj has_next i next_cursor z odpowiedzi. W przypadku odpowiedzi odczytuj je w każdym wpisie wyniku.
3. Jeśli istnieje kolejna strona, a kursor nie jest pusty, wyślij go bez zmian z tym samym zapytaniem. W przypadku partii odpowiedzi kontynuuj każdy post osobno.
4. Zatrzymaj się, gdy nie ma następnej strony, gdy kursor się powtarza lub gdy osiągnięto własny limit strony albo wydatków.

Metadane stronicowania odzwierciedlają ostatnią odpowiedź nadrzędną; zwrócony zbiór może zostać obcięty przez limit wyników. Nawet has_next=false nie gwarantuje, że cała historia X lub wszystkie odpowiedzi zostały pobrane. Wyświetlaj rzeczywistą liczbę zwróconych elementów zamiast oznaczać ograniczony zbiór jako wszystkie dostępne dane.

Każda udana strona może generować opłatę. Te pięć operacji jest rozliczanych według zwróconych wyników, a nie według stałej opłaty za żądanie. Zagnieżdżone odpowiedzi i inne zwrócone rekordy mogą wpływać na liczbę rozliczanych wyników; nie szacuj kosztu wyłącznie na podstawie długości tablicy najwyższego poziomu. Sprawdź bieżące ceny i użycie w konsoli. Pełne pola obiektów znajdują się w schemacie OpenAPI.