설명
배열 스키마의 maxItems는 허용할 항목 수의 상한을 나타냅니다. 서비스에서 처리 가능한 크기가 정해져 있다면 그 한도를 문서와 실제 처리 로직에 함께 반영하는 것이 좋습니다.
잠재적 영향
큰 배열을 제한 없이 처리하면 서버 자원 사용량이 늘거나 클라이언트가 응답을 처리하기 어려워질 수 있습니다.
해결 방법
필요한 배열에 서비스 요구사항에 맞는 maxItems를 지정하고 서버에서도 같은 한도를 적용하십시오. 응답 배열은 필요한 경우 페이지네이션으로 나누십시오. 모든 배열에 임의의 상한을 추가할 필요는 없습니다.
예시
예시는 배열의 최대 항목 수를 5개로 정합니다. 이 값은 예시이므로 실제 허용 범위에 맞추십시오.
변경 전
json
{
"components": {
"schemas": {
"GeneralError": {
"properties": {
"message": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
}
변경 후
json
{
"components": {
"schemas": {
"GeneralError": {
"properties": {
"message": {
"type": "array",
"maxItems": 5,
"items": {
"type": "string"
}
}
}
}
}
}
}