Nowa mutacja do przesyłania opinii o API

Teraz możesz bezpośrednio z poziomu API zgłosić błąd, brakującą funkcję, problem z dokumentacją lub inną opinię na temat monday API. Umożliwia to nowa mutacja submit_api_feedback. Wcześniej nie było sposobu, by bezpośrednio z API poinformować jego zespół o problemach napotkanych podczas tworzenia integracji.

Mutacja przyjmuje dane SubmitApiFeedbackInput i zwraca wynik SubmitApiFeedbackResult:

• kind (wymagane): bug, gdy API zwróciło nieprawidłowy wynik lub nieoczekiwany błąd; feature_request, gdy API nie pozwala wykonać potrzebnej czynności; docs, gdy dokumentacja jest niekompletna, nieprawidłowa lub niejasna; albo feedback w przypadku każdej innej opinii.
• title (wymagane): krótki opis tego, co chcesz zrobić, napisany prostymi słowami. Od 1 do 200 znaków.
• description (wymagane): szczegóły zgłoszenia. Od 1 do 3000 znaków. Opisz, co próbujesz zrobić, czego oczekujesz i jaki jest rezultat. W przypadku feature_request opisz potrzebną czynność, używając pojęć z produktów monday, i napisz, czy udało Ci się znaleźć sposób obejścia problemu.
• field_path (opcjonalne): współrzędne w schemacie, których dotyczy zgłoszenie, na przykład Mutation.reorder_items lub Item.column_values. Jeśli pole nie istnieje, podaj oczekiwaną nazwę.
• error_code (opcjonalne): kod błędu, który otrzymano, na przykład COMPLEXITY_BUDGET_EXHAUSTED.
• request_id (opcjonalne): wartość request_id z pola extensions odpowiedzi na wcześniejsze wywołanie API, którego dotyczy zgłoszenie.
• outcome (opcjonalne): informacja o tym, co zrobiono po napotkaniu problemu: gave_up, performed_action_in_ui, worked_around_with_other_calls lub other.

Wynik zawiera pole success, które przyjmuje wartość true, jeśli zgłoszenie zostało przyjęte, oraz feedback_id, którego możesz użyć, gdy ponownie skontaktujesz się w sprawie tego samego zgłoszenia.

Nie podawaj w zgłoszeniu danych osobowych, takich jak imiona i nazwiska, adresy e-mail ani numery telefonów.

mutation {
  submit_api_feedback(
    input: {
      kind: feature_request
      title: "Move an item to the top of its group"
      description: "I looked for a way to reorder items within a group through the API and could not find one."
      field_path: "Mutation.reorder_items"
      outcome: performed_action_in_ui
    }
  ) {
    success
    feedback_id
  }
}

Mutacja i jej typy (SubmitApiFeedbackInput, SubmitApiFeedbackResult, ApiFeedbackKind i ApiFeedbackOutcome) są dodatkami, które nie wpływają na istniejące zapytania ani mutacje. Pełną listę zmian w tej wersji znajdziesz w informacjach o wydaniu 2026-10.