Dzienniki aktywności tablicy: paginacja kursorowa i limit 90 dni

Zmiana niezgodna wstecz. W wersji API 2027-01 pole activity_logs typu Board zostało przebudowane i obsługuje teraz paginację kursorową, bardziej rozbudowane filtry oraz zakres 90 dni. Pole nie zwraca już zwykłej listy wpisów typu ActivityLogType. Zamiast tego zwraca obiekt BoardActivityLogsPage, który zawiera stronę wpisów i kursor do pobrania kolejnej strony.

Zmiany dotyczące pola activity_logs typu Board:

• Nowy format zwracanych danych. Pole zwraca BoardActivityLogsPage z polami logs (lista wpisów ActivityLog) i cursor (przekaż go ponownie, aby pobrać kolejną stronę; na ostatniej stronie ma wartość null). Wpisy ActivityLog udostępniają też pola correlation_id, triggering_flow_id i triggering_flow_type, które grupują wpisy należące do tej samej sesji logicznej lub przepływu wyzwalającego, np. uruchomienia agenta.
• Kursor zastępuje page. Argument page został usunięty. Zamiast niego użyj nowego argumentu cursor.
• Nowe filtry. event_types filtruje według typu zdarzenia (np. create_pulse), correlation_ids zwraca zdarzenia należące do tej samej sesji logicznej, a search wyszukuje tekstowo nazwy elementów według prefiksu.
• Zakres 90 dni. Argument from przyjmuje znaczniki czasu z okresu do 90 dni wstecz. Żądanie dotyczące starszych danych zwraca błąd walidacji.
• Zmieniono typy argumentów. from i to mają teraz typ String (ISO 8601), a nie ISO8601DateTime. column_ids i group_ids mają teraz typ [ID!], a nie [String].
• Wartość domyślna limit. Schemat nie określa już domyślnej wartości dla limit. W opisie argumentu podano zakres od 1 do 1000 i wartość domyślną 25.

Przykładowe żądanie pobierające pierwszą stronę i kursor do pobrania kolejnej:

query {
  boards(ids: [1234567890]) {
    activity_logs(
      from: "2027-01-05T00:00:00Z"
      event_types: ["create_pulse"]
      limit: 50
    ) {
      logs {
        id
        event
        entity
        user_id
        created_at
        data
      }
      cursor
    }
  }
}

Uwagi dotyczące migracji

Jeśli pobierasz dane z activity_logs w wersji API 2027-01, zaktualizuj żądania w następujący sposób:

1. Dodaj nową strukturę wyboru pól. Wewnątrz activity_logs { ... } wybierz logs { ... } i cursor zamiast wybierać bezpośrednio pola wpisów.
2. Zastąp page argumentem cursor. Przekaż wartość cursor z poprzedniej odpowiedzi, aby pobrać kolejną stronę. Zakończ pobieranie, gdy wartość wynosi null.
3. Zmień deklaracje zmiennych from i to na String zamiast ISO8601DateTime, a zmienne column_ids i group_ids zadeklaruj jako [ID!].
4. Ustaw wartość from w zakresie ostatnich 90 dni. Żądania dotyczące starszych danych zwracają błąd walidacji.
5. Jeśli generujesz typy ze schematu, wygeneruj je ponownie: pole zwraca teraz BoardActivityLogsPage.

Ta zmiana nie wpływa na wcześniejsze wersje API. Opis pola activity_logs w tych wersjach zawiera teraz informację, że zmiany zaczną obowiązywać od wersji 2027-01.