Jeśli żądanie API nie może zostać pomyślnie zrealizowane, otrzymasz komunikat o błędzie.

Format błędu

Błędy zwracane przez API mają następujące cechy:

• Kod HTTP: w przypadku błędów na poziomie aplikacji odpowiedź będzie miała kod 200 – OK. Inne kody są zwracane w przypadku błędów warstwy transportowej, takich jak 500 - Internal server error, 429 - Too many requests lub 400 - Bad request.
• Odpowiedź JSON: treść odpowiedzi zawiera tablicę errors z dodatkowymi informacjami o każdym błędzie.
• Częściowe dane: żądania zwracają częściowe dane, więc obiekt data może również zawierać pewne informacje. Na przykład jeśli zapytasz o trzy pola, możesz otrzymać dwa pola i jeden błąd.
• Nagłówek Retry-After: odpowiedzi z błędami zawierają nagłówek Retry-After, który wskazuje, jak długo musisz odczekać przed wysłaniem kolejnego żądania.
• Nagłówki limitów szybkości: każda odpowiedź zawiera nagłówki RateLimit-Policy i RateLimit, które informują o bieżącym stanie limitów szybkości. Dzięki nim możesz z wyprzedzeniem monitorować pozostały limit.
• Każda odpowiedź API zawiera request_id w obiekcie extensions. Możesz go użyć do diagnozowania problemów.

Przykładowy format

Poniżej znajduje się przykład błędu na poziomie aplikacji:

{
  "data" : [],
  "errors": [
    {
      "message": "User unauthorized to perform action",
      "locations": [
        {
          "line": 2,
          "column": 3
        }
      ],
      "path": [
        "me"
      ],
      "extensions": {
        "code": "UserUnauthorizedException",
        "error_data": {},
        "status_code": 403
      }
    }
  ],
  "account_id": 123456
}

{
  "data": {
    "me": {
      "id": "4012689",
      "photo_thumb": null
    },
    "complexity": {
      "query": 12
    }
  },
  "errors": [
    {
      "message": "Photo unavailable.",
      "locations": [
        {
          "line": 4,
          "column": 5
        }
      ],
      "path": [
        "me",
        "photo_thumb"
       ],
      "extensions": {
        "code": "ASSET_UNAVAILABLE"
      }
    }
  ],
  "account_id": 18888528
}

Błędy według kodu statusu

Błędy 2xx

Błędy z kodem statusu 2xx oznaczają, że monday.com nie akceptuje żądanej czynności z powodu ograniczeń lub reguł platformy. Mogą wystąpić z różnych przyczyn, na przykład gdy podasz nieprawidłowe wartości, nie masz wymaganych uprawnień lub przekroczysz limit znaków.

Poniżej znajdziesz niektóre z najczęstszych błędów:

Kod błędu	Kod statusu HTTP	Opis	Rozwiązanie
API_TEMPORARILY_BLOCKED	200	Wystąpił problem z API i jego używanie zostało tymczasowo zablokowane	Sprawdź stronę statusu, aby zobaczyć aktualizacje. Ponów żądanie, gdy problem zostanie rozwiązany.
ColumnValueException	200	Nieprawidłowy format wartości kolumny	Upewnij się, że nasze API obsługuje tę kolumnę i że jej wartość nie jest obliczana po stronie klienta. Sprawdź, czy wartość kolumny jest zgodna ze strukturą danych danej kolumny. Sprawdź, czy kolumna połącz tablice, do której się odwołujesz, jest połączona z tablicą w interfejsie monday.com. W przypadku kolumn połącz tablice użyj {"item_ids": ["123"]} - nie używaj linkedPulseIds ani linkedPulseId. Mogą pojawić się w niektórych treściach błędów, ale nie są prawidłowymi kluczami zapisu. W przypadku kolumn połącz tablice użyj change_multiple_column_values, a nie change_column_value.
CorrectedValueException	200	Zapytanie ma nieprawidłowy typ	Jeśli próbujesz zaktualizować kolumnę prostymi wartościami (wartościami typu String), upewnij się, że kolumna obsługuje ten format wartości.
CreateBoardException	200	Błąd w mutacji tworzącej tablicę	Jeśli tworzysz tablicę na podstawie szablonu, upewnij się, że identyfikator szablonu jest prawidłowym szablonem monday lub identyfikatorem tablicy ze statusem szablonu. Więcej informacji o tworzeniu szablonów tablic znajdziesz tutaj. Jeśli duplikujesz tablicę, upewnij się, że jej identyfikator istnieje.
InvalidArgumentException	200	Argument przekazany w zapytaniu jest nieprawidłowy, przekroczono limit paginacji, wysyłasz zapytanie o identyfikator tablicy podelementów albo nie znaleziono identyfikatora tablicy	Sprawdź, czy w argumencie nie ma literówek. Upewnij się, że argument istnieje dla obiektu, którego dotyczy zapytanie. Zmniejsz zakres wyników. W przypadku move_item_to_board upewnij się, że columns_mapping jest tablicą obiektów { source, target }. Zobacz opis formatu.
InvalidBoardIdException	200	Identyfikator tablicy przekazany w zapytaniu jest nieprawidłowy	Sprawdź, czy identyfikator tablicy istnieje i czy masz do niej dostęp.
InvalidColumnIdException	200	Identyfikator kolumny przekazany w zapytaniu jest nieprawidłowy	Sprawdź, czy identyfikator kolumny istnieje i czy masz do niej dostęp.
InvalidUserIdException	200	Identyfikator użytkownika przekazany w zapytaniu jest nieprawidłowy	Sprawdź, czy identyfikator użytkownika istnieje i czy ta osoba jest przypisana do Twojej tablicy.
InvalidVersionException	200	Żądana wersja API jest nieprawidłowa	Upewnij się, że Twoje żądanie ma prawidłowy format.
ItemNameTooLongException	200	Nazwa elementu przekracza dozwoloną liczbę znaków	Upewnij się, że nazwa elementu ma od 1 do 255 znaków.
ItemsLimitationException	200	Przekroczono limit 10 000 elementów na tablicę	Zmniejsz liczbę elementów na tablicy.
missingRequiredPermissions	200	Operacja wymaga uprawnień OAuth wykraczających poza zakresy przyznane aplikacji	Sprawdź zakresy uprawnień aplikacji i upewnij się, że zażądano odpowiednich zakresów.
Parse error on...	200	Nieprawidłowy format ciągu zapytania	Sprawdź, czy wszystkie ciągi znaków w zapytaniu są prawidłowe. Zamknij wszystkie nawiasy okrągłe, kwadratowe i klamrowe.
ResourceNotFoundException	200	Identyfikator przekazany w zapytaniu jest nieprawidłowy	Sprawdź, czy istnieje identyfikator elementu, grupy lub tablicy, której dotyczy zapytanie. Nie znaleziono kolumny: identyfikator kolumny może być nieprawidłowy albo kolumna mogła zostać usunięta, mimo że odwołuje się do niej automatyzacja lub integracja. Sprawdź tablicę w interfejsie i zaktualizuj lub usuń automatyzacje, które odwołują się do brakującej kolumny.

Błędy klienta 4xx

Błędy z kodem statusu 4xx oznaczają, że problem wystąpił po stronie klienta (czyli po Twojej stronie). Mogą mieć różne przyczyny, na przykład brak dostępu do żądanych informacji, zbyt częste używanie API lub nieprawidłowe dane wejściowe.

Poniżej znajdziesz niektóre z najczęstszych błędów:

Błąd	Kod statusu HTTP	Opis	Rozwiązanie
Bad request	400	Struktura ciągu zapytania została przekazana nieprawidłowo	Przekaż ciąg zapytania za pomocą klucza query. Wyślij żądanie metodą POST z treścią w formacie JSON. Nie zostawiaj niedomkniętych ciągów znaków w zapytaniu.
JsonParseException	400	Problem z interpretacją przekazanego kodu JSON	Sprawdź poprawność kodu JSON za pomocą walidatora, na przykład JSON lint.
Unauthorized	401	Nie masz uprawnień do dostępu do danych	Wprowadź prawidłowy klucz API. Przekaż klucz w nagłówku Authorization.
Your ip is restricted	401	Administrator konta ograniczył dostęp do systemu z określonych adresów IP	Upewnij się, że administrator konta nie ograniczył dostępu z Twojego adresu IP.
UserUnauthorizedException	403	Użytkownik nie ma wymaganych uprawnień do wykonania danej czynności	Sprawdź, czy użytkownik ma uprawnienia do wyświetlania lub edytowania danego zasobu.
USER_ACCESS_DENIED	403	Użytkownik nie ma uprawnień do korzystania z API	Sprawdź, czy użytkownik jest aktywny, nie ma wyłącznie uprawnień do wyświetlania i ma potwierdzony adres e-mail.
ResourceNotFoundException	404	Identyfikator przekazany w zapytaniu jest nieprawidłowy	Sprawdź, czy identyfikator użytkownika, którego dotyczy zapytanie, istnieje i czy ta osoba jest przypisana do Twojej tablicy.
DeleteLastGroupException	409	Trwa usuwanie lub archiwizowanie ostatniej grupy na tablicy	Sprawdź, czy na tablicy jest co najmniej jedna grupa.
IDEMPOTENCY_CONFLICT	409	Żądanie z tym kluczem idempotencji jest już przetwarzane	Ponów żądanie po upływie czasu określonego w nagłówku odpowiedzi Retry-After. Szczegółowe informacje znajdziesz w sekcji Idempotencja.
RecordInvalidException	422	Oznacza jedną z następujących sytuacji: Na tablicę przypisano ponad 400 indywidualnych obserwujących lub ponad 100 obserwujących będących zespołami. Użytkownik lub zespół obserwuje ponad 10 000 tablic.	Dowiedz się, jak optymalizować liczbę obserwujących tablicę. Zrezygnuj z obserwowania niepotrzebnych tablic, usuń je lub zarchiwizuj.
Resource is currently locked, please try again later	423	Tablica jest tymczasowo zablokowana, ponieważ inny proces wykonuje równoczesną aktualizację (np. aktualizuje kolumnę lub uruchamia automatyzację). W tym czasie operacje zapisu są zablokowane, aby zapewnić spójność danych.	Ponów żądanie po krótkiej przerwie. Unikaj równoczesnego aktualizowania tej samej tablicy z różnych źródeł.
maxConcurrencyExceeded	429	Przekroczono maksymalną liczbę zapytań, które mogą być wykonywane jednocześnie	Zmniejsz liczbę zapytań wysyłanych jednocześnie. Zastosuj w kodzie mechanizm ponawiania żądań.
Rate Limit Exceeded	429	Wysłano ponad 5 000 żądań w ciągu minuty	Zmniejsz liczbę żądań wysyłanych w ciągu minuty.
COMPLEXITY_BUDGET_EXHAUSTED	429	Osiągnięto limit złożoności	Użyj argumentów limits i page. Pytaj tylko o potrzebne informacje. Więcej informacji znajdziesz w sekcji o limitach szybkości.
IP_RATE_LIMIT_EXCEEDED	429	Osiągnięto limit dla adresu IP	Przed ponowieniem żądania odczekaj czas określony w odpowiedzi błędu. Dowiedz się więcej o optymalizowaniu użycia API.

Błędy serwera 5xx

Błędy z kodem statusu 5xx oznaczają, że problem wystąpił po stronie serwera monday.

Poniżej znajdziesz niektóre z najczęstszych błędów:

Błąd	Kod statusu HTTP	Opis	Rozwiązanie
Internal Server Error	500	Oznacza, że wystąpił problem. Częste przyczyny: Nieprawidłowe argumenty, na przykład nieistniejące identyfikatory tablic lub elementów Nieprawidłowo sformatowane wartości kolumn w formacie JSON	Ponów żądanie po krótkiej przerwie. Sprawdź dokładnie format żądania. Upewnij się, że token API ma odpowiednie uprawnienia.

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

Stworzyliśmy społeczność dla deweloperów. Możesz tam wyszukiwać wcześniejsze dyskusje i znajdować rozwiązania, zadawać pytania, poznawać nowe funkcje i aktualizacje oraz uczyć się wskazówek i trików od innych deweloperów. Dołącz do nas! 😎