本产品适用于传入邮箱的社交网络/媒体注册、信息探测。

API 方式

Base URL

印尼节点：https://id.apitd.net/verification/kyc/emailverify/v1
新加坡节点：https://sg.apitd.net/verification/kyc/emailverify/v1
巴基斯坦节点：https://pk.apitd.net/verification/kyc/emailverify/v1

API

URL	请求方式	Content-Type	输出格式	字符集
api-base-url?partner_code=xxx&partner_key=xxx	POST	application/json	JSON	UTF-8

认证参数

字段	类型	含义	建议	备注
partner_code	String	合作方标识	必须	由 TD 分配
partner_key	String	合作方密钥	必须	由 TD 分配

请求参数

字段	类型	含义	建议	备注
id_number	String	身份证件 ID 号码	强烈建议	ID number
id_type	String	身份证件 ID 类型	强烈建议	枚举值: identity_card: 身份证 passport: 护照 driving_licence: 驾照 birth_certificate：出生证明 voter_card: 选民卡 tax_card: 税卡 social_security_card: 社会保障卡 others: 其他
phone_number	String	手机号 / 电话号码	强烈建议	最长19位，带国家码，例如：36301234567。如填入，需和国家匹配。
name	String	姓名	强烈建议
country	String	国家	必须	国家，必填. 两位国家码，符合 ISO 3166 标准。巴基斯坦站点只支持PK，印尼站点只支持ID
email	String	邮件	必须	个人邮箱地址，例如： test@hotmail.com

请求示例

{
    "country":"ID",
    "phone_number":"36301234567",
    "id_type":"identity_card",
    "id_number":"3310225629467",
    "name":"Joe",
    "email":"test@hotmail.com"
}

响应参数

字段	类型	含义	建议	备注
code	Integer	API 状态码	必须
message	String	状态信息	必须	在 API 异常状态下会输出具体的异常原因
sequence_id	String	响应唯一码	必须	用于跟踪每次请求记录的唯一标识
email_detection	Object	邮箱探测结果	必须
basic_info	Object	基本信息	必须
domain_info	Object	域名信息	必须
account_info	Object	账户信息	必须
breach_info	Object	breach信息	必须
history_info	Object	历史信息	必须

basic_info 数据字典

字段	类型	含义	建议	备注
email_address	String	邮件	必须
score	String	该邮件诈欺的可能性，越高代表风险越高	必须	范围：0-999
existence	Boolean	该邮件是否实际存在	必须
created_time	String	创建时间	必须
updated_time	String	更新时间	必须
expires_time	String	过期时间	必须
registered_to	String	该邮件注册的公司名称	必须

domain_info 数据字典

字段	类型	含义	建议
dmarc_enforced	Boolean	是否为强制DMARC	必须
spf_strict	Boolean	SPF是否足够严格以防止欺骗	必须
valid_mx	Boolean	域的MX记录是否有效	必须
accept_all	Boolean	服务器是否设置为接收此域中的所有电子邮件。	必须
tld_suspicious	Boolean	顶级域是否可能具有欺诈性、风险性。	必须
website_exists	Boolean	电子邮件的域是否有网站	必须

account_info 数据字典

字段	类型	含义	建议	备注
total_registered	Int	社交网站注册个数	必须
registration_detail	Array	注册详情	必须

registration_detail数据字典

字段	类型	含义	建议	备注
account_type	String	社交网站类型	必须	检测的社交网站如下：facebook, google, apple, twitter, microsoft, yahoo, ebay, gravatar, instagram, spotify, tumblr, linkedin, weibo, github, vimeo, flickr, foursquare, lastfm, myspace, pinterest, skype, discord, ok, kakao, booking, airbnb, amazon, qzone , Adobe, mailru, wordpress, imgur, disneyplus, netflix, jdid, flipkart, bukalapak, archiveorg, lazada, zoho, samsung, evernote, envato, patreon, tokopedia, rambler, quora, atlassian
registered	Boolean/Int	是否注册	必须	是否注册
account_name	String/Int	账户名称	必须	仅出现于： facebook, linkedin, skype, gravatar
account_username	String/Int	账户用户名	必须	仅出现于Flickr、gravatar、github
profile_photo	String/Int	个人资料照片	必须	photo仅出现于: facebook, google, linkedin, skype, foursquare,github, flickr; imgae仅出现于airbnb
profile_url	String/Int	个人资料url	必须	仅出现于：facebook, linkedin, gravatar, foursquare, github
profile_company	String/Int	个人资料公司	必须	仅出现于：linkedin, github
profile_title	String/Int	个人资料title	必须	仅出现于：linkedin
profile_bio	String/Int	个人资料生物信息	必须	仅出现于foursquare, skype, github
profile_website	String/Int	个人资料网站	必须	仅出现于LinkedIn
profile_handle	String/Int	个人资料handle	必须	仅出现Skype
account_location	String/Int	账户所在地址	必须	仅出现于：linkedin，aribnb，gravatar、flickr、github
account_country	String/Int	账户所在国家	必须	仅出现于：skype
account_city	String/Int	账户所在城市	必须	仅出现于：skype, ok
account_state	String/Int	账户所在州	必须	仅出现于：skype
account_language	String/Int	账户语言	必须	仅出现于：skype
account_twitter	String/Int	账户关联Twitter	必须	仅出现于LinkedIn, github
profile_gender	String/Int	个人资料性别	必须	仅出现于：skype,1: Male;2: Female
profile_age	String/Int	个人资料年龄	必须	仅出现于：skype, ok
profile_id	String/Int	个人资料id	必须	仅出现Skype
account_joined_date	String/Int	账户加入时间	必须	仅出现于：ok
connection_count	String/Int	关联个数	必须	仅出现于：linkedin
reviewee_count	String/Int	个人资料上的评论者数量。	必须	仅出现于Airbnb
trips	String/Int	个人资料上的行程计数。	必须	仅出现于Airbnb
profile_firstname	String/Int	个人资料上的名	必须	仅出现于Airbnb
profile_work	String/Int	个人资料上的工作	必须	仅出现于Airbnb
profile_identity_verified	String/Int	基于配置文件设置的验证状态。	必须	仅出现于Airbnb

breach_info 数据字典

字段	类型	含义	建议	备注
breach_detail	Object	breach细节	必须
breach_platform	String	邮件泄露的平台名	条件必须	仅在有泄露时返回
breach_domain	String	邮件泄露的域名	条件必须	仅在有泄露时返回
breach_date	String	邮件泄露的日期	条件必须	仅在有泄露时返回
pwned_list	Boolean	电子邮件地址在数据泄露中是否遭到破坏。	必须
breach_number	Int	泄露次数	必须
breach_first_time	String	第一次泄露的时间	必须

history_info 数据字典

字段	类型	含义	建议
hits_time	Int	电子邮件地址被查询的次数	必须
customer_hits_time	Int	查询该邮箱的客户数（去重）	必须
first_seen	Int	任何客户第一次以 UNIX 时间格式和 UTC 时区查询电子邮件地址，没有毫秒。	必须
last_seen	Int	任何客户最后一次以 UNIX 时间格式和 UTC 时区查询电子邮件地址，没有毫秒。	必须

API状态码

code	Message	含义	是否收费
200	success	成功	是
300	Service not purchased or not effective	服务不可⽤	否
301	Service not purchased	服务未购买	否
302	Service has been suspend	服务已被禁⽤	否
303	Not enough balance	流量不足	否
304	Service expired	服务已过期	否
600	Service Temporarily Unavailable	服务超过限制	否
11350	Internal error	系统错误	否
11301	{parameter} empty	{参数}为空	否
11304	The country partner located is not open	国家不支持	否
11340	{parameter} error	{参数}错误	否

响应示例

{
    "code": 200,
    "email_detection": {
        "basic_info": {
            "created_time": "1995-08-13 04:00:00",
            "updated_time": "2023-07-11 10:10:13",
            "email_address": "test123@gmail.com",
            "existence": true,
            "registered_to": "Google LLC",
            "expires_time": "2024-08-12 04:00:00",
            "score": "150.0"          
        },
        "breach_info": {
            "breach_detail": [
                {
                    "breach_date": "2020-04-17",
                    "breach_domain": "tokopedia.com",
                    "breach_platform": "Tokopedia"
                }
            ],
            "breach_number": 1,
            "pwned_list": true,
            "breach_first_time": "2020-04-17"
        },
        "account_info": {
            "total_registered": 11,
            "registration_detail": [
                {
                    "account_type": "booking",
                    "registered": true
                },
                {
                    "account_type": "lazada",
                    "registered": false
                },
                {
                    "account_type": "lastfm",
                    "registered": false
                },
                {
                    "account_type": "wordpress",
                    "registered": false
                },
                {
                    "account_type": "instagram",
                    "registered": false
                },
                {
                    "account_type": "tokopedia",
                    "registered": true
                },
                {
                    "account_type": "microsoft",
                    "registered": true
                },
                {
                    "account_type": "airbnb",
                    "account_location": -999,
                    "profile_work": -999,
                    "profile_photo": -999,
                    "reviewee_count": -999,
                    "trips": -999,
                    "registered": -999,
                    "profile_identity_verified": -999,
                    "profile_firstname": -999
                },
                {
                    "account_type": "envato",
                    "registered": false
                },
                {
                    "account_type": "twitter",
                    "registered": false
                },
                {
                    "account_type": "yahoo",
                    "registered": false
                },
                {
                    "account_type": "github",
                    "account_location": -999,
                    "account_twitter": -999,
                    "profile_photo": -999,
                    "profile_url": -999,
                    "account_username": -999,
                    "registered": false,
                    "profile_website": -999,
                    "profile_bio": -999,
                    "profile_company": -999
                },
                {
                    "account_type": "archiveorg",
                    "registered": false
                },
                {
                    "account_type": "atlassian",
                    "registered": true
                },
                {
                    "account_type": "google",
                    "profile_photo": -999,
                    "registered": -999
                },
                {
                    "account_type": "patreon",
                    "registered": true
                },
                {
                    "account_type": "rambler",
                    "registered": false
                },
                {
                    "account_type": "amazon",
                    "registered": -999
                },
                {
                    "account_type": "mailru",
                    "registered": false
                },
                {
                    "account_type": "discord",
                    "registered": true
                },
                {
                    "account_type": "ebay",
                    "registered": -999
                },
                {
                    "account_type": "bukalapak",
                    "registered": -999
                },
                {
                    "account_type": "zoho",
                    "registered": false
                },
                {
                    "account_type": "foursquare",
                    "profile_photo": -999,
                    "profile_url": -999,
                    "registered": -999,
                    "profile_bio": -999
                },
                {
                    "account_type": "tumblr",
                    "registered": false
                },
                {
                    "account_type": "linkedin",
                    "account_location": -999,
                    "account_twitter": -999,
                    "profile_title": -999,
                    "profile_photo": -999,
                    "profile_url": -999,
                    "connection_count": -999,
                    "account_name": -999,
                    "registered": -999,
                    "profile_website": -999,
                    "profile_company": -999
                },
                {
                    "account_type": "netflix",
                    "registered": false
                },
                {
                    "account_type": "myspace",
                    "registered": false
                },
                {
                    "account_type": "apple",
                    "registered": false
                },
                {
                    "account_type": "skype",
                    "account_language": -999,
                    "profile_photo": -999,
                    "profile_gender": -999,
                    "registered": false,
                    "profile_bio": -999,
                    "profile_handle": -999,
                    "profile_age": -999,
                    "profile_id": -999,
                    "account_name": -999,
                    "account_city": -999,
                    "account_country": -999,
                    "account_state": -999
                },
                {
                    "account_type": "kakao",
                    "registered": -999
                },
                {
                    "account_type": "samsung",
                    "registered": true
                },
                {
                    "account_type": "weibo",
                    "registered": false
                },
                {
                    "account_type": "quora",
                    "registered": true
                },
                {
                    "account_type": "gravatar",
                    "account_location": -999,
                    "profile_url": -999,
                    "account_name": -999,
                    "account_username": -999,
                    "registered": false
                },
                {
                    "account_type": "evernote",
                    "registered": false
                },
                {
                    "account_type": "imgur",
                    "registered": false
                },
                {
                    "account_type": "ok",
                    "profile_age": -999,
                    "registered": false,
                    "account_city": -999,
                    "account_joined_date": -999
                },
                {
                    "account_type": "disneyplus",
                    "registered": false
                },
                {
                    "account_type": "jdid",
                    "registered": -999
                },
                {
                    "account_type": "facebook",
                    "profile_photo": -999,
                    "profile_url": -999,
                    "account_name": -999,
                    "registered": false
                },
                {
                    "account_type": "spotify",
                    "registered": true
                },
                {
                    "account_type": "flipkart",
                    "registered": false
                },
                {
                    "account_type": "adobe",
                    "registered": true
                },
                {
                    "account_type": "pinterest",
                    "registered": true
                },
                {
                    "account_type": "qzone",
                    "registered": false
                },
                {
                    "account_type": "vimeo",
                    "registered": false
                },
                {
                    "account_type": "flickr",
                    "account_location": -999,
                    "profile_photo": -999,
                    "account_username": -999,
                    "registered": false
                }
            ]
        },
        "domain_info": {
            "tld_suspicious": false,
            "spf_strict": true,
            "website_exists": true,
            "valid_mx": true,
            "accept_all": false,
            "dmarc_enforced": true
        },
        "history_info": {
            "first_seen": 1681768896,
            "last_seen": 1705384608,
            "hits_time": 18,
            "customer_hits_time": 3
        }
    },
    "sequence_id": "1705384917350000XA84A005A753****",
    "message": "success"
}

响应示例-失败

{
    "code": 11340,
    "sequence_id": "1720072040470369I30BC3538833****",
    "message": "Country error"
}