어린이집·육아 종합서비스 연계 API API

#어린이집#보육#연계

업데이트 : 2026-05-12

보육시설 현황, 대기자 정보, 이용 가능 서비스 등을 통합 조회합니다. 민간 앱·지자체 포털과 연동하기 위한 표준 엔드포인트입니다.

Endpoint

데모 버전	https://development.fitples.example/v1/welfare/childcare-svc-1
정식 버전	https://api.fitples.example/v1/welfare/childcare-svc-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_childcare-svc-1_0	시설명	String	O	[시설] 항목
res_childcare-svc-1_1	정원	String	O	[시설] 항목
res_childcare-svc-1_2	현원	String	△	[시설] 항목
res_childcare-svc-1_3	대기인원	String	△	[시설] 항목
res_childcare-svc-1_4	운영시간	String	△	[시설] 항목
res_childcare-svc-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
  }
}

출력부 특이사항

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