통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.
이 API로 만들 수 있는 것
이 페이지를 프로덕션 요약으로 사용하세요. 엔드포인트, 예제, 응답 구조, DomScan을 제품에 연결하는 워크플로 구성 요소를 제공합니다.
도메인 검사, DNS 인텔리전스, 위험 신호 또는 보강 데이터를 온보딩, 검색, 내부 도구에 포함하세요.
반복적인 수동 조회를 예약 작업, 알림, 재현 가능한 조사 단계로 대체하세요.
제공자 페이지를 스크래핑하지 않고 예측 가능한 필드, 문서화된 상태 코드, 크레딧 비용을 사용하세요.
OpenAPI, SDK, Postman 또는 MCP를 통해 에이전트, 대시보드, SOAR 플레이북, CRM에 데이터를 공급하세요.
통합 워크플로
첫 요청부터 반복 가능한 프로덕션 사용까지의 단순한 경로입니다.
문서화된 헤더로 API 키를 보내고 서비스 전반에서 요청을 일관되게 유지하세요.
curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.
상태 코드, 크레딧 비용, 응답 필드를 사용해 재시도, 로그, 알림을 구축하세요.
개발자 키트
이 페이지에서 기계 판독 문서, 요청 컬렉션, SDK 또는 에이전트 도구로 바로 이동하세요.
매개변수 및 응답 맵
엔드포인트를 클라이언트에 연결하기 전에 입력, 출력 필드, 상태 코드를 확인하세요.
매개변수
예제 응답
HTTP 상태 코드
엔드포인트
/v1/phone/validate
/v1/phone/validate/bulk
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.
curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.
주요 기능
길이만 확인하지 않고 완전한 번호 체계 메타데이터를 기준으로 길이와 숫자 패턴을 확인합니다.
파싱된 내선번호를 포함해 E.164, 국제, 국내, RFC 3966 형식을 반환합니다.
길이가 타당한 번호와 번호 체계에서 인식하는 범위의 번호를 구분합니다.
메타데이터가 제공하는 경우 번호 유형, 번호 체계상 위치, 가능한 시간대, 최초 번호 대역 통신사 및 번호 이동 지원 여부를 식별합니다.
국가를 지정해 국내 번호를 파싱하고, 발신 위치에 맞는 형식을 생성하며, 지역 단축 번호와 긴급 전화번호를 인식합니다.
요청당 최대 100개의 번호를 검증하고 각 입력에 대한 개별 결과를 반환합니다.
DomScan 인프라에서 오프라인 메타데이터와 규제 기관 공개 스냅샷을 사용합니다. 일치하는 결과에는 출처, 라이선스, 업데이트 날짜 및 최초 할당 정보가 포함됩니다.
예제 요청
curl -X POST https://domscan.net/v1/phone/validate \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"+34 612 345 678","expected_country":"ES","dialing_from_country":"US","language":"en"}'
예제 응답
{
"input": "+34 612 345 678",
"normalized_input": "+34 612 345 678",
"kind": "phone_number",
"valid": true,
"possible": true,
"status": "valid",
"recommendation": "accept",
"validation_level": "numbering_plan",
"reason": null,
"warnings": [],
"number": {
"e164": "+34612345678",
"international": "+34 612 34 56 78",
"national": "612 34 56 78",
"rfc3966": "tel:+34612345678",
"national_number": "612345678",
"extension": null,
"country": "ES",
"country_name": "Spain",
"country_calling_code": "34",
"possible_countries": ["ES"],
"country_match": true,
"type": "mobile",
"non_geographic": false
},
"intelligence": {
"status": "available",
"kind": "phone_number",
"coverage": {
"country": "ES",
"level": "official_allocation_match",
"global_numbering_metadata": true,
"official_snapshot_available": true,
"official_allocation_match": true,
"official_source_ids": ["cnmc"],
"matching_source_ids": ["cnmc"],
"current_carrier_lookup": false
},
"location": {
"country_name": "Spain",
"country": "ES",
"granularity": "country",
"current_physical_location": false
},
"possible_time_zones": {
"values": ["Europe/Madrid"],
"current_location": false,
"inference": "number_prefix"
},
"original_prefix_carrier": {
"name": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
"source_id": "cnmc",
"evidence": "official_allocation_record",
"current_carrier": false,
"portability_may_change_carrier": true
},
"portability": {
"region_supported": true,
"current_port_checked": false
},
"dialing": {
"from_country": "US",
"international": "011 34 612 34 56 78",
"internationally_diallable": true
},
"regulator_allocations": [{
"authority": "CNMC",
"category": "mobile",
"status": "assigned",
"original_assignee": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
"assigned_on": "2023-11-03",
"current_operator": false,
"individual_number_assignment_checked": false
}],
"sources": [{
"id": "google_libphonenumber",
"name": "Google libphonenumber metadata",
"license": "Apache-2.0"
}, {
"id": "cnmc",
"name": "Comisión Nacional de los Mercados y la Competencia (CNMC)",
"type": "official_regulator_snapshot"
}]
},
"live_checks": {
"assignment": "not_checked",
"reachability": "not_checked",
"current_carrier": "not_checked",
"subscriber_identity": "not_checked",
"porting": "not_checked"
},
"privacy": {
"upstream_requests": 0,
"telecom_provider_queried": false,
"persisted": false,
"domscan_edge_relay_used": true,
"third_party_requests": 0
},
"limitations": [
"NUMBERING_PLAN_ONLY",
"DOES_NOT_PROVE_ASSIGNMENT",
"NO_LIVE_TELECOM_CHECKS"
],
"credits_used": 1
}
자주 묻는 질문
유효하다는 것은 번호가 인식된 번호 체계 범위의 문서화된 길이와 숫자 패턴에 일치한다는 뜻입니다. 번호가 가입자에게 할당되었다는 의미는 아닙니다.
아니요. 번호 체계 검증으로는 번호의 할당, 활성, 연결 가능 여부나 전화 또는 SMS 수신 가능 여부를 확인할 수 없습니다.
API는 최초 번호 대역 통신사나 규제 기관 할당 보유자를 반환할 수 있습니다. 두 필드 모두 번호 이동 이후의 현재 통신사를 나타내지 않으며, 가입자나 전화번호 소유자를 식별하지 않습니다.
네. 번호가 국제 국가번호로 시작하지 않으면 기본 국가 또는 지역을 지정하세요. 지역 단축 번호와 긴급 전화번호를 해석할 때도 국가가 필요합니다.
글로벌 메타데이터는 Google libphonenumber에서 제공됩니다. 공식 번호 대역 및 접두 번호 근거에는 CNMC, ARCEP, Bundesnetzagentur, 일본의 MIC, 오스트리아의 RTR, Nkom, 폴란드의 UKE, 대만의 MODA, 미국의 NANPA, 캐나다의 CNA/CNAC가 공개한 스냅샷도 사용될 수 있습니다. 미국과 캐나다 기록은 NPA-NXX 중앙국 코드 상태와 최초 코드 보유자를 나타내며, 번호 이동이 완료된 번호의 현재 통신사를 나타내지 않습니다. 각 결과에는 출처, 스냅샷 날짜 및 커버리지 수준이 표시됩니다. 위치와 시간대는 전화기의 현재 위치가 아니라 번호 체계 접두 번호를 설명합니다.
네. 일괄 엔드포인트는 최대 100개의 번호를 받아 입력 순서대로 결과를 반환합니다. 오프라인 보강 기능을 사용할 수 없어도 로컬 검증은 완료되며 intelligence.status에 대체 처리 상태가 표시됩니다.
관련 도구 및 리소스
HTTP 상태 코드
성공 응답, 인증 문제, 크레딧 부족, 속도 제한, 누락된 데이터, 업스트림 장애를 구분할 수 있도록 클라이언트에서 처리해야 할 HTTP 상태 코드를 문서화했습니다.
요청 성공
잘못된 매개변수
API 키 또는 세션이 없거나 유효하지 않습니다.
이 요청을 실행할 크레딧이 부족합니다.
속도 제한 초과
내부 오류
상위 RDAP 오류
업스트림 서비스를 사용할 수 없거나 일시적으로 속도 제한 중입니다.
업스트림 조회가 시간 초과되었습니다.
전화번호 인텔리전스 무료 사용