Dobre praktyki programistyczne

Chcemy zapewnić Ci wygodną pracę z narzędziami deweloperskimi monday.com. Dlatego przygotowaliśmy listę wskazówek, trików i dobrych praktyk, które ułatwią Ci tworzenie aplikacji. Niezależnie od tego, czy pracujesz z naszym API, czy tworzysz aplikację do marketplace’u - ta lista jest dla Ciebie!

Korzystanie z API

Korzystaj z mechanizmu kolejkowania mutacji i zapytań, aby uniknąć ograniczeń

Mechanizm kolejkowania jest niezbędny, aby zapewnić użytkownikom dobre doświadczenia i utrzymać API w dobrej kondycji, jeśli Twoja aplikacja wykonuje masowe mutacje lub zapytania.

Więcej informacji znajdziesz u dostawców usług kolejkowania:

• BullMQ

• Amazon SQS

Unikaj przekroczenia limitu czasu wywołań API

Wszystkie wywołania API podlegają 60-sekundowej polityce limitu czasu. Aby uniknąć przekroczenia limitu, pobieraj mniej danych w każdym zapytaniu.

Możesz ograniczyć ilość pobieranych danych, wdrażając paginację, używając limitów w zapytaniach i pobierając tylko potrzebne informacje.

Zastosuj obejście przy pobieraniu elementów według wartości kolumny na dużych tablicach

Pobieranie elementów według wartości kolumny może działać bardzo wolno na dużych tablicach. Szybszym rozwiązaniem może być pobranie wszystkich danych z tablicy i przefiltrowanie ich w aplikacji.

query {
  boards (ids: 1234567891) {
    name
    items (limit:100) {
      id
      name
      column_values {
        text
      }
    }
  }
}

Nie twórz zbyt wielu elementów jednocześnie

Nie możesz tworzyć więcej niż 10–20 elementów w czasie rzeczywistym. Każda mutacja create_item zużywa 10 000 punktów złożoności. Oznacza to, że możesz utworzyć około 160 elementów na minutę, nie przekraczając limitu złożoności.

Jeśli na przykład chcesz utworzyć 1000 elementów, musisz umieścić mutacje w kolejce.

Nie wykonuj wywołań API równolegle

Wykonuj mutacje po kolei. Jeśli jednocześnie wykonasz kilka mutacji na tej samej tablicy, dane na niej mogą ulec uszkodzeniu.

Storage API

Poznaj ograniczenia Storage API

Storage API działa na poziomie instancji, więc różne widoki nie mogą korzystać z tych samych danych. Jeśli chcesz udostępniać dane między różnymi widokami, musisz wdrożyć własną bazę danych po stronie backendu albo znaleźć inne odpowiednie rozwiązanie.

Więcej informacji o Storage API (którego nie należy mylić z monday GraphQL API) znajdziesz w naszym opisie SDK.

📘 Dołącz do naszej społeczności deweloperów!

Stworzyliśmy społeczność specjalnie dla deweloperów. Możesz tam przeszukiwać wcześniejsze dyskusje, aby znaleźć rozwiązania, zadawać pytania, poznawać nowe funkcje i aktualizacje oraz wymieniać się wskazówkami i trikami z innymi deweloperami. Dołącz do nas! 😎