百度小程序API提交

什么是小程序 API 提交？与上传 sitemap 文件有何区别

小程序 API 提交是将小程序资源提交到搜索的一种方式，即开发者可通过请求 API 接口，将小程序资源 path 路径，提交到 API 接口中。相比于上传 sitemap 文件，API 提交方式能给用户更便捷的提交体验，两种方式都会占用当日提交配额。有较大资源量需提交时，建议分次推送，每次不超过 1000 条。

请求路径

POST https://openapi.baidu.com/rest/2.0/smartapp/access/submitsitemap/api?access_token=ACCESS_TOKEN

参数说明

参数名	类型	是否必须	描述	示例
access_token	string	是	权限校验 Token
type	int	是	通过 TYPE 字段选择上传接口。 · 0：周级提交，一周左右生效； · 1：天级提交，2~3 天生效； · 2：小时级提交，1 小时内生效；	0
url_list	string	是	小程序 path 集合，多个 path 用逗号分隔。 · 天级/周级配额会根据开发者在前一周的周一至周五提交资源活跃度及资源质量，于次周一进行动态调整，具体以平台显示为准。	/pages/index1?id=1,/pages/index2

提交代码示例

python3 提交示例

import requests
url = "https://openapi.baidu.com/rest/2.0/smartapp/access/submitsitemap/api?access_token=ACCESS_TOKEN"
path_list = "/pages/index1,/pages/index2"
data = {"type": 1, "url_list": path_list}  
res = requests.post(url=url, data=data) 
print(res.text)

curl 提交示例

curl -H "application/x-www-form-urlencoded" -X POST -d 'type=1&url_list=/pages/index1,/pages/index2" "https://openapi.baidu.com/rest/2.0/smartapp/access/submitsitemap/api?access_token=ACCESS_TOKEN" 

java 提交示例

 String url = "https://openapi.baidu.com/rest/2.0/smartapp/access/submitsitemap/api?access_token=ACCESS_TOKEN";

 List<String> list = new ArrayList<>();
 list.add("/pages/index/test");
 list.add("/pages/index/test2?id=1");
 list.add("/pages/index/test3/query?id=1&age=10");
 // 设置请求参数
 paramMap.put("url_list",list);
 paramMap.put("type",0);
 HttpClient httpClient = new HttpClient();
 httpClient.getHttpConnectionManager().getParams().setConnectionTimeout(15000);
 PostMethod postMethod = new PostMethod(url);
 postMethod.getParams().setParameter(HttpMethodParams.SO_TIMEOUT, 60000);
        
        .
        .
        .
 //执行POST方法post方法
 int statusCode = httpClient.executeMethod(postMethod);

php 提交示例

<?php
$urls = array(
    '/pages/index/test',
    '/pages/index/test2?id=1',
);
$data['type'] = 1;
$data['url_list'] = implode(",", $urls);
$api = 'https://openapi.baidu.com/rest/2.0/smartapp/access/submitsitemap/api?access_token=ACCESS_TOKEN';
$ch = curl_init();
$options =  array(
    CURLOPT_URL => $api,
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_NOBODY => false,
    CURLOPT_POSTFIELDS => http_build_query($data),
    CURLOPT_HTTPHEADER => array('Content-Type: application/x-www-form-urlencoded'),
);
curl_setopt_array($ch, $options);
$result = curl_exec($ch);
echo $result;
?>

返回值示例

SEO资讯

{
  "errno": 0,
  "msg": "success"
}

错误码说明

错误码	错误描述
0	成功
-1024	业务异常，请稍后再试
500	对不起，服务器出错了，请稍候再试
2002	小程序不存在/选择的收录级别不合法/url 数量不合法
30001	参数有误，请检查后再试
100110007	数量超上限
47005	文件上传失败，请稍后再试
2	服务暂时不可用，请稍后再试
4	该 API 的流量超过了流控限制，请降低访问频率后再试
6	没有权限访问该 API，请确认授权
100	请确认当前为 https 访问且 access_token 参数不可为空
110	access_token 不合法，请核查后重试
111	access_token 过期，请更新后再试