integer
양의 정수, 음의 정수, 또는 0을 표현할 수 있는 자료형입니다.
반면에 소수점, NaN, 양 또는 음의 무한대를 표현할 수 없습니다.
note
JSON 표준은 정수 타입과 부동소수점 타입을 구분하지 않습니다.
하지만 두 타입을 다르게 인식하는 언어(Java 등)에서의 충돌 방지 및 JSON schema와의 호한성을 위해 해당 문서에서는 두 타입이 구분되어 사용됩니다.
소수점이 있는 숫자를 표현하기 위해서는 double을 사용해 주세요.
Limitations
정수는 범위 제한을 가질 수 있습니다.
이후 등장하는 조건에서 은 해당 정수를 의미합니다.
예를 들어, 5개의 최신 글들을 불러오고 싶을 때 GET /posts?limit=5
를 사용할 수 있습니다.
하지만 limit
쿼리의 범위 제한이 으로 설정되어 있다면, -5
개의 글을 불러올 수는 없습니다.
범위 제한은 주로 각 API별 Request 문단의 Limit 칼럼에 다음과 같이 명시됩니다.
상황 | 범위 | 표현 방식 | 예시 |
---|---|---|---|
아무 제약이 없는 경우 | (생략 가능) | ||
값이 정해져 있는 경우 | |||
특정 값보다 큰 값이 주어져야 하는 경우 | |||
특정 값보다 크거나 같은 값이 주어져야 하는 경우 | |||
특정 값보다 작은 값이 주어져야 하는 경우 | |||
특정 값보다 작거나 같은 값이 주어져야 하는 경우 |