IP地址查询

用户在搜索“IP 地址查询”等泛需求及具体 IP 地址的精准需求时，搜索结果页会展现 IP 地址查询卡片。用户可在结果页查看待资源方的头像、名称及提供的主要服务类型，并跳转到资源方落地页，进行 ip 地址查询操作。

示意图

泛需求

精准需求

intent 上传接口

当前资源 intent 意图参数

key	类型	含义	示例/说明
ip_address	string	服务类型	可选，提供的服务类型

通过平台上传 txt 文件

资源方需要将自己落地页数据能够覆盖的所有 intent 参数通过 txt 文件上传到平台上，txt 文件的具体要求参见接入流程-上传 Intent 数据。

当前资源分类 txt 上传文件内容示例如下：

1	{"ip_address":""}

注意：为了能够召回泛需求，必须上传一个空的 intent，此时资源方上传的数据为泛需求下召回的默认行业展会信息。

通过开放 API 上传

详细接入方式参见API 上传方式

Webhook API

发送给 webhook 的请求

公共字段

key	类型	含义	示例/说明
type	string	请求类型	在小程序阿拉丁下永远为 “sp_ala”
surface	string	搜索场景	mobile: 支持小程序的移动搜索，web_h5: 支持 H5 的移动搜索
srcid	string	资源编号	每个资源分类不同
intent	object	搜索意图参数	JSON 对象，每个资源分类不同
query_info	object	用户 query 中包含的查询需求信息	JSON 对象
query_info.query_ip	string	用户 query 中的具体 IP 地址，不为空时应优先使用该 IP 地址进行检索	“182.148.126.223”，可能为空

当前资源 srcid 资源编号

key	类型	含义	设定
srcid	string	资源编号	48052

当前资源的 intent 参数参考上节 “intent 上传接口“。

举例：发送给 webhook 的 JSON (解密后)

{
  "type": "sp_ala",
  "srcid": "48052",
  "surface": "mobile",
  "intent": {
    "ip_address": "",
    "ip": "182.148.126.223"
  },
  "query_info": {
    "query_ip": "182.148.126.155"
  }
}

从 webhook 返回的结果

外层通用数据字段

key	类型	含义	示例/说明
status	integer	结果状态码，0 代表正确，1 代表无结果， 2 代表请求参数错误，3 代表内部服务错误	0
msg	string	出错消息，当非 0 时提供	“”
data	object	要返回的资源数据内容	JSON 对象，每个资源分类不同

当前资源分类的 data object 字段内容

key	类型	要求	说明
url	string	必选	服务区跳转链接，跳转至能满足 IP 查询需求的落地页。url 字段需返回 H5 或智能小程序页面路径，例如“/page/of/target”；若跳转至 H5 或智能小程序首页（无路径），则需要返回“/?from=baidu”。
head_title	string	必选	头部标题文案，服务名称，如：“IP 地址查询”，最短 1 个字符
source_text	string	必选	头部副标题文案，服务提供者名称，如：“ip138”，最短 1 个字符
service_title	string	必选	服务区标题，泛需求 query 下，为用户的本机 ip（在 intent“ip”中下发）短答案，如：“本机 IP：182.148.126.223”；具体 ip 地址的精准需求 query 下（即 query_info.query_ip 不为空时），为该 ip 地址的归属地短答案，如：“四川省-成都市”
service_introduction	string	必选	服务区文案，1 行截断。泛需求 query 下，为对主要服务的描述，如：“点击查询更多 IP 地址归属地信息。”；具体 ip 地址的精准需求 query 下（即 query_info.query_ip 不为空时），为该 ip 地址本身，如“IP: 182.148.126.155”

举例：从 webhook 返回的 JSON (加密前)

{
  "status": 0,
  "msg": "",
  "data": {
    "url": "/page/of/target",
    "head_title": "IP地址查询",
    "source_text": "ip138",
    "service_title": "本机IP：182.148.126.223",
    "service_introduction": "点击查询更多IP地址归属地信息。"
  }
}

反馈建议

胎儿体重计算器星期计算器