自然搜索结果接入
自然搜索结果接入
大搜-自然结果收录
当用户在360安全浏览器中搜索对应的360小程序的相关内容时,小程序的相关页面会被检索并出现在搜索结果页中。 大搜收录能够满足用户对于360小程序内的服务和信息的精准搜索需求。对于开发者来说,大搜收录能够把自己的详细服务或信息与用户的需求做精准匹配,完成用户的深度转化。
数据接入
360小程序支持通过调用sdk将自己的小程序信息加入到360搜索引擎收录,每调用一次接口上传一个条目。如需批量,请参考下方批量接口调用方式。收录成功之后,当用户在360搜索到开发者通过接口提交的关键词,搜索引擎会返回相应条目。
接入要求
开发者需要使用appId和appSecret对接口签名
接口地址
https://mp.360.cn/miniplatform/open/sdk/so(单条请求地址)https://mp.360.cn/miniplatform/open/sdk/somulti(批量请求地址,最大单次不超过100条)
POST消息体为JSON,放在HTTP Body中
请求头部
头部 | 中文名 | 参数类型 | 必填 | 备注 |
---|---|---|---|---|
X-API-KEY | appid | 字符串 | 是 | 如:qhje3zmxsmwm8112b6 |
X-API-TS | 时间戳 | 字符串 | 是 | 如:1566470506 |
X-API-SIGN | 签名值 | 字符串 | 是 | 参考下面签名方式 |
Content-Type | 签名值 | 字符串 | 否 | 调用批量接口时传此参数,值为:application/json |
接口请求参数
字段名 | 中文名 | 参数类型 | 必填 | 示例 | 备注 |
---|---|---|---|---|---|
id | 编号 | 字符串 | 是 | 432255443 | 小程序内部唯一标识,每个小程序每条记录唯一 |
op_type | 操作类型 | 字符串 | 是 | mod | add-新增 mod-修改 del-删除(删除时下面内容不填) |
title | 标题 | 字符串 | 是 | 中国动漫哪吒火到日本 | 最多200个字符 |
description | 摘要信息 | 字符串 | 是 | 中国动漫哪吒火到日本 | 最多500个字符 |
content | 正文信息 | 字符串 | 否 | 中国动漫哪吒火到日本 | 最多32768个字符 |
app_url | 页面地址 | 字符串 | 是 | pages/home/index | 小程序内页面路径,与全局配置中pages保持一致,路径最前面请不要填加'/'或'#'等任何符号 |
keywords | 内容关键词 | 字符串 | 否 | 电影 || 动画片 | 搜索引擎关键字,用 “||” 分隔 |
hot_score | 内容热度 | 整数 | 否 | 70 | 热度区间0-100,热度越高值越大,开发者小程序内的数据排序。 |
resource_type | 资源类型 | 字符串 | 是 | text | 有效值:text: 文本;video: 视频;audio: 音频 |
image_url | 图片/头图/封面 | 字符串 | 否 | http://*.jpg | |
author | 作者名 | 字符串 | 否 | 王小二 | |
comments | 评论内容 | 字符串 | 否 | 赞一个||国产好电影||好片 | 评论最多10条,用 “||” 分隔 |
pv | 页面浏览量/播放次数 | 整数 | 否 | 2300 | |
comment_cnt | 评论次数 | 整数 | 否 | 135 | |
up_vote_cnt | 点赞次数 | 整数 | 否 | 670 | |
down_vote_cnt | 点踩次数 | 整数 | 否 | 15 | |
duration | 视频/音频内容时长 | 整数 | 否 | 120 | 视频时长 单位:秒;视频/音频内容该字段为必填字段 |
代码示例(单条)
{
"app_url":" pages/home/index",
"author":"王小二",
"comment_cnt":135,
"comments":"赞一个||国产好电影||好片",
"content":"中国动漫哪吒火到日本",
"description":"中国动漫哪吒火到日本",
"down_vote_cnt":15,
"duration":120,
"hot_score":70,
"id":"432255443",
"image_url":"http://***.jpg",
"keywords":"电影||动画片",
"op_type":"mod",
"pv":2300,
"resource_type":"text",
"title":"中国动漫哪吒火到日本",
"up_vote_cnt":670,
}
代码示例(批量)
[
{
"op_type":"del" //op_type必须放在json体第一组元素中
},
{
"id":"1234256",
"app_url":" pages/home/index",
"author":"王小二",
"comment_cnt":135,
"comments":"赞一个22||国产好电影||好片",
"content":"中国动漫111哪吒火到日本",
"description":"中国动漫哪吒火到日本",
"down_vote_cnt":15,
"duration":120,
"hot_score":"qhje3zmxsmwm8112b6",
"image_url":"http://***.jpg",
"keywords":"电影||动画片",
"pv":2300,
"resource_type":"text",
"title":"中国动漫哪吒火到日本",
"up_vote_cnt":670
},
{
"id":"123456",
"app_url":" pages/home/index1",
"author":"王小三",
"comment_cnt":135,
"comments":"赞一个||国产好电影||好片",
"content":"动画片",
"description":"好看的动画",
"down_vote_cnt":15,
"duration":120,
"hot_score":"qhje3zmxsmwm8112b6",
"image_url":"http://***.jpg",
"keywords":"电影||动画片",
"pv":2300,
"resource_type":"text",
"title":"中国动漫很强大",
"up_vote_cnt":670
}
]
签名方式
各个字段按照字典序排序,值做base64处理, 使用&连接,最后加上key=&secret=<app_secret>&ts=<unix_timestamp>,将字符串做MD5的结果就是sign。
批量:与单条同理。
例如(单条):
appId=qhje3zmxsmwm8112b6, appSecret=punyp1xj97nmwqh69d1scrtn74vpabqx, 当前时间戳为1566470506 (单位秒, 时区为北京时间) 针对示例的json,拼接后的字符串如下:
app_url=IHBhZ2VzL2hvbWUvaW5kZXg=&author=546L5bCP5LqM&comment_cnt=MTM1&comments=6LWe5LiA5LiqfHzlm73kuqflpb3nlLXlvbF8fOWlveeJhw==&content=5Lit5Zu95Yqo5ryr5ZOq5ZCS54Gr5Yiw5pel5pys&description=5Lit5Zu95Yqo5ryr5ZOq5ZCS54Gr5Yiw5pel5pys&down_vote_cnt=MTU=&duration=MTIw&hot_score=NzA=&id=NDMyMjU1NDQz&image_url=aHR0cDovLyoqKi5qcGc=&keywords=55S15b2xfHzliqjnlLvniYc=&op_type=bW9k&pv=MjMwMA==&resource_type=dGV4dA==&title=5Lit5Zu95Yqo5ryr5ZOq5ZCS54Gr5Yiw5pel5pys&up_vote_cnt=Njcw&key=qhje3zmxsmwm8112b6&secret=punyp1xj97nmwqh69d1scrtn74vpabqx&ts=1566470506
计算MD5后的签名值为
4883e85415b45569e56d61cd2189da7e
批量
拼接后的字符串(示例): op_type=bW9k&app_url=cGFnZXMvaG9tZS9pbmRleA==&author=546L5bCP5LqM&comment_cnt=MTM1&comments=6LWe5LiA5LiqfHzlm73kuqflpb3nlLXlvbF8fOWlveeJhw==&content=5Lit5Zu95Yqo5ryr5ZOq5ZCS54Gr5Yiw5pel5pys&description=5Lit5Zu95Yqo5ryr5ZOq5ZCS54Gr5Yiw5pel5pys&down_vote_cnt=MTU=&duration=MTIw&hot_score=NzA=&id=NDMyMjU1NDQz&image_url=aHR0cDovLyoqKi5qcGc=&keywords=55S15b2xfHzliqjnlLvniYc=&pv=MjMwMA==&resource_type=dGV4dA==&title=5Lit5Zu95Yqo5ryr5ZOq5ZCS54Gr5Yiw5pel5pys&up_vote_cnt=Njcw&app_url=cGFnZXMvaG9tZS9pbmRleA==&author=546L5bCP5LiJ&comment_cnt=MTM1&comments=6LWeMuS4qnx85Zu95Lqn5aW955S15b2xfHzlpb3niYc=&content=5Lit5Zu95Yqo5ryr5ZOq5ZCS54Gr5Yiw5pel5pys&description=5Lit5Zu95Yqo5ryr5ZOq5ZCS54Gr5Yiw5pel5pys&down_vote_cnt=MTU=&duration=MTIw&hot_score=NzA=&id=NDMyMjU1NDQz&image_url=aHR0cDovLyoqKi5qcGc=&keywords=55S15b2xfHzliqjnlLvniYc=&pv=MjMwMA==&resource_type=dGV4dA==&title=5Lit5Zu95Yqo5ryr5ZOq5ZCS54Gr5Yiw5pel5pys&up_vote_cnt=Njcw&key=qheejtaunxfk8pj2p9&secret=punyp1xj97nmwqh69d1scrtn74vpabqx&ts=1575367123
签名值为:
0e835bdb852692a8c8f4bd28f164ea4c
注:360 将会对违规使用搜索收录的开发者进行封禁处理。