Skip to main content

integer

양의 정수, 음의 정수, 또는 0을 표현할 수 있는 자료형입니다.

반면에 소수점, NaN, 양 또는 음의 무한대를 표현할 수 없습니다.

note

JSON 표준은 정수 타입과 부동소수점 타입을 구분하지 않습니다.

하지만 두 타입을 다르게 인식하는 언어(Java 등)에서의 충돌 방지 및 JSON schema와의 호한성을 위해 해당 문서에서는 두 타입이 구분되어 사용됩니다.

소수점이 있는 숫자를 표현하기 위해서는 double을 사용해 주세요.

Limitations

정수는 범위 제한을 가질 수 있습니다.

이후 등장하는 조건에서 nn은 해당 정수를 의미합니다.

예를 들어, 5개의 최신 글들을 불러오고 싶을 때 GET /posts?limit=5를 사용할 수 있습니다.

하지만 limit 쿼리의 범위 제한이 0n0\leq n 으로 설정되어 있다면, -5개의 글을 불러올 수는 없습니다.

범위 제한은 주로 각 API별 Request 문단의 Limit 칼럼에 다음과 같이 명시됩니다.

상황범위표현 방식예시
아무 제약이 없는 경우(,+)\left(-\infty,+\infty\right)nn (생략 가능)nn
값이 정해져 있는 경우[a,a]\left[a,a\right]n=an=an=3n=3
특정 값보다 큰 값이 주어져야 하는 경우(a,+)\left(a,+\infty\right)a<na<n0<n0<n
특정 값보다 크거나 같은 값이 주어져야 하는 경우[a,+)\left[a,+\infty\right)ana\leq n5n5\leq n
특정 값보다 작은 값이 주어져야 하는 경우(,b)\left(-\infty,b\right)n<bn<bn<10n<10
특정 값보다 작거나 같은 값이 주어져야 하는 경우(,b]\left(-\infty,b\right]nbn\leq bn1024n\leq 1024