아동·청소년 인구 동향 오픈 API API

#아동#청소년#동향

업데이트 : 2026-05-12

연도별 아동·청소년 인구, 가구 유형별 통계를 REST로 제공합니다. 교육·복지 정책 수립을 위한 기초 자료로 활용됩니다.

Endpoint

데모 버전	https://development.fitples.example/v1/open/open-child-stats-1
정식 버전	https://api.fitples.example/v1/open/open-child-stats-1

Timeout

300

입력부(Input)

Key	Name	Type	Required	Description
organization	기관코드	String	O	연계 기관 식별 코드 (목업: 0001)
apiKey	API Key	String	O	발급받은 Bearer 토큰 또는 쿼리 파라미터
regionCode	지역코드	String	△	시·도 또는 시·군·구 코드 (선택)
page	페이지	Number	△	페이지 번호 (기본 1)
size	페이지크기	Number	△	1회 조회 건수 (기본 20, 최대 100)

입력부

{
  "organization": "0001",
  "apiKey": "fp_test_****************",
  "regionCode": "11",
  "page": 1,
  "size": 20
}

입력부 특이사항

· 본 문서는 Fitples 카탈로그용 목업입니다. · 실제 인증·동의·암호화 방식은 정식 오픈 시 별도 가이드로 제공됩니다.

출력부(Output)

단건의 경우 객체형, 다건의 경우 리스트형으로 반환됩니다. (목업 예시)

Key	Name	Type	Required	Description
resultCode	결과코드	String	O	CF-0000 성공 기준 (목업)
data	응답 본문	Object	O	조회 결과 객체
res_open-child-stats-1_0	연도	String	O	[인구] 항목
res_open-child-stats-1_1	연령군	String	O	[인구] 항목
res_open-child-stats-1_2	인구수	String	△	[인구] 항목
res_open-child-stats-1_3	성별	String	△	[인구] 항목
res_open-child-stats-1_4	1인가구	String	△	[가구유형] 항목
res_open-child-stats-1_5	맞벌이	String	△	[가구유형] 항목
meta	메타	Object	O	요청 ID, 캐시 여부 등
requestId	요청 ID	String	O	추적용 UUID

출력부

{
  "resultCode": "CF-0000",
  "data": {
    "items": [
      {
        "id": "ROW-1",
        "label": "연도",
        "group": "인구",
        "value": "***"
      },
      {
        "id": "ROW-2",
        "label": "연령군",
        "group": "인구",
        "value": "***"
      },
      {
        "id": "ROW-3",
        "label": "인구수",
        "group": "인구",
        "value": "***"
      },
      {
        "id": "ROW-4",
        "label": "성별",
        "group": "인구",
        "value": "***"
      }
    ],
    "totalCount": 128
  },
  "meta": {
    "requestId": "req_mock_7c21",
    "cached": false
  }
}

출력부 특이사항

· 단건은 객체, 목록은 배열 형태로 반환되는 것을 가정한 예시입니다. · 필드명·타입은 실제 스키마와 다를 수 있습니다.