오픈API 상세
국립암센터_간암 병기 조사 정보제공 서비스
국립암센터 중앙암등록본부에서 제공하는 간암병기조사의 결과 데이터입니다. 이 데이터는 국립암센터 간암 환자의 병기 조사 정보를 제공하는 서비스입니다. 간암의 병기 분류(예: TNM 병기, BCLC 병기 등)와 관련된 환자별 진단 정보가 포함되어 있으며, 환자의 암 진행 상태 평가와 치료 계획 수립에 활용됩니다. 본 데이터는 간암 병기별 환자 분포 분석, 예후 예측, 치료 효과 평가 및 임상 연구에 유용합니다.
해당 데이터는 중앙암등록본부 자료제공홈페이지를 통해서도 신청 및 사용하실 수 있습니다.
*자료제공홈페이지: https://kccrsurvey.cancer.go.kr/index.do
다른 사용자들이 활용한 데이터
로그인하셔서 다른 사용자들이 활용한 데이터를 추천받아 보세요
| 분류체계 | 보건 - 보건의료 | 제공기관 | 국립암센터 |
|---|---|---|---|
| 관리부서명 | 중앙암등록본부 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | JSON+XML |
| 활용신청 | 63 | 키워드 | 암정보,간암,병기,환자통계,진단,건강 빅데이터,의료 데이터,공공 보건 데이터 |
| 등록일 | 2019-12-30 | 수정일 | 2025-05-29 |
| 비용부과유무 | 무료 | 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | ||
| 공간범위 | 시간범위 | ||
| 이용허락범위 |
공공저작물_출처표시
|
||
| 참고문서 | 국립암센터_OpenAPI활용가이드_간암병기조사정보제공서비스.hwp | ||
상세기능
간암 관련 병기 조사에 따른 정보. 제공 되어질 데이터 항목, 타입, 사이즈, 항목별건수, 샘플데이터
- 활용승인 절차 개발단계 : 자동승인 / 운영단계 : 자동승인
- 신청가능 트래픽 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
- 요청주소 http://apis.data.go.kr/B551172/LiverCancerCoperationInfoService1/getLiverCancerCoperationInfo1
- 서비스URL http://apis.data.go.kr/B551172/LiverCancerCoperationInfoService1
요청변수(Request Parameter)
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 인증키 | serviceKey | 4 | 필 | 인증키 (URL Encode) | 공공데이터포털에서 받은 인증키 |
| 목록 건수 | numOfRows | 4 | 옵 | 10 | 목록 건수 (최대 값 : 1000) |
| 페이지 번호 | pageNo | 4 | 옵 | 1 | 페이지 번호 |
출력결과(Response Element)
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필 | 0 | 00:성공 |
| 결과메시지 | resultMsg | 10 | 필 | NORMAL SERVICE | 결과메시지 |
| Ascites | ASCITES | VARCHAR(1) | 옵 | 0 | 0.none1.mild2.moderatetosevere |
| PT time (sec) | PT | NUMERIC(2,1) | 옵 | 12.9 | x.x |
| PerformanceStatus | PERFORMANCE | VARCHAR(1) | 옵 | 1 | 0.무증상,사회생활의제한없음1.경한증상,육체활동의제약이있으나보행가능,가벼운가사나앉아서하는사무가능2.보행및기본적인일상생활은가능하나간혹도움이필요,하루중50%이상휴식필요3.기본적인일상생활에제약이있으므로자주도움이필요,하루중50%이상누워있음4.기본적인일상생활이안되므로항상도움이필요,하루종일누워있어야함9.불명 |
| 폐전이 | I_M11 | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 |
| 원격림프절 | I_M13 | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 |
| 뼈전이 | I_M12 | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 |
| 담관침윤(B) | H_B | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 9. 불명 |
| 기타전이 | I_M14 | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 |
| 알코올 | ALCOHOL | VARCHAR(1) | 옵 | 0 | 0.없음 1. 있음 9. 모름 |
| Encephalopathy | ENCEP | VARCHAR(1) | 옵 | 0 | 0.병력없음1.병력있음(Confusion)2.병력있음(StupororComa) |
| 기타전이 상세부위 | I_M14_ETC | VARCHAR(100) | 옵 | null | i_m14가'1'인경우기타전이상세부위 |
| N인자 | H_N | VARCHAR(1) | 옵 | null | 0.N0 1. N1 9. 불명 |
| M인자 | H_M | VARCHAR(1) | 옵 | null | 0. M0 1. M1 9. 불명 |
| PIVKA II (mAU/mL) | PIVKA | NUMERIC(8, 0) | 옵 | 1047 | x.x |
| 종양개수_5개 이상 | H_T_CASE1 | NUMERIC(2, 0) | 옵 | null | 종양개수가'5개이상'일경우구체적인개수명시*모를경우는공란 |
| 체중 (kg) | WEIGHT | VARCHAR(6) | 옵 | 65.7 | 체중 |
| 조직진단명 | H_NAME | VARCHAR(1) | 옵 | 1 | 1.HCC2.CombinedHCCandCCC3.기타 |
| 간동맥침윤(Va) | H_VA | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 9. 불명 |
| Sodium (mmol/L) | SODIUM | NUMERIC(2,1) | 옵 | 141 | x.x |
| 기타 HCV genotype | HCV_G_T | VARCHAR(20) | 옵 | null | HCV_G가 '4. 기타'인 경우 기타 genotype 기재 |
| Platelet (x103/uL) | PLATELET | NUMERIC(2,1) | 옵 | 197 | x.x |
| 임상적 TNM | I_TNM | VARCHAR(6) | 옵 | T3N0M0 | T1N0M0,T2N0M1등 |
| HDL 콜레스테롤 | HDLCOL | NUMERIC(6,3) | 옵 | 41 | (mg/dl) |
| Bilirubin (mg/dl) | BILIRUBIN | NUMERIC(2,1) | 옵 | 2.5 | x.x |
| 문맥침윤(Vp) | H_VP | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 9. 불명 |
| ICG R15 | ICG_R15 | NUMERIC(6,3) | 옵 | null | ICG(indocyaninegreen)검사중R15(15분정체율)단위:% |
| MELD score | MELD | NUMERIC(4,0) | 옵 | 11 | MELDscore={0.957*ln(serumcreatinine)+0.378*ln(serumbilirubin)+1.12*ln(INR)+0.643}*10-999:산출불가 |
| 간정맥침윤(Vv) | H_VV | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 9. 불명 |
| 총 콜레스테롤 | TOTALCOL | NUMBER(6,3) | 옵 | 179 | (mg/dl) |
| 간동맥침윤(Va) | I_VA | VARCHAR(1) | 옵 | 0 | 0.없음 1. 있음 9. 불명 |
| 둘째 치료명 | TX2_NAME | VARCHAR(2) | 옵 | 4c | 1.surgicalresection 2.livertransplantation 3.localablationtherapy 3a.Radiofrequencyablation(RFA) 3b.Alcoholinjection 3c.Otherlocalablation 4.transarterialtherapy 4a.Transarterialchemoembolization(TACE)withgelatinsponge 4b.TACEwithbeads(DCBorHepasphere) 4c |
| BCLC stage | I_BCLC | NVARCHAR(20) | 옵 | Stage C | Stage 0, A, B, C, D, BCLC 불가 |
| 성별 | SEX | CHAR(1) | 옵 | 1 | 성별 |
| CT 진단연월 | CT_DATE | DATE | 옵 | null | CT 진단연월 |
| 흡연량 | SMOK_PACK | NUMBER(4,3) | 옵 | 1 | 하루 흡연량 |
| 문맥침윤(Vp) | I_VP | VARCHAR(1) | 옵 | 0 | 0.없음 1. 있음 9. 불명 |
| 간정맥침윤(Vv) | I_VV | VARCHAR(1) | 옵 | 0 | 0.없음 1. 있음 9. 불명 |
| Albumin (g/dl) | ALBUMIN | NUMBER(2,1) | 옵 | 4 | x.x |
| 처음 치료명 | TX1_NAME | VARCHAR(1) | 옵 | 4a | 1.surgicalresection 2.livertransplantation 3.localablationtherapy 3a.Radiofrequencyablation(RFA) 3b.Alcoholinjection 3c.Otherlocalablation 4.transarterialtherapy 4a.Transarterialchemoembolization(TACE)withgelatinsponge 4b.TACEwithbeads(DCBorHepasphere) 4c |
| 기타 | CAUSE_ETC | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 |
| 협력병기 조사사업을 위해 부여한 번호 | SERIAL | VARCHAR(9) | 옵 | C08600001 | 협력병기 조사사업을 위해 부여한 번호 |
| 종양개수 | H_T_CASE | VARCHAR(1) | 옵 | null | 1.1개 2.2개 3.3개 4.4개 5.5개이상 |
| 기타_상세원인 | CAUSE_ETC1 | NVARCHAR(100) | 옵 | null | 간암의 원인 '기타'인 경우 상세원인을 입력 |
| 흡연기간 | SMOK_YEAR | NUMBER(2, 0) | 옵 | 40 | 흡연기간 (년단위) |
| 종양최대직경(cm) | I_MAXSIZE | NUMBER(4,2) | 옵 | 2 | 기록에 명시된 종양최대직경 입력 |
| 조직학적 진단연월 | H_DATE | DATE | 옵 | 200811 | 조직생검혹은수술시행연월 *조직검사와수술모두시행시더빠른시점기재 |
| HBV DNA 양성여부 | HBV_D | VARCHAR(1) | 옵 | null | 0.음성 1. 양성 9. 검사결과없음 |
| B형간염 항바이러스제 치료여부 | B_C1 | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 9. 모름 |
| 경구용 항바이러스제(DAA) 치료여부 | C_C12 | VARCHAR(1) | 옵 | null | 1. 있음 |
| Child-Pugh Classification | CPC | NVARCHAR(4) | 옵 | A | A,B,C,생성불가 |
| Creatinine (mg/dL) | CREATININE | NUMBER(2,1) | 옵 | 1.1 | x.x |
| C형간염 인터페론제제 치료여부 | C_C11 | VARCHAR(1) | 옵 | null | 1. 있음 |
| 처음 치료연월 | TX1_DATE | DATE | 옵 | 200811 | 진단후 처음 치료연월 |
| Child-Pugh Score | CPS | NVARCHAR(4) | 옵 | 6 | 5~15,생성불가 |
| 당뇨 | DM | VARCHAR(1) | 옵 | 0 | 0.없음 1. 있음 |
| ALT (GPT) (IU/mL) | ALT | NUMBER(4, 0) | 옵 | 18 | x.x |
| 고혈압 | HYPERTENSIVE | VARCHAR(1) | 옵 | 1 | 0.없음 1. 있음 |
| 이완기(DBP) | DBP | NUMBER(3, 0) | 옵 | 89 | 이완기혈압 (단위: mmHg) |
| 흡연여부 | SMOK_OX | VARCHAR(1) | 옵 | 1 | 0.없음 1. 있음 |
| 공복시 혈당(Fasting glucose) | GLUCOSE | NUMBER(6,3) | 옵 | 94 | (mg/dl) |
| MELD-Na score | MELDNA | NUMERIC(4, 0) | 옵 | 11 | MELD-NA'score=MELD-Na-0.025*MELD*(140-Na)+140 -999:산출불가 |
| LDL 콜레스테롤 | LDLCOL | NUMBER(6,3) | 옵 | 105 | (mg/dl) |
| HBV DNA titer 단위 | HBV_DT_UNIT | NUMBER(1, 0) | 옵 | null | 1.IU/ml 2. copies/ml |
| 임상적 stage | I_TNM_STAGE | NVARCHAR(20) | 옵 | Stage III | Stage I, II, III, IV-A, IV-B, TNM 불가 |
| 사망연월 | EXPIRE | DATE | 옵 | 201310 | 통계청, 안행부, 공단, 등록병원으로부터의 사망연월 정보 |
| 종양개수 | I_T_CASE | VARCHAR(1) | 옵 | 2 | 1.1개 2.2개 3.3개 4.4개 5.5개이상 |
| 종양최대직경( >10cm 이상) | I_MAXSIZE1 | VARCHAR(1) | 옵 | null | 0.10cm이하 1. 10cm 초과 |
| MRI 진단여부 | I_METHOD2 | VARCHAR(1) | 옵 | 1 | 1. 있음 |
| CT 진단여부 | I_METHOD1 | VARCHAR(1) | 옵 | 0 | 1. 있음 |
| 둘째 치료연월 | TX2_DATE | DATE | 옵 | 200907 | 진단후 둘째 치료연월 |
| MRI 진단연월 | MRI_DATE | DATE | 옵 | 200811 | MRI 진단연월 |
| 기타 조직진단명 | H_NAME_ETC | NVARCHAR(100) | 옵 | null | h_name이 '3'인 경우의 기타 조직진단명 |
| 종양최대직경(cm) | H_MAXSIZE | NUMERIC(4,1) | 옵 | null | 기록에 명시된 종양최대직경 입력 |
| 종양최대직경_>10cm | H_MAXSIZE1 | VARCHAR(1) | 옵 | null | 0.10cm이하 1. 10cm 초과 |
| HBV DNA titer | HBV_D_T | NUMBER(10, 0) | 옵 | null | HBV DNA titer |
| 조직학적 TNM | H_TNM | VARCHAR(6) | 옵 | T9N0M0 | T1N0M0,T2N0M1등 |
| 미세혈관침범 | MVI | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 |
| 조직학적 stage | H_TNM_STAGE | NVARCHAR(20) | 옵 | TNM 불가 | Stage I, II, III, IV-A, IV-B, TNM 불가 |
| C형간염 (anti-HVC ab) | HEPATITISC | VARCHAR(1) | 옵 | 0 | 0.음성(-) 1. 양성(+) 2. 검사결과 없음 |
| B형간염 (HBsAg) | HEPATITISB | VARCHAR(1) | 옵 | 0 | 0.음성(-) 1. 양성(+) 2. 검사결과 없음 |
| AFP (ng/mL) | AFP | NUMBER(8,2) | 옵 | 72.1 | x.x |
| INR (ratio) | INR | NUMBER(3,2) | 옵 | 1.01 | x.xx |
| 담관침윤(B) | I_B | VARCHAR(1) | 옵 | 0 | 0.없음 1. 있음 9. 불명 |
| HCV genotype | HCV_G | VARCHAR(1) | 옵 | null | 1.GT1b 2. GT 2 3. GT 1(1b외) 4. 기타 9. 검사결과없음 |
| C형간염 항바이러스제 치료여부 | C_C1 | VARCHAR(1) | 옵 | null | 0.없음 1. 있음 9. 모름 |
| M인자 | I_M | VARCHAR(1) | 옵 | 0 | 0.M0 1. M1 9. 불명 |
| HCV RNA 양성여부 | HCV_R | VARCHAR(1) | 옵 | null | 0.음성 1. 양성 9. 검사결과없음 |
| AFP 단위 | AFP1 | VARCHAR(1) | 옵 | 1 | 1.ng/ml 2. IU/ml |
| AFP 측정법 | AFP2 | VARCHAR(1) | 옵 | 9 | 1.RIA 2. CIA 9. 불명 |
| N인자 | I_N | VARCHAR(1) | 옵 | 0 | 0.N0 1. N1 9. 불명 |
| 비B비C간염 | NONBC | VARCHAR(1) | 옵 | 0 | 0.없음 1. 있음 9. 모름 |
| 만 나이 | AGE | NUMERIC(2,0) | 옵 | 98 | 만 나이 |
| 수축기(SBP) | SBP | NUMBER(3, 0) | 옵 | 143 | 수축기혈압 (단위: mmHg) |
| 중성지방(Triglyceride) | TRIGLYCERIDE | NUMBER(6,3) | 옵 | 91 | (mg/dl) |
| B형간염 인터페론제제 치료여부 | B_C17 | VARCHAR(1) | 옵 | null | 1. 있음 |
| 기타 치료여부 | B_C18 | VARCHAR(1) | 옵 | null | 1. 있음 |
| telbivudine 치료여부 | B_C15 | VARCHAR(1) | 옵 | null | 1. 있음 |
| clevudine 치료여부 | B_C16 | VARCHAR(1) | 옵 | null | 1. 있음 |
| PIVKA II 범위 | PIVKA_1 | VARCHAR(1) | 옵 | 1 | 1.실측값 2. 미만 3. 초과 |
| lamivudine 치료여부 | B_C13 | VARCHAR(1) | 옵 | null | 1. 있음 |
| adefovir 치료여부 | B_C14 | VARCHAR(1) | 옵 | null | 1. 있음 |
| entecavir 치료여부 | B_C11 | VARCHAR(1) | 옵 | null | 1. 있음 |
| tenofovir 치료여부 | B_C12 | VARCHAR(1) | 옵 | null | 1. 있음 |
| 종양개수_5개 이상 | I_T_CASE1 | NUMBER(2, 0) | 옵 | null | 종양개수가'5개이상'일경우구체적인개수명시 *모를경우는공란 |
| 키 (cm) | HEIGHT | VARCHAR(5) | 옵 | 180 | 키 |
| HCV RNA titer | HCV_RT | NUMBER(10, 0) | 옵 | null | HCV RNA titer |
| 수술 진단여부 | H_METHOD2 | VARCHAR(1) | 옵 | 0 | 1. 있음 |
| 조직생검 진단여부 | H_METHOD1 | VARCHAR(1) | 옵 | 1 | 1. 있음 |
| 자료등록년도 | dbyear | VARCHAR(4) | 옵 | 2008 | 자료등록년도 |
| PT index (%) | PI | NUMBER(2,0) | 옵 | 98 | xx |
| 원인불명 | UNKNOWN_CAUSE | VARCHAR(1) | 옵 | null | B형간염, C형간염, 알코올, 기타원인이 없는 경우 체크 |
| 간경변증 | CIRRHOSIS | VARCHAR(1) | 옵 | null | 0. 없음 1. 있음 9. 모름 |
| HBV DNA 검사연월 | HBV_DATE | VARCHAR(6) | 옵 | null | HBV DNA 검사연월 |
| HBV DNA titer | HBV_DT | NUMBER(10, 0) | 옵 | null | HBV DNA titer |
| HCV RNA 검사연월 | HCV_DATE | VARCHAR(6) | 옵 | null | HCV RNA 검사연월 |
| AST (GPT) (IU/L) | AST | NUMBER(4, 0) | 옵 | null | x.x |
| 최종내원연월 | LAST_FOLLOWUP | VARCHAR(6) | 옵 | null | 의무기록에서 확인한 환자의 최종내원연월 |
샘플코드
샘플코드는 PC에서 확인해주세요.
다른 사용자들이 활용한 데이터
로그인하셔서 다른 사용자들이 활용한 데이터를 추천받아 보세요
이 데이터와 유사한 데이터