TrustDecision
API Reference
English

邮箱探测

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

API 方式

Base URL

API

URL请求方式Content-Type输出格式字符集
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonJSONUTF-8

认证参数

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

请求参数

字段类型含义建议备注
id_numberString身份证件 ID 号码强烈建议ID number
id_typeString身份证件 ID 类型强烈建议枚举值:

1. identity_card: 身份证
2. passport:护照
3. driving_licence: 驾照
4. birth_certificate：出生证明
5. voter_card: 选民卡
6. tax_card: 税卡
7. social_security_card: 社会保障卡
8. others: 其他
phone_numberString手机号 / 电话号码强烈建议最长19位，带国家码，例如：36301234567。如填入，需和国家匹配。
nameString姓名强烈建议
countryString国家必须国家，必填. 两位国家码，符合 ISO 3166 标准。
巴基斯坦站点只支持PK，印尼站点只支持ID
emailString邮件必须个人邮箱地址，例如：[email protected]

请求示例

{
    "country":"ID",
    "phone_number":"36301234567",
    "id_type":"identity_card",
    "id_number":"3310225629467",
    "name":"Joe",
    "email":"[email protected]"
}

响应参数

字段类型含义建议备注
codeIntegerAPI 状态码必须
messageString状态信息必须在 API 异常状态下会输出具体的异常原因
sequence_idString响应唯一码必须用于跟踪每次请求记录的唯一标识
email_detectionObject邮箱探测结果必须
basic_infoObject基本信息必须
domain_infoObject域名信息必须
account_infoObject账户信息必须
breach_infoObjectbreach信息必须
history_infoObject历史信息必须
  • basic_info 数据字典
字段类型含义建议备注
email_addressString邮件必须
scoreString该邮件诈欺的可能性，越高代表风险越高必须范围：0-999
existenceBoolean该邮件是否实际存在必须
created_timeString创建时间必须
updated_timeString更新时间必须
expires_timeString过期时间必须
registered_toString该邮件注册的公司名称必须
  • domain_info 数据字典
字段类型含义建议备注
dmarc_enforcedBoolean是否为强制DMARC必须
spf_strictBooleanSPF是否足够严格以防止欺骗必须
valid_mxBoolean域的MX记录是否有效必须
accept_allBoolean服务器是否设置为接收此域中的所有电子邮件。必须
tld_suspiciousBoolean顶级域是否可能具有欺诈性、风险性。必须
website_existsBoolean电子邮件的域是否有网站必须
  • account_info 数据字典
字段类型含义建议备注
total_registeredInt社交网站注册个数必须
registration_detailArray注册详情必须
  • registration_detail数据字典
字段类型含义建议备注
account_typeString社交网站类型必须检测的社交网站如下：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
registeredBoolean/Int是否注册必须是否注册
account_nameString/Int账户名称必须仅出现于： facebook, linkedin, skype, gravatar
account_usernameString/Int账户用户名必须仅出现于Flickr、gravatar、github
profile_photoString/Int个人资料照片必须photo仅出现于: facebook, google, linkedin, skype, foursquare,github, flickr; imgae仅出现于airbnb
profile_urlString/Int个人资料url必须仅出现于：facebook, linkedin, gravatar, foursquare, github
profile_companyString/Int个人资料公司必须仅出现于：linkedin, github
profile_titleString/Int个人资料title必须仅出现于：linkedin
profile_bioString/Int个人资料生物信息必须仅出现于foursquare, skype, github
profile_websiteString/Int个人资料网站必须仅出现于LinkedIn
profile_handleString/Int个人资料handle必须仅出现Skype
account_locationString/Int账户所在地址必须仅出现于：linkedin，aribnb，gravatar、flickr、github
account_countryString/Int账户所在国家必须仅出现于：skype
account_cityString/Int账户所在城市必须仅出现于：skype, ok
account_stateString/Int账户所在州必须仅出现于：skype
account_languageString/Int账户语言必须仅出现于：skype
account_twitterString/Int账户关联Twitter必须仅出现于LinkedIn, github
profile_genderString/Int个人资料性别必须仅出现于：skype,1: Male;2: Female
profile_ageString/Int个人资料年龄必须仅出现于：skype, ok
profile_idString/Int个人资料id必须仅出现Skype
account_joined_dateString/Int账户加入时间必须仅出现于：ok
connection_countString/Int关联个数必须仅出现于：linkedin
reviewee_countString/Int个人资料上的评论者数量。必须仅出现于Airbnb
tripsString/Int个人资料上的行程计数。必须仅出现于Airbnb
profile_firstnameString/Int个人资料上的名必须仅出现于Airbnb
profile_workString/Int个人资料上的工作必须仅出现于Airbnb
profile_identity_verifiedString/Int基于配置文件设置的验证状态。必须仅出现于Airbnb
  • breach_info 数据字典
字段类型含义建议备注
breach_detailObjectbreach细节必须
breach_platformString邮件泄露的平台名条件必须仅在有泄露时返回
breach_domainString邮件泄露的域名条件必须仅在有泄露时返回
breach_dateString邮件泄露的日期条件必须仅在有泄露时返回
pwned_listBoolean电子邮件地址在数据泄露中是否遭到破坏。必须
breach_numberInt泄露次数必须
breach_first_timeString第一次泄露的时间必须
  • history_info 数据字典
字段类型含义建议备注
hits_timeInt电子邮件地址被查询的次数必须
customer_hits_timeInt查询该邮箱的客户数（去重）必须
first_seenInt任何客户第一次以 UNIX 时间格式和 UTC 时区查询电子邮件地址，没有毫秒。必须
last_seenInt任何客户最后一次以 UNIX 时间格式和 UTC 时区查询电子邮件地址，没有毫秒。必须

API状态码

codeMessage含义是否收费
200success成功是
300Service not purchased or not effective服务不可⽤否
301Service not purchased服务未购买否
302Service has been suspend服务已被禁⽤否
303Not enough balance流量不足否
304Service expired服务已过期否
600Service Temporarily Unavailable服务超过限制否
11350Internal error系统错误否
11301{parameter} empty{参数}为空否
11304The 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": "[email protected]",
            "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"
}