요청 검증 오류 해결하기

422 응답 읽기

FastAPI가 요청 입력을 검증할 수 없으면 Threetone은 422 Unprocessable Entity를 반환합니다. 응답에는 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를 보관하세요.