概述
电话号码查询 API是您获取电话号码详细信息(包括运营商详细信息、可携性状态和欺诈检测)的首选解决方案。此 API 支持E.164 格式的电话号码,确保全球兼容性。
主要特点
- 运营商信息:识别服务提供商和网络类型。
- 欺诈检测:检测与号码相关的潜在欺诈活动。
- 可移植性状态:检查号码是否已移植到其他运营商。
速率限制
- 多区域:每 60 秒 15 个请求 专用数据库
API 基本 URL
https://www.sent.dm/api
API 端点
GET /phone-lookup
概括
此端点允许您查找 E.164 格式的电话号码。它会返回包括运营商、可移植性和欺诈状态在内的综合数据。
请求参数
范围 | 在 | 必需的 | 类型 | 描述 |
---|---|---|---|---|
phone |
询问 | 真的 | 细绳 | E.164 格式的电话号码(例如+12345678900 )。必须符合以下模式:^\+[1-9]\d{1,14}$ |
回复
200 正常
成功的响应包含详细的电话号码信息。
{
"data": {
"country_code": "US",
"national_format": "(234) 567-8900",
"phone_number": "+12345678900",
"fraud": null,
"carrier": {
"mobile_country_code": "221",
"mobile_network_code": "01",
"name": "PTK sh.a./Vala",
"type": "mobile",
"error_code": null,
"normalized_carrier": ""
},
"caller_name": null,
"nnid_override": null,
"portability": {
"lrn": "234567XXXX",
"ported_status": "",
"ported_date": null,
"ocn": "6959",
"line_type": "mobile",
"spid": "",
"spid_carrier_name": "CELLCO PARTNERSHIP DBA VERIZON",
"spid_carrier_type": "",
"altspid": "",
"altspid_carrier_name": "",
"altspid_carrier_type": "",
"city": "MAHOPAC",
"state": "New York"
},
"valid_number": true,
"record_type": "number_lookup"
},
"poweredBy": "Powered by Sent.dm - [Visit Sent.dm](https://www.sent.dm)"
}
错误响应
400 错误请求
当电话号码格式不正确时发生 本·霍布斯 it工程师。
{
"error": "Invalid phone number format. Must be in E.164 format."
}
429 请求过多
当超出速率限制时触发 原创评论。
{
"error": "Rate limit exceeded. Please wait and try again."
}
500 内部服务器错误
处理请求时发生内部错误时返回。