共用方式為


Cloudmersive 資料驗證 (預覽版)

驗證 API 可協助您驗證資料。 檢查電子郵件地址是否真實。 檢查網域是否真實。 檢查 IP 地址,甚至它所在的位置。 所有這些以及更多內容都可以在驗證 API 中找到。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
URL https://account.cloudmersive.com/contact-support
連接器中繼資料
Publisher Cloudmersive有限責任公司
網站 https://cloudmersive.com/validate-api
隱私策略 https://cloudmersive.com/privacy-policy

此連接器對於驗證電子郵件地址、電話號碼、姓名、地址、增值稅號碼等的任何資料驗證需求至關重要。 如要進一步瞭解,請前往 電子郵件驗證 API 頁面、 增值稅驗證 API 頁面或 電話驗證 API 頁面。

若要使用此連接器,您需要 Cloudmersive 帳戶。 您可以使用 Microsoft 帳戶註冊或建立 Cloudmersive 帳戶。 請按照以下步驟獲取您的 API 密鑰。

取得 API 金鑰和密碼

  • 註冊 Cloudmersive 帳戶
  • 使用您的 Cloudmersive 帳戶登錄並單擊 API 密鑰

您可以在此處建立並查看 API 金鑰頁面上列出的 API 金鑰。 只需將此 API 金鑰複製並貼上到 Cloudmersive 資料驗證連接器中即可。

現在您已準備好開始使用 Cloudmersive Data Validation Connector。

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有區域 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
鑰匙 securestring 此 API 的金鑰

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

以語法方式驗證 URL

驗證 URL 在語法上是否有效 (不檢查端點的有效性)。 接受各種類型的輸入,並產生格式正確的 URL 作為輸出。

剖析並驗證全名

將全名字串 (例如「Mr. Jon van der Waal Jr.」) 剖解析為其元件元件 (並傳回這些元件元件),然後驗證它是否為有效的名稱字串

取得名字的性別

決定名字(名字)的性別

取得網域的 WHOIS 資訊

驗證網域名稱是否存在,並傳回該網域名稱的完整 WHOIS 記錄。 WHOIS 記錄包括網域名稱的所有註冊詳細資訊,例如網域擁有者的相關資訊。

地理定位 IP 位址

識別 IP 位址國家/地區、州/普羅旺斯、城市、郵遞區號等。適用於安全和 UX 應用程式。

完整驗證 URL

驗證 URL 在語法上是否有效 (不檢查端點的有效性)、它是否存在,以及端點是否已啟動並通過病毒掃描檢查。 接受各種類型的輸入,並產生格式正確的 URL 作為輸出。

完整驗證電子郵件地址

對電子郵件地址執行完整驗證。 檢查語法正確性,識別有問題的郵件伺服器(如果有),然後聯絡電子郵件伺服器以驗證帳戶的存在 - 而不發送任何電子郵件。

將非結構化輸入文字字串剖析為國際格式化位址

使用機器學習和自然語言處理 (NLP) 來處理各種情況,包括跨多個國家/地區的非標準和非結構化地址字符串以及地址格式規範。

查詢增值稅代碼

檢查增值稅代碼是否有效,如果有效,則傳回有關該代碼的詳細資訊

解析 HTTP User-Agent 字串,識別機器人

使用解析系統和資料庫將 User-Agent 解析為其結構化元件部分,例如瀏覽器、瀏覽器版本、瀏覽器引擎、作業系統,以及重要的機器人識別。

驗證名字

判斷字串是否為有效的名字 (名字)

驗證姓氏

判斷字串是否為有效的姓氏 (姓氏)

驗證程式碼識別碼

判斷輸入名稱是否為有效的技術/代碼識別碼。 設定輸入規則,例如是否允許空格、連字號、底線等。 例如,有效的識別碼可能是 “helloWorld”,但不是 “hello*World”。

驗證網域名稱

檢查網域名稱是否有效。 API 會透過聯絡 DNS 服務來執行即時驗證,以驗證網域名稱的存在。

驗證電話號碼 (基本)

透過分析語法來驗證電話號碼

以語法方式驗證 URL

驗證 URL 在語法上是否有效 (不檢查端點的有效性)。 接受各種類型的輸入,並產生格式正確的 URL 作為輸出。

參數

名稱 機碼 必要 類型 Description
URL
URL string

要驗證的 URL

傳回

僅使用語法驗證 URL 的結果

剖析並驗證全名

將全名字串 (例如「Mr. Jon van der Waal Jr.」) 剖解析為其元件元件 (並傳回這些元件元件),然後驗證它是否為有效的名稱字串

參數

名稱 機碼 必要 類型 Description
完整名稱字串
FullNameString string

要處理為自由格式字串的完整名稱;支援名字、中間名、姓氏、頭銜、暱稱、後綴、顯示名稱等多種元件

傳回

完整名稱驗證作業的結果

取得名字的性別

決定名字(名字)的性別

參數

名稱 機碼 必要 類型 Description
國家代碼
CountryCode string

隨意的;此名稱的國家/地區,可能的值為 “US”、“LY”、“NI”、“TT”、“MK”、“KZ”、“BO”、“UG”、“TZ”、“CL”、“SI”、“MA”、“RW”、“VN”、“AW”、“CY”、“BH”、“SG”、“ZA”、“MU”、“BR”、“TN”、“KH”、“US”、“TH”、“TW”、“UY”、“DO”、“CO”、“UA”、“QA”、“BY”、“SN”、“SD”、“FJ”、“LB”、“BE”、“ML”、“LV”、“FR”、“TM”、“NG”、“EC”、“NO”、“SL”、“CR”、“PA”、“GE”、 “CH”、“KR”、“RS”、“ZM”、“FI”、“BF”、“MC”、“AU”、“GA”、“LS”、“RU”、“IN”、“SE”、“LK”、“BZ”、“MX”、“GH”、“AF”、“TJ”、“BN”、“DZ”、“CM”、“GR”、“MD”、“HN”、“AT”、“NZ”、“SV”、“GW”、“NA”、“AR”、“MZ”、“PK”、“MN”、“IQ”、“BW”、“ED”、“ET”、“CF”、“JP”、“BB”、“PH”、“CU”、“BD”、“AO”、“SM”、“LC”、“ME”、“RO”、DANIL“O”“、 “ES”、“EE”、“IL”、“ZW”、“SY”、“MW”、“LU”、“IR”、“SC”、“NL”、“JO”、“AM”、“DE”、“GL”、“OM”、“DK”、“HR”、“LI”、“TD”、“KM”、“BA”、“GM”、“GD”、“CA”、“CZ”、“MR”、“ST”、“IS”、“LR”、“IE”、“VC”、“AE”、“KG”、“GQ”、“GQ”、“SK”、“SK”、“BJ”、“SK”、“BJ”、“IT”、“SA”、“MY”、“CI”、“AG”、“AD”、“KS”、“HU”、“CG”、“KP”、 “DM”、“GN”、“GT”、“NP”、“JM”、“LA”、“GB”、“BG”、“HT”、“PE”、“AZ”、“LT”、“SZ”、“PY”、“MT”、“VA”

FirstName
FirstName string

輸入名字(名字)以獲取性別

傳回

GetGender 作業的結果

取得網域的 WHOIS 資訊

驗證網域名稱是否存在,並傳回該網域名稱的完整 WHOIS 記錄。 WHOIS 記錄包括網域名稱的所有註冊詳細資訊,例如網域擁有者的相關資訊。

參數

名稱 機碼 必要 類型 Description
要檢查的網域名稱,例如「cloudmersive.com」。 輸入是...
domain True string

要檢查的網域名稱,例如「cloudmersive.com」。 輸入是...

傳回

WHOIS 作業的結果

身體
WhoisResponse

地理定位 IP 位址

識別 IP 位址國家/地區、州/普羅旺斯、城市、郵遞區號等。適用於安全和 UX 應用程式。

參數

名稱 機碼 必要 類型 Description
要地理定位的 IP 位址,例如「55.55.55.55」。 輸入是一個字符串,所以......
value True string

要地理定位的 IP 位址,例如「55.55.55.55」。 輸入是一個字符串,所以......

傳回

地理位置結果

完整驗證 URL

驗證 URL 在語法上是否有效 (不檢查端點的有效性)、它是否存在,以及端點是否已啟動並通過病毒掃描檢查。 接受各種類型的輸入,並產生格式正確的 URL 作為輸出。

參數

名稱 機碼 必要 類型 Description
URL
URL string

要驗證的 URL

傳回

使用完整驗證驗證 URL 的結果

完整驗證電子郵件地址

對電子郵件地址執行完整驗證。 檢查語法正確性,識別有問題的郵件伺服器(如果有),然後聯絡電子郵件伺服器以驗證帳戶的存在 - 而不發送任何電子郵件。

參數

名稱 機碼 必要 類型 Description
要驗證的電子郵件地址,例如“support@cloudmersive.com”。 inp...
email True string

要驗證的電子郵件地址,例如“support@cloudmersive.com”。 inp...

傳回

完整電子郵件地址驗證結果

將非結構化輸入文字字串剖析為國際格式化位址

使用機器學習和自然語言處理 (NLP) 來處理各種情況,包括跨多個國家/地區的非標準和非結構化地址字符串以及地址格式規範。

參數

名稱 機碼 必要 類型 Description
位址字串
AddressString string

格式化為單一文字字串的郵寄地址或街道地址;這將被解析為其組件

大寫模式
CapitalizationMode string

隨意的;表示解析後的輸出應該如何大寫;預設值為標題大小寫;可能的值為:「Uppercase」會將大寫設定為 UPPER CASE;「小寫」會將大寫設定為小寫;“Titlecase” 會將大寫設定為 Title Case;而「原裝外殼」則會盡可能保留原裝外殼

傳回

將位址剖解析為其組成部分的結果

查詢增值稅代碼

檢查增值稅代碼是否有效,如果有效,則傳回有關該代碼的詳細資訊

參數

名稱 機碼 必要 類型 Description
增值稅代碼
VatCode string

要查找的增值稅代碼;範例「CZ25123891」

傳回

解析 HTTP User-Agent 字串,識別機器人

使用解析系統和資料庫將 User-Agent 解析為其結構化元件部分,例如瀏覽器、瀏覽器版本、瀏覽器引擎、作業系統,以及重要的機器人識別。

參數

名稱 機碼 必要 類型 Description
使用者代理字串
UserAgentString string

您要剖析和驗證的使用者代理程式字串

傳回

User-Agent 驗證要求的結果

驗證名字

判斷字串是否為有效的名字 (名字)

參數

名稱 機碼 必要 類型 Description
FirstName
FirstName string

要處理的名字

傳回

名字驗證作業的結果

驗證姓氏

判斷字串是否為有效的姓氏 (姓氏)

參數

名稱 機碼 必要 類型 Description
姓氏
LastName string

要處理的姓氏

傳回

姓氏驗證作業的結果

驗證程式碼識別碼

判斷輸入名稱是否為有效的技術/代碼識別碼。 設定輸入規則,例如是否允許空格、連字號、底線等。 例如,有效的識別碼可能是 “helloWorld”,但不是 “hello*World”。

參數

名稱 機碼 必要 類型 Description
允許連字號
AllowHyphens boolean

如果識別碼中允許使用連字號,則為 true,否則為 false

允許數字
AllowNumbers boolean

如果識別碼中允許數字,則為 true,否則為 false

允許期間
AllowPeriods boolean

如果識別碼中允許句點,則為 True,否則為 false

允許底線
AllowUnderscore boolean

如果識別碼中允許底線,則為 true,否則為 false

允許空格
AllowWhitespace boolean

如果識別碼中允許空格,則為 true,否則為 false

Input
Input string

文字字串識別碼輸入

最大長度
MaxLength integer

隨意的;識別碼的長度上限 (如果有的話)

最小長度
MinLength integer

隨意的;識別碼的最小長度 (如果有的話)

傳回

執行識別碼驗證作業的結果

驗證網域名稱

檢查網域名稱是否有效。 API 會透過聯絡 DNS 服務來執行即時驗證,以驗證網域名稱的存在。

參數

名稱 機碼 必要 類型 Description
要檢查的網域名稱,例如「cloudmersive.com」。 輸入是...
domain True string

要檢查的網域名稱,例如「cloudmersive.com」。 輸入是...

傳回

驗證作業的結果

身體
CheckResponse

驗證電話號碼 (基本)

透過分析語法來驗證電話號碼

參數

名稱 機碼 必要 類型 Description
預設國家代碼
DefaultCountryCode string

選用的預設國家/地區代碼。 如果留空,將默認為“US”。

電話號碼
PhoneNumber string

要剖析為驗證輸入的原始電話號碼字串

傳回

驗證電話號碼的結果

定義

檢查回應

驗證作業的結果

名稱 路徑 類型 Description
有效網域
ValidDomain boolean

如果網域名稱有效,則為 true,如果無效,則為 false

FirstNameValidation回應

名字驗證作業的結果

名稱 路徑 類型 Description
成功
Successful boolean

如果驗證作業成功,則為 true,否則為 false

ValidationResult
ValidationResult string

可能的值為:ValidFirstName、ValidUnknownFirstName、InvalidSpamInput、InvalidCharacters、InvalidEmpty

FullEmailValidation回應

完整電子郵件地址驗證結果

名稱 路徑 類型 Description
網域
Domain string

電子郵件地址的網域名稱

是Catchall網域
IsCatchallDomain boolean

如果網域是包羅萬象的網域名稱,則為 true,否則為 false。 包羅萬象的網域名稱雖然很少見,但始終接受入站電子郵件,以確保它們不會遺失任何潛在有用的電子郵件。 有時可以將 Catch-all 網域名稱設定為先接受並儲存所有傳入電子郵件,然後在延遲一段時間後將退信電子郵件傳回給寄件者。

是一次性的
IsDisposable boolean

如果電子郵件地址是一次性電子郵件地址,則為 True,否則為 false;這些一次性提供者通常不用於接收電子郵件,因此打開發送到那裡的郵件的可能性很低。

IsFreeEmailProvider
IsFreeEmailProvider boolean

如果電子郵件網域名稱是免費提供者(通常是供消費者/個人使用的免費註冊網路電子郵件提供者),則為 true,否則為 false。

MailServerUsedForValidation
MailServerUsedForValidation string

已連線至以進行驗證的電子郵件伺服器

有效地址
ValidAddress boolean

如果電子郵件地址整體有效,則為 True,否則為 false

Valid_Domain
Valid_Domain boolean

如果電子郵件地址的網域名稱有效,則為 true,否則為 false。 這是 ValidAddress 的一個元件,但不是唯一的元件。

Valid_SMTP
Valid_SMTP boolean

如果電子郵件地址已由遠端伺服器驗證,則為 True,否則為 false。 這是 ValidAddress 的一個元件,但不是唯一的元件。

Valid_Syntax
Valid_Syntax boolean

如果電子郵件地址的語法有效,則為 true,否則為 false。 這是 ValidAddress 的一個元件,但不是唯一的元件。

FullNameValidation回應

完整名稱驗證作業的結果

名稱 路徑 類型 Description
顯示名稱
DisplayName string

名稱的完整顯示名稱

FirstName
FirstName string

名字(名字)

姓氏
LastName string

姓氏(姓氏)

MiddleName
MiddleName string

中間名;如果有多個名稱,它們將用空格分隔

綽號
NickName string

暱稱(如果提供)

成功
Successful boolean

如果驗證作業成功,則為 true,否則為 false

後綴
Suffix string

名稱的後綴,例如“Jr.”或“Sr”。

Title
Title string

該人的頭銜(如果提供),例如“先生”或“女士”。

ValidationResult_FirstName
ValidationResult_FirstName string

可能的值為:ValidFirstName、ValidUnknownFirstName、InvalidSpamInput、InvalidCharacters、InvalidEmpty

ValidationResult_LastName
ValidationResult_LastName string

可能的值為:ValidLastName、ValidUnknownLastName、InvalidSpamInput、InvalidCharacters、InvalidEmpty

地理定位回應

地理位置結果

名稱 路徑 類型 Description
城市
City string

IP 位址所在城市

國家代碼
CountryCode string

IP 位址的兩個字母國家代碼

CountryName
CountryName string

IP 位址的國家/地區名稱

緯度
Latitude double

IP地址的緯度

經度
Longitude double

IP位址的經度

區域代碼
RegionCode string

IP 位址的州/地區代碼

地區名稱
RegionName string

IP 位址的州/地區

時區標準名稱
TimezoneStandardName string

IP 位址的時區

郵遞區號
ZipCode string

IP地址的郵遞區號

GetGender回應

GetGender 作業的結果

名稱 路徑 類型 Description
性別
Gender string

這個名字的性別;可能的值為 Male、Female 和 Neutral (可套用至 Male 或 Female)

成功
Successful boolean

成功則為 true,否則為 false

LastNameValidation回應

姓氏驗證作業的結果

名稱 路徑 類型 Description
成功
Successful boolean

如果驗證作業成功,則為 true,否則為 false

ValidationResult
ValidationResult string

可能的值為:ValidLastName、ValidUnknownLastName、InvalidSpamInput、InvalidCharacters、InvalidEmpty

剖解析地址回應

將位址剖解析為其組成部分的結果

名稱 路徑 類型 Description
建築
Building string

建築物、房屋或構築物的名稱(如果適用),例如“Cloudmersive Building 2”。 這通常會為空。

城市
City string

地址所在的城市。

國家
Country string

地址所在的國家/地區(如果地址中存在)。 如果未包含在位址中,則為空值。

郵遞區號
PostalCode string

地址的郵遞區號或郵遞區號。

StateOrProvince
StateOrProvince string

地址的州或省。

街道
Street string

地址的街道或道路名稱。 例如,在地址「1600 Pennsylvania Avenue NW」中,街道號碼將是「Pennsylvania Avenue NW」。

街道號碼
StreetNumber string

地址的門牌號碼或門牌號碼。 例如,在地址「1600 Pennsylvania Avenue NW」中,街道號碼將為「1600」。 此值通常會針對大多數地址填入。

成功
Successful boolean

如果剖析作業成功,則為 true,否則為 false

電話號碼驗證回應

驗證電話號碼的結果

名稱 路徑 類型 Description
國家代碼
CountryCode string

電話號碼的兩位數國家代碼

CountryName
CountryName string

電話號碼的用戶友好型國家/地區名稱

E164格式
E164Format string

電話號碼的 E.164 格式

國際格式
InternationalFormat string

電話號碼的內部格式

是有效
IsValid boolean

如果電話號碼有效,則為 True,否則為 false

國家格式
NationalFormat string

電話號碼的國家格式

電話號碼類型
PhoneNumberType string

電話號碼類型;可能的值為:FixedLine、Mobile、FixedLineOrMobile、TollFree、PremiumRate、SharedCost、Voip、PersonalNumber、Pager、Uan、Voicemail、Unknown

成功
Successful boolean

如果作業成功,則為 true,如果驗證期間發生錯誤,則為 false。 如需驗證結果,請參閱 IsValid。

UserAgentValidate回應

User-Agent 驗證要求的結果

名稱 路徑 類型 Description
BotName
BotName string

隨意的;如果要求來自已知機器人,則為機器人的名稱,否則為 null

機器人網址
BotURL string

隨意的;如果可用,則機器人的 URL

瀏覽器引擎名稱
BrowserEngineName string

瀏覽器引擎的名稱

瀏覽器引擎版本
BrowserEngineVersion string

瀏覽器引擎版本

瀏覽器名稱
BrowserName string

瀏覽器名稱

瀏覽器版本
BrowserVersion string

瀏覽器版本

裝置品牌名稱
DeviceBrandName string

User-Agent 品牌名稱

裝置型號
DeviceModel string

User-Agent 的型號名稱或編號

裝置類型
DeviceType string

User-Agent 的裝置類型;可能的值為“DESKTOP”、“SMARTPHONE”、“TABLET”

伊斯機器人
IsBot boolean

如果請求是已知機器人,則為 true,否則為 false

作業系統
OperatingSystem string

User-Agent 的作業系統(例如 Windows)

OperatingSystemCPUPlatform
OperatingSystemCPUPlatform string

User-Agent 的 CPU 平台(例如 x64)

作業系統版本
OperatingSystemVersion string

User-Agent 的作業系統版本(例如 Windows 10 的「10」)

成功
Successful boolean

如果作業成功,則為 true,否則為 false

ValidateIdentifier回應

執行識別碼驗證作業的結果

名稱 路徑 類型 Description
錯誤
Error string

識別碼驗證產生的錯誤;可能的錯誤包括:「InputIsEmpty」、「ContainsWhitespace」、「ContainsNumbers」、「ContainsHyphen」、「ContainsUnderscore」、「ContainsPeriod」、「TooShort」、「TooLong」、「ContainsSpecialCharacters」

有效識別碼
ValidIdentifier boolean

如果輸入識別碼有效,則為 True,否則為 false

ValidateUrlResponseFull

使用完整驗證驗證 URL 的結果

名稱 路徑 類型 Description
有效網址
ValidURL boolean

如果 URL 具有有效的語法、有效的網域、有效的端點,且已通過病毒掃描檢查,則為 True;false 否則

Valid_Domain
Valid_Domain boolean

如果網域名稱有效且存在,則為 true,否則為 false

Valid_Endpoint
Valid_Endpoint boolean

如果端點已啟動且回應且通過病毒掃描檢查,則為 True,否則為 false

Valid_Syntax
Valid_Syntax boolean

如果 URL 具有有效的語法,則為 True,否則為 false

WellFormedURL
WellFormedURL string

URL 的格式正確版本

ValidateUrlResponseSyntaxOnly

僅使用語法驗證 URL 的結果

名稱 路徑 類型 Description
有效網址
ValidURL boolean

如果 URL 有效,則為 True,否則為 false

WellFormedURL
WellFormedURL string

URL 的格式正確版本

VatLookup回應

名稱 路徑 類型 Description
BusinessAddress
BusinessAddress string

商務位址

公司名稱
BusinessName string

企業名稱

國家代碼
CountryCode string

兩個字母的國家代碼

是有效
IsValid boolean

如果增值稅代碼有效,則為 True,否則為 false

增值稅號碼
VatNumber string

增值稅號碼

Whois回應

WHOIS 作業的結果

名稱 路徑 類型 Description
創建Dt
CreatedDt date-time

記錄的建立日期

原始文字記錄
RawTextRecord string

WHOIS 原始文字記錄

有效網域
ValidDomain boolean

如果網域有效,則為 True,如果無效,則為 false

Whois伺服器
WhoisServer string

用於查詢 WHOIS 資訊的伺服器(可能會根據查詢而改變)。