전화번호의 형식 유효성을 검사합니다. search_hlr=true 시 통신망(HLR) 조회로 실제 개통·활성 회선 여부도 확인합니다.
단순 형식 검증뿐만 아니라, search_hlr=true 옵션으로 통신망(HLR) 조회를 수행하면 해당 번호가 실제로 개통된 활성 회선인지 확인할 수 있습니다. 이동통신사 망 조회를 기반으로 결번, 미개통, 실제 개통 여부를 판별하여 반환합니다. HLR 서비스는 대량 이용 시 사전 문의가 필요합니다.
search_hlr=true)
curl -k -X POST "https://apick.app/rest/check_phone_valid" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "number=01012341234"
curl -k -X POST "https://apick.app/rest/check_phone_valid" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "number=01012341234" \
-F "search_hlr=true"
{
"data": {
"국제번호": "+821012341234",
"지역번호": "010-1234-1234",
"유효성": true,
"국가": "South Korea",
"지역": "South Korea",
"국가코드": "KR",
"모바일여부": true,
"회선유형": "mobile",
"hlr": {
"활성회선여부": true,
"개통상태": "개통",
"상태코드": "ok",
"HLR유효": true,
"번호유효": true,
"모바일여부": true,
"번호이동여부": false,
"로밍여부": false,
"현재통신사": "KT",
"원통신사": "KT",
"이동통신사": null,
"회선유형": "mobile",
"위치": "South Korea",
"국가": "South Korea",
"국가코드": "KR",
"국제번호": "+821012341234",
"지역번호": "010-1234-1234"
},
"success": 1
},
"api": {
"success": true,
"cost": 30,
"ms": 1820,
"pl_id": 409
}
}