설명
OpenAPI 2.0의 in: body 매개변수에는 요청 본문의 타입과 구조를 정의하는 schema가 필요합니다. 이 필드가 없으면 본문 형식이 명확하게 정의되지 않습니다.
잠재적 영향
클라이언트가 잘못된 본문을 보내거나 코드 생성 및 명세 검증에 실패할 수 있습니다.
해결 방법
실제 요청 본문에 맞는 schema를 추가하세요. 타입과 필요한 필드를 정의하고, 공통 모델은 재사용 가능한 정의를 참조할 수 있습니다.
예시
다음 매개변수 예시는 정수 본문을 나타내는 schema를 추가합니다.
변경 전
json
{
"name": "limit",
"in": "body",
"description": "max records to return",
"required": true
}
변경 후
json
{
"name": "limit",
"in": "body",
"description": "max records to return",
"required": true,
"schema": {
"type": "integer"
}
}