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响应唯一码必须用于跟踪每次请求记录的唯一标识
phone_detectionObject手机号探测结果必须
account_infoObject账户信息必须
history_infoObject历史信息必须
  • account_info 数据字典
字段类型含义建议备注
phone_numberString手机号必须
validBoolean是否有效必须
carrierString运营商必须
activeString是否可用必须枚举值：YES, NO, UNKNOWN
scoreString该手机号诈欺的可能性，越高代表风险越高必须范围：0-999
typeString类型必须基于号码的电话类型。 类型有：premium rate, toll free, shared cost, voip, personal number, pager, uan, voicemail, fixed line, mobile, unknown
total_registeredInt社交网站注册个数必须
registration_detailArray注册详情必须
  • registration_detail数据字典
字段类型含义建议备注
account_typeString账户类型必须检测的社交网站如下:google, bukalapak, facebook, twitter, instagram, microsoft, telegram, whatsapp
viber, skype, amazon, linkedin
registeredBoolean/Int是否注册必须
account_nameString/Int名称必须仅出现于：viber、skype
profile_photoString/Int照片必须仅出现于：telegram、whatsapp、viber、skype
last_seenString/Int最后一次出现必须仅出现于：telegram、whatsapp、viber
account_countryString/Int账户所在国家必须仅出现于：skype
account_cityString/Int账户所在城市必须仅出现于：skype
account_stateString/Int账户所在州必须仅出现于：skype
account_idString/Int账户id必须仅出现于：google、skype
account_languageString/Int账户语言必须仅出现于：skype
full_nameString/Int全名必须仅出现于：google
profile_genderString/Int个人资料性别必须仅出现于：skype,
1: Male;2: Female
profile_ageString/Int个人资料年龄必须仅出现于：skype
profile_bioString/Int个人资料的生物文本必须仅出现于:skype
profile_aboutString/Int关于个人介绍的文本。必须仅出现于:whatsapp
profile_handleString/Int个人资料的handle必须仅出现于：skype
  • history_info 数据字典
字段类型含义建议备注
history_infoObject历史信息必须
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服务已过期否
11350Internal error系统错误否
11301{parameter} empty{参数}为空否
11304The country partner located is not open国家不支持否
11340{parameter} error{参数}错误否

响应示例-成功

{
    "code": 200,
    "phone_detection": {
        "account_info": {
            "score": 150.0,
            "active": "YES",
            "valid": true,
            "carrier": "China Unicom",
            "total_registered": 1,
            "phone_number": "86176****5618",
            "type": "MOBILE",
            "registration_detail": [
                {
                    "account_type": "bukalapak",
                    "registered": -999
                },
                {
                    "account_type": "linkedin",
                    "registered": -999
                },
                {
                    "account_type": "amazon",
                    "registered": -999
                },
                {
                    "account_type": "whatsapp",
                    "last_seen": -999,
                    "profile_photo": -999,
                    "profile_about": -999,
                    "registered": false
                },
                {
                    "account_type": "skype",
                    "account_language": -999,
                    "profile_photo": -999,
                    "profile_gender": -999,
                    "registered": false,
                    "profile_bio": -999,
                    "profile_handle": -999,
                    "account_id": -999,
                    "profile_age": -999,
                    "account_name": -999,
                    "account_city": -999,
                    "account_country": -999,
                    "account_state": -999
                },
                {
                    "account_type": "twitter",
                    "registered": false
                },
                {
                    "account_type": "facebook",
                    "registered": false
                },
                {
                    "account_type": "telegram",
                    "last_seen": -999,
                    "profile_photo": -999,
                    "registered": false
                },
                {
                    "account_type": "google",
                    "account_id": -999,
                    "full_name": -999,
                    "registered": true
                },
                {
                    "account_type": "instagram",
                    "registered": false
                },
                {
                    "account_type": "microsoft",
                    "registered": false
                },
                {
                    "account_type": "viber",
                    "last_seen": -999,
                    "profile_photo": -999,
                    "account_name": -999,
                    "registered": false
                }
            ]
        },
        "history_info": {
            "customer_hits_time": 1,
            "first_seen": 1710842026,
            "hits_time": 1,
            "last_seen": 1710842026
        }
    },
    "sequence_id": "1710842026384800G104C24D38339515",
    "message": "success"
}

响应示例-失败

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