이 누리집은 대한민국 공식 전자정부 누리집입니다.
XML
JSON
국립암센터_간암_라이브러리 _환자_음주여부
QuickAISummary
오픈 API 정보
데이터 오류·개선 의견이 있으신가요?
기본 정보
-
OpenAPI 명
국립암센터_간암_라이브러리 _환자_음주여부
-
분류체계
보건 - 보건의료
- 제공기관
-
관리부서명
데이터운영팀
-
관리부서 전화번호
상세 및 제공정보
-
설명
이 데이터는 ‘국립암센터 간암 환자의 음주 여부’ 정보를 제공하는 오픈 API로, 사용자 인증키를 통해 접근 가능하며 센터명, 기준년도, 환자정보, 음주 여부, 인자의 분자/분모 값 등으로 구성되어 있습니다. 음주 습관은 간암 발생 및 진행에 영향을 미치는 주요 요인 중 하나로, 해당 데이터는 환자의 생활습관과 질병 간의 상관관계를 분석하고자 하는 연구 및 임상 연구 설계, 예방 정책 수립 등에 유용하게 활용될 수 있습니다. 간암 환자의 음주 이력과 건강 정보 간의 연관성을 분석하고자 하는 연구자에게 효과적인 자료로 제공됩니다. 아래의 국립암센터 빅데이터 개방포털 URL을 통해서도 신청 및 활용하실 수 있습니다. URL : https://www.bigdata-cancer.kr/ncc/viewOpenApiDetail.do?datasetIdentifier=18040
-
API 유형
REST
-
데이터 포맷
JSON+XML
-
공간범위
-
-
시간범위
-
-
키워드
간암,라이브러리,환자 음주 여부,음주 이력,생활습관,의료 데이터,암 발생 요인,공공 보건 데이터
-
활용신청 수
64
-
등록일
2021-12-14
-
수정일
2025-05-23
이용 조건 및 라이선스 정보
-
비용부과유무
무료
-
이용허락범위
공공저작물 : 출처표시 (제 1유형)
-
심의유형
개발단계 : 자동승인 / 운영단계 : 심의승인
-
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
참고문서
-
국립암센터_간암_집계정보_조회서비스_오픈API활용가이드_(4)환자_음주여부.docx
표준 메타데이터
활용 정보
API 서비스
센터명, 기준년도를 통해 센터명, 나이, 성별 기준년도의 간암 환자 음주정보 현황 조회
API 기본 정보
-
활용승인 절차
개발단계 : 자동승인 / 운영단계 : 심의승인
-
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
-
요청주소
https://apis.data.go.kr/B551172/Liver04/lvAlchbyType
-
서비스 URL
https://apis.data.go.kr/B551172/Liver04
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 인증키 | serviceKey | 100 | 필 | 인증키 | 공공데이터포털에서 발급받은 인증키 |
| 데이터 형식 | type | 4 | 필 | xml, json | 데이터 리턴 형식 기본 값은 xml, 리턴 형식 json 지정 가능 |
| 페이지 수 | pageNo | 4 | 옵 | 1 | 미 입력 시 기본값으로 실행 |
| 한 페이지 결과 수 | numOfRows | 3 | 옵 | 1 | 미 입력 시 기본값으로 실행 |
| 대상 센터 명 | centerNm | 20 | 옵 | 국립암센터 | 대상 센터 명 |
| 연도(시작) | fromYear | 4 | 옵 | 2010 | 조회 기준 시작 연도 |
| 연도(종료) | toYear | 4 | 옵 | 2019 | 조회 기준 종료 연도 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필 | 200 | 결과코드 |
| 결과메세지 | resultMsg | 50 | 필 | NORMAL SERVICE | 결과메시지 |
| 페이지 수 | pageNo | 10 | 필 | 1 | 페이지 번호 |
| 한 페이지 결과 수 | numOfRows | 10 | 필 | 1 | 한 페이지에서 조회한 목록 수 |
| 데이터 총 개수 | totalCount | 10 | 필 | 545 | 총 목록 수 |
| 목록 리스트 | Items | 0-n | 필 | undefined | 목록 리스트 |
| 대상 센터 이름 | centerNm | 20 | 필 | 국립암센터 | 대상 센터 이름 |
| 기준년도 | critYr | 4 | 필 | 2019 | 기준년도 |
| 환자 연령 | ptAge | 11 | 필 | 85 | 환자 연령 |
| 환자 성별 코드 | ptSexCd | 20 | 필 | M | 환자 성별 코드 (M:남성, F:여성) |
| 통계 대상 명 | statsTrgtNm | 200 | 필 | Y | 통계 대상 코드 |
| 건수 분자 값 | ncsNmvl | 20 | 필 | 1 | 통계 대상 건수 분자 값 |
| 전체 건수 분자 값 | wholNcsDnmvl | 20 | 필 | 1 | 전체 대상 건수 분자 값 |
| 환자 수 분자 값 | ptCntNmvl | 20 | 필 | 1 | 환자 수 분자 값 |
| 전체 환자 수 분모 값 | wholPtCntDnmvl | 20 | 필 | 1 | 전체 환자 수 분모 값 |