IPQS 사기 및 위험 점수 매기기
IPQS(IPQualityScore)는 엔터프라이즈급 사기 방지, 위험 분석 및 위협 탐지를 제공합니다. IP 주소, 전화 번호, 전자 메일 주소, URL 또는 도메인을 분석하여 정교한 잘못된 행위자와 높은 위험 동작을 식별합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | IPQS 지원 |
| URL | https://www.ipqualityscore.com/contact-us |
| 전자 메일 | Support@IPQualityScore.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | IPQualityScore |
| 웹 사이트 | https://www.ipqualityscore.com/ |
| 개인 정보 보호 정책 | https://www.ipqualityscore.com/privacy-policy |
| 카테고리 | 안전; 웹 사이트 |
IPQS(IPQualityScore)는 엔터프라이즈급 사기 방지, 위험 분석 및 위협 탐지를 제공합니다. IP 주소, 전화 번호, 전자 메일 주소, URL 또는 도메인을 분석하여 전 세계적으로 정교한 악의적 행위자와 높은 위험 동작을 식별합니다.
Pre-requisites
계속하려면 다음이 필요합니다.
- 사용자 지정 커넥터 기능이 있는 Microsoft Power Apps 또는 Power Automate 계획
- Azure 구독
- IPQualityScore API 키
지원되는 작업
커넥터는 다음 작업을 지원합니다.
Retrieve IP address reputation data: 이 서비스는 실시간 조회를 수행하여 IP 주소 및 선택적 디바이스 정보를 기반으로 사용자, 클릭 또는 트랜잭션이 얼마나 위험한지 즉시 확인합니다. IP 주소가 프록시 또는 VPN인지 분석하는 것 외에도 API는 다음과 같은 20개 이상의 관련 데이터 요소를 반환합니다.- 지리적 위치 데이터
- ISP
- 연결 유형
- 디바이스 세부 정보
- 최근 평판 활동
- 전체 사기 점수
- 프록시, VPN 또는 TOR 연결 상태
- 남용 속도
- 평판과 위험을 분류하는 다른 유사한 데이터 요소
Retrieve Email address reputation data: 이 API는 수백 개의 구문 및 DNS 검사를 사용하여 실시간 이메일 주소 평판 점수 매기기 및 유효성 검사를 제공합니다. API를 활용하여 메일 서비스 공급자에 전자 메일 주소 받은 편지함이 있고 새 메시지를 수락할 수 있는지 확인할 수 있습니다. 또한 사용자는 이메일 주소의 평판이 좋지 않거나 최근에 남용 또는 위협과 관련이 있는지 확인할 수 있습니다. 추가 위험 점수 매기기에서는 온라인 사기 행위 기록이 있는 전자 메일뿐만 아니라 삭제 가능한 임시 메일 서비스도 검색할 수 있습니다.Retrieve URL (or) Domain reputation data.: 신뢰할 수 있는 기계 학습 모델을 사용하여 의심스러운 URL을 검색하기 위해 실시간으로 링크 및 도메인을 검색합니다. 이러한 기계 학습 모델은 피싱 링크, 맬웨어 URL, 바이러스, 주차된 도메인 및 실시간 위험 점수가 있는 의심스러운 URL을 정확하게 식별할 수 있습니다. 또한 기계 학습 모델은 실시간 API 통합을 통해 평판이 좋지 않은 도메인, 의심스러운 링크 및 피싱 URL을 자신 있게 분류할 수 있습니다. 주차 도메인 검색, 도메인 스팸 점수, 평판 검사 및 도메인 연령과 같은 기능은 URL 인텔리전스를 완전히 새로운 수준으로 높입니다.Retrieve Phone Number reputation data: 전 세계 전화 번호를 정확하게 확인하고 위험 분석 데이터를 사용하여 통신 사업자 및 회선 유형 세부 정보의 조합을 검색하여 전화 번호 평판을 평가합니다. IPQS는 모든 지역에 대한 지원을 통해 다양한 통신 사업자 및 계층 1 통신 공급자로부터 전화 유효성 검사 및 확인 데이터를 수집합니다. HLR 및 LRN 조회와 유사한 쉬운 사용자 유효성 검사를 위해 비활성 및 연결이 끊긴 전화 번호를 검색합니다. 온라인에서 악의적인 행동과 관련된 번호와 함께 가상 및 일회용 전화 번호를 정확하게 식별합니다.
API 키 액세스
IPQualityScore.com 무료 API 키를 등록하거나 계정 관리자에게 문의하여 기존 API 키에 액세스합니다.
지원 및 설명서:
모든 지원 요청 및 일반 쿼리에 대해 문의 Support@IPQualityScore.com 하거나 문의할 수 있습니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| IPQualityScore API 키 | 시큐어스트링 (보안 문자열) | 이 API에 대한 IPQualityScore API 키 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| IP 주소 평판 데이터 검색 |
이 서비스는 실시간 조회를 수행하여 IP 주소 및 선택적 디바이스 정보를 기반으로 사용자, 클릭 또는 트랜잭션이 얼마나 위험한지 즉시 확인합니다. IP 주소가 프록시 또는 VPN인지 분석하는 것 외에도 API는 지리적 위치 데이터, ISP, 연결 유형, 디바이스 세부 정보, 최근 평판 활동, 전반적인 사기 점수, 프록시로서의 상태, VPN 또는 TOR 연결 상태, 남용 속도, 기타 유사한 데이터 요소와 같은 20개 이상의 관련 데이터 요소를 반환하여 평판과 위험을 분류합니다. |
| URL(또는) 도메인 평판 데이터 검색 |
링크 및 도메인을 실시간으로 검사하여 신뢰할 수 있는 기계 학습 모델을 사용하여 의심스러운 URL을 검색합니다. 이러한 기계 학습 모델은 피싱 링크, 맬웨어 URL, 바이러스, 주차된 도메인 및 실시간 위험 점수가 있는 의심스러운 URL을 정확하게 식별할 수 있습니다. 또한 기계 학습 모델은 실시간 API 통합을 통해 평판이 좋지 않은 도메인, 의심스러운 링크 및 피싱 URL을 자신 있게 분류할 수 있습니다. 주차 도메인 검색, 도메인 스팸 점수, 평판 검사 및 도메인 연령과 같은 기능은 URL 인텔리전스를 완전히 새로운 수준으로 높입니다. |
| 전자 메일 주소 평판 데이터 검색 |
이 API는 수백 개의 구문 및 DNS 검사를 사용하여 실시간 이메일 주소 평판 점수 매기기 및 유효성 검사를 제공합니다. API를 활용하여 메일 서비스 공급자에 전자 메일 주소 받은 편지함이 있고 새 메시지를 수락할 수 있는지 확인할 수 있습니다. 또한 사용자는 이메일 주소의 평판이 좋지 않거나 최근에 남용 또는 위협과 관련이 있는지 확인할 수 있습니다. 추가 위험 점수 매기기에서는 온라인 사기 행위 기록이 있는 전자 메일뿐만 아니라 삭제 가능한 임시 메일 서비스도 검색할 수 있습니다. |
| 전화 번호 평판 데이터 검색 |
전 세계 전화 번호를 정확하게 확인하고 위험 분석 데이터를 사용하여 통신 사업자 및 회선 유형 세부 정보의 조합을 검색하여 전화 번호 평판을 평가합니다. IPQS는 모든 지역에 대한 지원을 통해 다양한 통신 사업자 및 계층 1 통신 공급자로부터 전화 유효성 검사 및 확인 데이터를 수집합니다. HLR 및 LRN 조회와 유사한 쉬운 사용자 유효성 검사를 위해 비활성 및 연결이 끊긴 전화 번호를 검색합니다. 온라인에서 악의적인 행동과 관련된 번호와 함께 가상 및 일회용 전화 번호를 정확하게 식별합니다. |
IP 주소 평판 데이터 검색
이 서비스는 실시간 조회를 수행하여 IP 주소 및 선택적 디바이스 정보를 기반으로 사용자, 클릭 또는 트랜잭션이 얼마나 위험한지 즉시 확인합니다. IP 주소가 프록시 또는 VPN인지 분석하는 것 외에도 API는 지리적 위치 데이터, ISP, 연결 유형, 디바이스 세부 정보, 최근 평판 활동, 전반적인 사기 점수, 프록시로서의 상태, VPN 또는 TOR 연결 상태, 남용 속도, 기타 유사한 데이터 요소와 같은 20개 이상의 관련 데이터 요소를 반환하여 평판과 위험을 분류합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
IP address
|
ip | True | string |
평판 데이터를 가져오려는 IP 주소입니다. |
|
엄격성
|
strictness | True | integer |
이 쿼리는 얼마나 심층(엄격)하게 하시겠습니까? 값이 높을수록 처리하는 데 시간이 오래 걸리며 가양성 비율이 높을 수 있습니다. 가장 낮은 엄격도 설정인 "0"에서 시작하여 사기 수준에 따라 "1" 또는 "2"로 늘리는 것이 좋습니다. |
|
사용자 에이전트
|
user_agent | string |
필요에 따라 사용자 에이전트 문자열(브라우저)을 제공할 수 있습니다. 이를 통해 추가 검사를 실행하여 사용자가 봇인지 아니면 잘못된 브라우저를 실행하고 있는지 확인할 수 있습니다. 이를 통해 "fraud_score"에서 판단되는 사용자의 위험을 평가할 수 있습니다. |
|
|
사용자 언어
|
user_language | string |
필요에 따라 사용자의 언어 헤더를 제공할 수 있습니다. 이를 통해 "fraud_score"에서 판단되는 사용자의 위험을 평가할 수 있습니다. |
|
|
빠름
|
fast | boolean |
이 매개 변수를 사용하도록 설정하면 API는 처리하는 데 더 오래 걸리는 특정 포렌식 검사를 수행하지 않습니다. 이 기능을 사용하도록 설정하면 정확도에 큰 영향을 주지 않고 API 속도가 크게 향상됩니다. 이 옵션은 시간에 민감한 방식으로 의사 결정을 내려야 하며 모든 엄격성 수준에서 사용할 수 있는 서비스를 위한 것입니다. |
|
|
휴대폰
|
mobile | boolean |
필요에 따라 이 조회를 모바일 디바이스로 처리해야 한다고 지정할 수 있습니다. 요청에 연결된 사용자 에이전트가 없는 모바일 조회에 권장됩니다. NOTE-This 디바이스가 모바일 디바이스가 아닌 경우 예기치 않은 비정상적인 결과를 초래할 수 있습니다. |
|
|
공용 액세스 지점 허용
|
allow_public_access_points | boolean |
공공 연결을 자주 사용하는 대상 그룹을 더 잘 수용하기 위해 교육 및 연구 기관, 학교 및 일부 회사 연결에서 IP 주소에 대한 특정 검사를 우회합니다. |
|
|
가벼운 처벌
|
lighter_penalties | boolean |
중요한 대상 그룹에 대해 가양성 발생시킬 수 있는 일부 블랙리스트를 건너뜁니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공
|
success | boolean |
요청이 성공적이었나요? |
|
Message
|
message | string |
성공 또는 오류 알림의 일부 형식인 일반 상태 메시지입니다. |
|
사기 점수
|
fraud_score | integer |
IP, 사용자 에이전트, 언어 및 기타 선택적으로 전달된 변수를 기반으로 하는 사용자의 전체 사기 점수입니다. 사기 점수 >= 75는 의심스럽지만 반드시 사기는 아닙니다. 사기 점수 >= 85로 트래픽 플래그를 지정하거나 차단하는 것이 좋지만 더 높거나 낮은 임계값을 사용하는 것이 좋습니다. |
|
국가 코드
|
country_code | string |
IP 주소의 두 문자 국가 코드 또는 알 수 없는 경우 "N/A"입니다. |
|
지역
|
region | string |
사용 가능한 경우 IP 주소의 지역(상태) 또는 알 수 없는 경우 "N/A"입니다. |
|
도시
|
city | string |
사용 가능한 경우 IP 주소의 도시이거나 알 수 없는 경우 "N/A"입니다. |
|
ISP
|
ISP | string |
ISP(알려진 경우)입니다. 그렇지 않으면 "N/A"입니다. |
|
증권 시세 표시기
|
ASN | integer |
자치 시스템 번호(알려진 경우)입니다. 존재하지 않는 경우 Null입니다. |
|
조직
|
Organization | string |
알려진 경우 조직입니다. 나열된 ISP의 모회사 또는 하위 회사일 수 있습니다. 그렇지 않으면 "N/A"입니다. |
|
크롤러인가요?
|
is_crawler | boolean |
호스트 이름 또는 IP 주소 확인에 따라 Googlebot, Bingbot, Yandex 등과 같은 주류 검색 엔진에서 확인된 크롤러와 연결된 IP입니다. |
|
Timezone
|
timezone | string |
사용 가능한 경우 IP 주소의 표준 시간대이거나 알 수 없는 경우 "N/A"입니다. |
|
휴대폰
|
mobile | boolean |
이 사용자 에이전트가 모바일 브라우저인가요? (사용자 에이전트가 API 요청에 전달되지 않은 경우 항상 false)입니다. |
|
Host
|
host | string |
사용할 수 있는 경우 IP 주소의 호스트 이름입니다. |
|
Proxy
|
proxy | boolean |
이 IP 주소가 프록시로 의심되나요? (SOCKS, Elite, Anonymous, VPN, Tor 등) |
|
VPN
|
vpn | boolean |
이 IP가 VPN 연결로 의심되나요? 여기에는 언제든지 활성 VPN이 될 수 있는 데이터 센터 범위가 포함될 수 있습니다. 이 값이 true인 경우 "프록시" 상태는 항상 true입니다. |
|
TOR
|
tor | boolean |
이 IP가 TOR 연결로 의심되나요? 여기에는 언제든지 활성 TOR 종료가 될 수 있는 이전에 활성 TOR 노드 및 종료가 포함될 수 있습니다. 이 값이 true인 경우 "프록시" 상태는 항상 true입니다. |
|
활성 VPN
|
active_vpn | boolean |
프리미엄 계정 기능 - 인기 있는 VPN 서비스 및 개인 VPN 서버에서 사용하는 활성 VPN 연결을 식별합니다. |
|
활성 TOR
|
active_tor | boolean |
프리미엄 계정 기능 - TOR 네트워크에서 활성 TOR 종료를 식별합니다. |
|
최근 학대
|
recent_abuse | boolean |
이 값은 이 IP 주소에 대해 네트워크를 통해 최근에 확인된 남용이 있는지 여부를 나타냅니다. 남용은 지난 며칠 동안 확인된 차지백, 손상된 디바이스, 가짜 앱 설치 또는 유사한 악의적인 동작일 수 있습니다. |
|
봇 상태
|
bot_status | boolean |
프리미엄 계정 기능 - 봇 또는 비인간 트래픽이 최근에 이 IP 주소를 사용하여 자동화된 사기 행위에 관여했는지 여부를 나타냅니다. IP 주소가 의심스럽다는 강한 확신을 제공합니다. |
|
연결 유형
|
connection_type | string |
IP 주소 연결 유형을 "주거", "회사", "교육", "모바일" 또는 "데이터 센터"로 분류합니다. |
|
남용 속도
|
abuse_velocity | string |
프리미엄 계정 기능 - IPQS 위협 네트워크에서 IP 주소가 악용되는 빈도입니다. 값은 "높음", "보통", "낮음" 또는 "없음"일 수 있습니다. 사기 점수와 함께 사용하여 잘못된 동작을 식별할 수 있습니다. |
|
위도
|
latitude | float |
사용 가능한 경우 IP 주소의 위도이거나 알 수 없는 경우 "N/A"입니다. |
|
경도
|
longitude | float |
사용 가능한 경우 IP 주소의 경도이거나 알 수 없는 경우 "N/A"입니다. |
|
요청 ID
|
request_id | string |
요청 세부 정보를 조회하거나 포스트백 변환 알림을 보내는 데 사용할 수 있는 이 요청에 대한 고유 식별자입니다. |
URL(또는) 도메인 평판 데이터 검색
링크 및 도메인을 실시간으로 검사하여 신뢰할 수 있는 기계 학습 모델을 사용하여 의심스러운 URL을 검색합니다. 이러한 기계 학습 모델은 피싱 링크, 맬웨어 URL, 바이러스, 주차된 도메인 및 실시간 위험 점수가 있는 의심스러운 URL을 정확하게 식별할 수 있습니다. 또한 기계 학습 모델은 실시간 API 통합을 통해 평판이 좋지 않은 도메인, 의심스러운 링크 및 피싱 URL을 자신 있게 분류할 수 있습니다. 주차 도메인 검색, 도메인 스팸 점수, 평판 검사 및 도메인 연령과 같은 기능은 URL 인텔리전스를 완전히 새로운 수준으로 높입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
URL(또는) 도메인
|
url | True | string |
평판 데이터를 가져오려는 URL(또는) 도메인입니다. |
|
엄격성
|
strictness | True | integer |
이 URL을 얼마나 엄격하게 검색해야 하나요? 더 엄격한 검사는 더 높은 가양성 비율을 제공할 수 있습니다. 기본값은 수준 "0", 가장 낮은 엄격도 설정으로 설정하고 학대 수준에 따라 "1" 또는 "2"로 늘리는 것이 좋습니다. |
|
빠름
|
fast | boolean |
사용하도록 설정하면 API는 더 가벼운 검사 및 분석을 사용하여 더 빠른 응답 시간을 제공합니다. 이 설정은 기본적으로 False입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Message
|
message | string |
성공 또는 오류 알림의 일부 형식인 일반 상태 메시지입니다. |
|
성공
|
success | boolean |
요청이 성공적이었나요? |
|
하지 않은
|
unsafe | boolean |
피싱, 맬웨어, 스팸 또는 악의적인 동작으로 인해 이 도메인이 안전하지 않은 것으로 의심되나요? "risk_score"를 분석하여 신뢰도 수준을 봅니다. |
|
도메인
|
domain | string |
모든 리디렉션을 수행한 후 검색된 링크의 최종 대상 URL의 도메인 이름입니다. |
|
서버
|
server | string |
도메인 IP 주소의 서버 배너입니다. 예: "nginx/1.16.0". 값을 사용할 수 없는 경우 "N/A"가 됩니다. |
|
콘텐츠 형식
|
content_type | string |
URL 콘텐츠의 MIME 형식입니다. 예: "text/html; charset=UTF-8". 값을 사용할 수 없는 경우 "N/A"가 됩니다. |
|
상태 코드
|
status_code | integer |
URL 응답의 HTTP 상태 코드입니다. 이 값은 유효한 웹 사이트의 경우 "200"이어야 합니다. URL에 연결할 수 없는 경우 값은 "0"입니다. |
|
페이지 크기
|
page_size | integer |
URL의 콘텐츠를 다운로드할 총 바이트 수입니다. URL에 연결할 수 없는 경우 값은 "0"입니다. |
|
도메인 순위
|
domain_rank | integer |
전 세계적으로 웹 사이트의 예상 인기 순위입니다. 도메인이 순위가 지정되지 않거나 트래픽이 낮은 경우 값은 "0"입니다. |
|
DNS 유효
|
dns_valid | boolean |
URL의 도메인에 유효한 DNS 레코드가 있습니다. |
|
주차
|
parking | boolean |
이 URL의 도메인이 현재 판매 알림과 함께 주차되어 있나요? |
|
스팸
|
spamming | boolean |
이 URL의 도메인이 전자 메일 스팸 또는 악의적인 전자 메일 주소와 연결되어 있나요? |
|
맬웨어
|
malware | boolean |
이 URL이 맬웨어 또는 바이러스와 연결되어 있나요? |
|
Phishing
|
phishing | boolean |
이 URL이 악의적인 피싱 동작과 연결되어 있나요? |
|
의심스러움
|
suspicious | boolean |
이 URL이 악의적인 것으로 의심되거나 피싱 또는 남용에 사용되나요? 신뢰 수준으로 "risk_score"와 함께 사용합니다. |
|
성인
|
adult | boolean |
이 URL 또는 도메인 호스팅 데이트 또는 성인 콘텐츠인가요? |
|
위험 점수
|
risk_score | integer |
악의적인 URL 검색에 대한 신뢰 수준을 예측하는 IPQS 위험 점수입니다. 위험 점수 85 이상은 위험이 높고 위험 점수 = 100은 정확한 것으로 확인됩니다. |
|
카테고리
|
category | string |
사이트의 콘텐츠 및 산업과 관련된 웹 사이트 분류 및 범주입니다. "비디오 스트리밍", "추적기", "게임", "개인 정보", "광고", "해킹", "악성", "피싱" 등 70개 이상의 범주를 사용할 수 있습니다. 알 수 없는 경우 값은 "N/A"가 됩니다. |
|
Domain Age Human
|
domain_age.human | string |
이 도메인이 등록된 시기에 대한 사용자 설명입니다. (예: 3개월 전) |
|
도메인 연령 타임스탬프
|
domain_age.timestamp | integer |
이 도메인이 처음 등록된 epoch 이후의 unix 시간입니다. (예: 1568061634) |
|
Domain Age ISO
|
domain_age.iso | string |
이 도메인이 ISO8601 형식으로 등록된 시간(예: 2019-09-09T16:40:34-04:00) |
|
요청 ID
|
request_id | string |
이 요청에 대한 고유 식별자 |
전자 메일 주소 평판 데이터 검색
이 API는 수백 개의 구문 및 DNS 검사를 사용하여 실시간 이메일 주소 평판 점수 매기기 및 유효성 검사를 제공합니다. API를 활용하여 메일 서비스 공급자에 전자 메일 주소 받은 편지함이 있고 새 메시지를 수락할 수 있는지 확인할 수 있습니다. 또한 사용자는 이메일 주소의 평판이 좋지 않거나 최근에 남용 또는 위협과 관련이 있는지 확인할 수 있습니다. 추가 위험 점수 매기기에서는 온라인 사기 행위 기록이 있는 전자 메일뿐만 아니라 삭제 가능한 임시 메일 서비스도 검색할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
전자 메일 주소
|
True | string |
평판 데이터를 가져오려는 전자 메일 주소입니다. |
|
|
학대의 엄격성
|
abuse_strictness | True | integer |
"recent_abuse" 데이터 포인트를 사용하여 악의적인 전자 메일 주소의 기계 학습 패턴 인식에 대한 엄격 수준을 설정합니다. 기본 수준 0은 적절한 범위를 제공하지만 계정 애플리케이션을 필터링하고 고급 사기꾼에 직면하는 경우 이 값을 수준 1 또는 2로 늘리는 것이 좋습니다. |
|
빠름
|
fast | boolean |
이 매개 변수를 사용하도록 설정하면 API가 메일 서비스 공급자와 SMTP 검사를 수행하지 않으므로 API 속도가 크게 증가합니다. 구문 및 DNS 검사는 일회용 전자 메일 검색 서비스뿐만 아니라 전자 메일 주소에서도 계속 수행됩니다. 이 옵션은 시간에 민감한 방식으로 의사 결정을 내려야 하는 서비스를 위한 것입니다. |
|
|
시간 제한(초) (1-60)
|
timeout | integer |
메일 서비스 공급자의 회신을 기다리는 최대 시간(초)입니다. 구현 요구 사항에 즉각적인 응답이 필요하지 않은 경우 이 값을 20으로 부딪치는 것이 좋습니다. 연결 시간 제한이 발생하는 모든 결과는 "timed_out" 변수를 true로 반환합니다. 기본값은 7초입니다. |
|
|
도메인 제안
|
suggest_domain | boolean |
전자 메일 주소 도메인에 오타가 있고 인기 있는 메일 서비스로 수정되어야 하는지 강제로 분석합니다. 기본적으로 이 테스트는 현재 전자 메일이 유효하지 않거나 "최근 남용" 상태가 참인 경우에만 수행됩니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Message
|
message | string |
성공 또는 오류 알림의 일부 형식인 일반 상태 메시지입니다. |
|
성공
|
success | boolean |
요청이 성공적이었나요? |
|
유효
|
valid | boolean |
이 전자 메일 주소가 유효한 것으로 표시됩니까? |
|
일회용
|
disposable | boolean |
이 전자 메일이 임시 또는 일회용 메일 서비스에 속하는 것으로 의심되는가요? 일반적으로 및 사기꾼과 관련이 있습니다. |
|
SMTP 점수
|
smtp_score | integer |
전자 메일 서버 SMTP 설정의 유효성 점수입니다. 범위: "-1" - "3". "-1" 위의 점수는 유효한 전자 메일과 연결할 수 있습니다. -1 = 잘못된 전자 메일 주소 0 = 메일 서버가 존재하지만 모든 메일 1을 거부합니다. 메일 서버가 존재하지만 일시적인 오류 2 = 메일 서버가 존재하지만 모든 전자 메일 3 = 메일 서버가 존재하고 전자 메일 주소를 확인했습니다. |
|
전체 점수
|
overall_score | integer |
전체 전자 메일 유효성 점수입니다. 범위: "0" - "4". "1"을 초과하는 점수는 유효한 전자 메일과 연결할 수 있습니다. 0 = 잘못된 전자 메일 주소 1 = DNS 유효, 연결할 수 없는 메일 서버 2 = dns 유효, 임시 메일 거부 오류 3 = dns 유효, 모든 메일 허용 4 = DNS 유효, 확인된 전자 메일 존재 |
|
이름 (First Name)
|
first_name | string |
전자 메일을 기반으로 이름이 의심됩니다. 전자 메일이 일반 회사 전자 메일로 의심되는 경우 "CORPORATE"를 반환합니다. 이름을 확인할 수 없는 경우 "UNKNOWN"을 반환합니다. |
|
일반
|
generic | boolean |
이 전자 메일이 도메인에 대한 catch 전체 또는 공유 전자 메일로 의심되나요? ("admin@", "webmaster@", "newsletter@", "sales@", "contact@" 등) |
|
Common
|
common | boolean |
일반적인 전자 메일 공급자의 전자 메일인가요? ("gmail.com", "yahoo.com", "hotmail.com" 등) |
|
DNS 유효
|
dns_valid | boolean |
전자 메일의 호스트 이름에 유효한 DNS 항목이 있나요? 유효한 전자 메일의 부분 표시입니다. |
|
팟
|
honeypot | boolean |
이 전자 메일은 "허니팟" 또는 "스팸 트랩"으로 생각되나요? 이러한 전자 메일로 대량 메일을 보내면 대규모 ISP에 의해 블랙리스트에 오르고 스팸 폴더에서 종료될 위험이 높아집니다. |
|
배달 가능성
|
deliverability | string |
이 전자 메일이 사용자에게 배달되고 사서함에 착륙할 가능성이 얼마나 큽니까? 값은 "높음", "보통" 또는 "낮음"일 수 있습니다. |
|
빈번한 불만 제기자
|
frequent_complainer | boolean |
이 전자 메일이 마케팅 목록에서 자주 구독을 취소하거나 전자 메일을 스팸으로 보고하는지 여부를 나타냅니다. |
|
스팸 트랩 점수
|
spam_trap_score | string |
활성 SPAM 트랩인 전자 메일 주소의 신뢰 수준입니다. 값은 "높음", "보통", "낮음" 또는 "없음"일 수 있습니다. "높음" 또는 "보통" 상태의 전자 메일을 스크러빙하는 것이 좋습니다. 홍보용 메일에 대해 가능하면 "낮음" 전자 메일을 사용하지 마세요. |
|
캐치올
|
catch_all | boolean |
이 전자 메일은 메일 서버가 테스트된 모든 전자 메일을 유효한 것으로 확인하는 "모두 catch"가 될 수 있나요? 이메일 서버가 계정의 상태를 확인하지 않으므로 이러한 시나리오에서 주소가 실제로 유효한지 확인하기가 어렵습니다. |
|
초과
|
timed_out | boolean |
확인 중에 메일 서비스 공급자에 대한 연결 시간이 초과했나요? 그렇다면 기본값인 7초보다 "시간 제한" 변수를 늘리는 것이 좋습니다. "유효한" 결과가 false인 시간 제한은 false일 가능성이 높으며 신뢰할 수 없어야 합니다. |
|
용의자
|
suspect | boolean |
이 값은 메일 서버가 현재 일시적인 오류로 회신 중이고 전자 메일 주소를 확인할 수 없는지 여부를 나타냅니다. 이 상태는 아래에 정의된 대로 "모두 catch" 전자 메일 주소에 대해서도 마찬가지입니다. 이 값이 true이면 "유효한" 결과가 오염될 수 있으며 이메일 주소가 실제로 유효하다는 보장은 없습니다. |
|
최근 학대
|
recent_abuse | boolean |
이 값은 이 이메일 주소에 대해 네트워크를 통해 최근에 확인된 남용이 있는지 여부를 나타냅니다. 남용은 확인된 차지백, 가짜 등록, 손상된 디바이스, 가짜 앱 설치 또는 지난 며칠 내의 유사한 악의적인 동작일 수 있습니다. |
|
사기 점수
|
fraud_score | integer |
IPQS 위협 네트워크에서 전자 메일의 평판 및 최근 동작에 따라 사용자의 전반적인 사기 점수입니다. 사기 점수 >= 75는 의심스럽지만 반드시 사기는 아닙니다. |
|
제안된 도메인
|
suggested_domain | string |
기본값은 "N/A"입니다. 이 전자 메일의 도메인이 실제로 인기 있는 메일 서비스로 수정되어야 하는지를 나타냅니다. 이 필드는 사용자 오타를 잡는 데 유용합니다. 예를 들어 "gmai.com"이 있는 전자 메일 주소는 제안된 도메인 "gmail.com"을 표시합니다. 이 기능은 모든 주요 메일 서비스 공급자를 지원합니다. |
|
유출
|
leaked | boolean |
이 이메일 주소가 제3자로부터 최근 데이터베이스 유출과 관련이 있나요? 유출된 계정은 데이터베이스 위반 시 손상될 수 있으므로 위험을 초래합니다. |
|
Domain Age Human
|
domain_age.human | string |
이 도메인이 등록된 시기에 대한 사용자 설명입니다. (예: 3개월 전) |
|
도메인 연령 타임스탬프
|
domain_age.timestamp | integer |
이 도메인이 처음 등록된 Epoch 이후 Unix 시간입니다(예: 1568061634). |
|
Domain Age ISO
|
domain_age.iso | string |
시간 도메인이 ISO8601 형식으로 등록되었습니다(예: 2019-09-09T16:40:34-04:00). |
|
FirstSeen Human
|
first_seen.human | string |
IPQS가 이 전자 메일 주소를 처음 발견한 경우 전자 메일 생성 날짜의 추정을 사용하여 전자 메일 주소 기간의 사용자 설명입니다. (예: 3개월 전) |
|
FirstSeen 타임스탬프
|
first_seen.timestamp | integer |
IPQS에서 이 전자 메일을 처음 분석한 epoch 이후의 unix 시간입니다. (예: 1568061634) |
|
FirstSeen ISO
|
first_seen.iso | string |
IPQS에서 이 전자 메일을 ISO8601 형식으로 처음 분석한 시간입니다(예: 2019-09-09T16:40:34-04:00). |
|
삭제된 전자 메일
|
sanitized_email | string |
모든 별칭 및 마스킹이 제거된 삭제된 전자 메일 주소(예: Gmail.com 대한 여러 기간). |
|
요청 ID
|
request_id | string |
이 요청에 대한 고유 식별자입니다. |
전화 번호 평판 데이터 검색
전 세계 전화 번호를 정확하게 확인하고 위험 분석 데이터를 사용하여 통신 사업자 및 회선 유형 세부 정보의 조합을 검색하여 전화 번호 평판을 평가합니다. IPQS는 모든 지역에 대한 지원을 통해 다양한 통신 사업자 및 계층 1 통신 공급자로부터 전화 유효성 검사 및 확인 데이터를 수집합니다. HLR 및 LRN 조회와 유사한 쉬운 사용자 유효성 검사를 위해 비활성 및 연결이 끊긴 전화 번호를 검색합니다. 온라인에서 악의적인 행동과 관련된 번호와 함께 가상 및 일회용 전화 번호를 정확하게 식별합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
전화 번호
|
phone | True | string |
평판 데이터를 가져오려는 전화 번호입니다. |
|
엄격성
|
strictness | True | integer |
이 평판 확인을 얼마나 심층(엄격한)으로 확인하시겠습니까? 더 엄격한 검사는 더 높은 가양성 비율을 제공할 수 있습니다. 가장 낮은 엄격도 설정인 "0"에서 시작하여 사기 수준에 따라 "1" 또는 "2"로 늘리는 것이 좋습니다. |
|
국가(여러 국가의 경우 쉼표로 구분된 값 제공)
|
country | string |
필요에 따라 이 전화 번호가 연결된 것으로 의심되는 기본 국가 또는 국가(쉼표로 구분됨)를 제공할 수 있습니다. 우리 시스템은 확인을 위해 이 목록에 있는 국가를 사용하는 것을 선호하거나 전화 번호가 10자리 미만인 경우 국가를 지정해야 합니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Message
|
message | string |
성공 또는 오류 알림의 일부 형식인 일반 상태 메시지입니다. |
|
성공
|
success | boolean |
요청이 성공적이었나요? |
|
포맷
|
formatted | string |
국제 전화 번호로 서식이 지정된 전화 번호입니다. 서식을 지정할 수 없는 경우 해당 없음 |
|
로컬 형식
|
local_format | string |
지역 번호가 있는 국가의 로컬 라우팅 규칙에 서식이 지정된 전화 번호입니다. 서식을 지정할 수 없는 경우 해당 없음 |
|
유효
|
valid | boolean |
해당 국가의 이동 통신 사업자가 사용할 수 있는 할당된 전화 번호에 따라 전화 번호의 형식이 올바르게 지정되고 유효한 것으로 간주되나요? |
|
사기 점수
|
fraud_score | integer |
전화 번호가 사기성일 가능성이 얼마나 큰지 예측하는 IPQS 위험 점수입니다. 점수 85 이상은 위험이 높습니다. |
|
최근 학대
|
recent_abuse | boolean |
이 전화 번호가 최근 또는 지속적인 사기와 관련이 있습니까? |
|
VOIP
|
VOIP | boolean |
이 전화 번호는 VOIP(Voice Over Internet Protocol) 또는 디지털 전화 번호인가요? |
|
선불
|
prepaid | boolean |
이 전화 번호는 선불 서비스 요금제와 연결되어 있나요? |
|
위험한
|
risky | boolean |
이 전화 번호는 사기 행위, 사기, 로보 통화, 가짜 계정 또는 기타 비우호적인 동작과 관련이 있나요? |
|
Active
|
active | boolean |
이 전화 번호는 현재 활성 상태인 라이브 사용 가능한 전화 번호인가요? |
|
Carrier
|
carrier | string |
이동 통신 사업자(서비스 공급자)에게 이 전화 번호가 할당되었거나 알 수 없는 경우 "N/A"가 할당되었습니다. |
|
회선 유형
|
line_type | string |
이 전화 번호의 유형은 (무료, 모바일, 유선 전화, 위성, VOIP, 프리미엄 요금, 호출기 등...) 또는 "N/A"(알 수 없는 경우)와 연결됩니다. |
|
국가
|
country | string |
이 전화 번호의 두 문자 국가 코드입니다. |
|
도시
|
city | string |
사용 가능한 경우 전화 번호의 도시이거나 알 수 없는 경우 "N/A"입니다. |
|
우편번호
|
zip_code | string |
사용 가능한 경우 전화 번호의 우편 번호 또는 우편 번호이거나 알 수 없는 경우 "N/A"입니다. |
|
지역
|
region | string |
사용 가능한 경우 전화 번호의 지역(상태) 또는 알 수 없는 경우 "N/A"입니다. |
|
전화 걸기 코드
|
dialing_code | integer |
이 전화 번호의 1~4자리 전화 걸기 코드이거나 알 수 없는 경우 null입니다. |
|
요청 ID
|
request_id | string |
이 요청에 대한 고유 식별자 |
|
이름
|
name | string |
전화 번호에 할당된 이름 또는 성 또는 회사 이름과 같은 전화 번호의 소유자 이름입니다. 여러 이름이 쉼표로 구분된 형식으로 반환됩니다. 알 수 없는 경우 값은 "N/A"입니다. |
|
Timezone
|
timezone | string |
사용 가능한 경우 전화 번호의 표준 시간대이거나 알 수 없는 경우 "N/A"입니다. |
|
통화 안 함
|
do_not_call | boolean |
전화 번호가 DNC(통화 안 함) 목록에 나열되는지를 나타냅니다. 미국 및 CA에서만 지원합니다. 이 데이터는 최신 DNC 블랙리스트를 사용하여 최신% 100개일 수 없습니다. |
|
활성 상태
|
active_status | string |
향상된 활성 회선 검사를 사용하는 경우 구독자 연결 상태에 대한 추가 세부 정보입니다. 이러한 값은 알 수 없는 경우 "활성 선", "연결이 끊긴 줄", "전화 꺼짐", "결정적이지 않은 상태" 또는 "N/A"일 수 있습니다. |