概述

电话号码查询 API是您获取电话号码详细信息(包括运营商详细信息、可携性状态和欺诈检测)的首选解决方案。此 API 支持E.164 格式的电话号码,确保全球兼容性。

主要特点

  • 运营商信息:识别服务提供商和网络类型。
  • 欺诈检测:检测与号码相关的潜在欺诈活动。
  • 可移植性状态:检查号码是否已移植到其他运营商。

速率限制

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 内部服务器错误

处理请求时发生内部错误时返回。

返回頂端