Към съдържанието

Отстраняване на грешки при проверка на заявки

Използвайте отговор 422, за да намерите невалидното поле и да поправите структурата или стойността на заявката.

Актуализирано

Прочетете отговор 422

Threetone връща 422 Unprocessable Entity, когато FastAPI не може да провери входа на заявката. Отговорът съдържа масив detail. Всеки елемент има:

  • loc: къде е открита невалидната стойност, например body, query или path, следвано от името на полето.
  • msg: обяснение, разбираемо за човек.
  • type: правилото за проверка, което е нарушено.

Започнете с loc. То показва частта от заявката, която трябва да се промени.

Поправете заявката

Преди да изпратите отново, проверете:

  1. Методът HTTP и пътят /v1/... съответстват на операцията.
  2. JSON заявките включват Content-Type: application/json и валиден JSON.
  3. Задължителните полета присъстват и имената им съвпадат с документацията.
  4. Числата, булевите стойности, масивите и обектите са с очакваните JSON типове.
  5. Стойностите на изброяванията и параметрите на заявката са в позволените стойности и диапазони.

Например крайната точка за списък на агенти приема page_size от 1 до 100. Стойност извън диапазона води до грешка, чийто loc посочва query и page_size.

Не повтаряйте непроменената заявка. Първо поправете посочената стойност, после изпратете нова заявка и запазете нейния X-Request-Id, ако пак се провали.