智能小程序OPENCARD
接入指南

注意事项

Webhook 服务要求

接口耗时不超过300ms

返回数据注意事项

在所有类目中，涉及跳转的链接（多媒体链接不算），在非特殊说明的情况下，只需要返回path
例如：
h5的真实跳转地址：”https://example.com/path/to/page?a=b&c=d"
接口数据返回只需：”/path/to/page?a=b&c=d”

小程序的跳转地址类似,只需要返回path路径和参数

  • 特殊情况1：
    • 如果跳转地址本来就是 “/“,跳转首页，可以用 “/?from=baidu” 替代,携带标识参数
  • 特殊情况2：
    • 如果跳转链接中有中文，需要对中文内容做urlencode，否则校验不通过

开发者接收到的请求数据注意事项

不同的类目，有不同的intent，开发这在接收到参数的时候有如下情况：

  • 开发者提交了什么intent，百度只发送相同的intent，解密后的数据如下：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    {
      "type": "sp_ala", // 固定值
      "srcid": "48011", //资源号
      "surface": "mobile", // 小程序请求；web_h5 为h5请求
      "intent": { //开发者提交的intent
        "lottery_name": "双色球",
        "lottery_province": ""
      }
    }

  • 百度在原有基础上携带location 信息给开发者

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
  "type": "sp_ala", // 固定值
  "srcid": "48011", //资源号
  "surface": "mobile", // 小程序请求；web_h5 为h5请求
  "intent": { //开发者提交的intent
    "lottery_name": "双色球",
    "lottery_province": ""
  },
  "location": { //用户所在的地理位置，可能无此值，开发者需要兼容（如没有获取到用户的地理位置信息）
    "province": "浙江", // 可能为空，开发者需要兼容处理
    "city": "杭州", // 可能为空，开发者需要兼容
  }
}
  • 百度在原有基础上携带query_info 信息给开发者
  • 如下场景：
    • 用户在北京海淀区 用手百输入 “在上海西瓜皮是什么垃圾”
    • 用户也可能输入 西瓜皮什么垃圾
    • 也可能没开定位的情况下 输入西瓜皮什么垃圾
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "type": "sp_ala", //固定值
  "srcid": "48025", //资源号,仅仅是举例的资源号
  "surface": "mobile", // 小程序请求；web_h5 为h5请求
  "intent": { //开发者提交的intent
    "trash": "西瓜皮"
  },
  "location": { //用户所在的地理位置，可能无此值，开发者需要兼容（如没有获取到用户的地理位置信息）
    "province": "上海", // 可能为空，开发者需要兼容处理
    "city": "上海", // 可能为空，开发者需要兼容处理
  },
  "query_info": { // 用户检索词中出现的地点， 可能没有此值，开发者需要兼容
    "query_province": "北京", // 可能为空，开发者需要兼容处理
    "query_county": "海淀", // 可能为空，开发者需要兼容处理
  }
}

以上信息为通用注意事项，不同类目可能有不同的需求，如无特殊注明，请参考本注意事项

查看数据 更新intent
反 馈帮 助 回 到顶 部