Dokumentacja dla programistów›Dokumentacja API›Nowe API do znajdowania cykli zależności na tablicy
Dokumentacja dla programistów

Nowe API do znajdowania cykli zależności na tablicy

Aktualizacja 2026-11-05

Możesz teraz zapytać API, jakie cykle zależności występują na tablicy. Nowe zapytanie board_dependency_cycles przyjmuje board_id i zwraca konkretne cykle w grafie zależności tablicy. Dzięki temu możesz znaleźć elementy, których dotyczą, i poprawić powiązania między nimi.

Zapytanie zwraca obiekt BoardDependencyCyclesResult z następującymi polami:

  • board_id: identyfikator sprawdzanej tablicy.
  • cycles: lista obiektów DependencyCycle. Pusta lista oznacza, że tablica została sprawdzona i nie zawiera cykli.
  • truncated: wartość true oznacza, że na tablicy występuje więcej cykli, niż pozwala zwrócić limit. Lista jest wtedy niekompletna.

Każdy obiekt DependencyCycle zawiera pole path - uporządkowaną listę elementów tworzących cykl. Każdy wpis na tej liście to obiekt CycleEdge:

  • item_id: element należący do cyklu.
  • predecessor_id: element, od którego ten element zależy w ramach cyklu.
  • type: typ powiązania, określony przez nowy typ wyliczeniowy CycleEdgeType. Możliwe wartości to FS (koniec–początek), SS (początek–początek), FF (koniec–koniec), SF (początek–koniec) i HIERARCHY (powiązanie elementu nadrzędnego z podelementem, a nie zależność). Wartość wynosi null, jeśli zapisany typ powiązania jest nierozpoznany.

Przykładowe zapytanie:

query {
  board_dependency_cycles(board_id: 1234567890) {
    board_id
    truncated
    cycles {
      path {
        item_id
        predecessor_id
        type
      }
    }
  }
}

Pełną listę zmian w tej wersji API znajdziesz w informacjach o wydaniu 2027-01.