开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
开发文档(v3版) 
支付
私域
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
小程序开发管理
接入指南
api 列表
小程序基础信息
小程序开发版本
小程序应用成员
小程序类目
小程序二维码
代创建小程序
小程序域名
插件管理
小程序备案
生物核身
交易组件
小程序商品
支付有礼
小游戏
公域
营销
资金
会员
信用
安全
广告
小程序云
其他
api文档 > 私域 > 小程序产品 > 权限集列表 > 小程序开发管理 > api 列表 >  > 小程序修改基础信息接口
文档更新记录 >
收藏
订阅更新
我的文档
设置

接口说明

接口英文名称:alipay.open.mini.baseinfo.modify
请求url:https://openapi.alipay.com/v3/alipay/open/mini/baseinfo/modify
请求方式:post
path指该参数为路径参数
query指该参数需在请求url传参
body指该参数需在请求json传参
小程序修改基础信息。
本接口暂不支持已经上过架的小程序调用(只支持小程序首次上架之前修改信息)

公共请求参数

参数类型是否必选最大长度描述示例值
authorizationstring必选1024
请求身份信息,参考验签规则。在header参数中传递
content-typestring可选32
报文内容格式,默认需要使用application/json,加密请求使用text/plain,参考请求规则。在header参数中传递
application/json
x-http-method-overridestring可选16
http方法,对于部分不支持put、patch、delete等操作的情况,可以使用post发送请求,并通过该参数传输实际需要使用的http method,参考请求规则。在header参数中传递
put
alipay-request-idstring可选32
调用方的requestid,用于定位一次请求,需要每次请求保持唯一。排查问题时可以提供该字段,参考请求规则。在header参数中传递。
0ba7cddb1665744697169391253118
alipay-encrypt-typestring可选16
加密算法,请求使用加密能力时,需要指定加密算法,参考加解密规则。在header参数中传递
aes
alipay-root-cert-snstring可选128
支付宝根证书序列号。证书模式时,可传入该参数,支付宝服务端会校验序列号,确保调用方的证书未被篡改,参考验签规则。在header参数中传递
687b59193f3f462dd5336e5abf83c5d8_02941eef3187dddf3d3b83462e1dfcf6
alipay-app-auth-tokenstring可选128
应用授权令牌,参考代调用规则。在header参数中传递
201509bbeff9351ad1874306903e96b91d248a36

业务请求参数

body参数
app_name|小程序名称可选string[3,40]
【描述】小程序名称。长度限制 3~30 个字符,仅支持包含中文、数字、英文、下划线、 、-。 如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。如果前期没有设置过该信息,则本次为必填。可通过alipay.open.mini.baseinfo.query查询当前小程序信息
【示例值】杭州支小宝潮流女装店
app_english_name|小程序应用英文名称可选string[3,30]
【描述】小程序应用英文名称。长度限制 3~30 个字符,仅支持包含中文、数字、英文、下划线、 、-。 如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。如果前期没有设置过该信息,则本次为必填。可通过alipay.open.mini.baseinfo.query查询当前小程序信息
【示例值】demoexample
app_slogan|小程序简介可选string[10,32]
【描述】小程序简介,一句话描述小程序功能,长度限制 10~32个字符。 如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。如果前期没有设置过该信息,则本次为必填。可通过alipay.open.mini.baseinfo.query查询当前小程序信息
【示例值】专注潮流女装20年等等
app_logo|小程序logo图标可选byte[][0,2097152]
【描述】小程序logo图标,图片格式仅支持 jpeg,png,jpg,png,jpg ,jpeg格式,不支持 bmp,gif,bmp,gif格式。建议上传像素为180*180 px,logo图片最大 2m,图片高度与宽度必须一致。 如果不填默认采用当前小程序 logo 图标。如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。如果前期没有设置过该信息,则本次为必填。
【示例值】1
app_desc|小程序描述可选string[20,400]
【描述】小程序描述,长度限制 20~400 个字符。 如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。如果前期没有设置过该信息,则本次为必填。可通过https://opendocs.alipay.com/open-v3/c5995fc4_alipay.open.mini.baseinfo.query查询当前小程序信息
【示例值】这是一个小程序的描述这是一个小程序的描述这是一个小程序的描述这是一个小程序的描述
service_phone|小程序客服电话可选string[5,30]
【描述】小程序客服电话,长度限制5~30个字符,仅支持包含数字和-。如果不填默认采用当前小程序的应用客服电话,小程序客服电话和邮箱至少输入一个。如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。 注意:2021年7月1日后,该字段将逐步灰度为必填字段,请按必填开发。
【示例值】13110101010
service_email|小程序客服邮箱可选string[0,128]
【描述】小程序客服邮箱,如果不填默认采用当前小程序的应用客服邮箱,小程序客服电话和邮箱至少输入一个。如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。 注意:2021年7月1日后,该字段将逐步灰度为可选字段,请按可选开发。
【示例值】example@mail.com
mini_category_ids|新小程序前台类目可选string[0,100]
【描述】新小程序前台类目,格式为 第一个一级类目_第一个二级类目;第二个一级类目_第二个二级类目_第二个三级类目,详细类目可以通过 接口查询mini_category_list。 如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。如果前期没有设置过该信息,则本次为必填。可通过https://opendocs.alipay.com/open-v3/c5995fc4_alipay.open.mini.baseinfo.query查询当前小程序信息 注意:个人开发者不得使用企业类目。
【示例值】xs1001_xs2001_xs3002;xs1011_xs2089;xs1002_xs2008_xs3024
常见请求示例
curl -x post \
 "https://openapi.alipay.com/v3/alipay/open/mini/baseinfo/modify" \
 -h "authorization: alipay-sha256withrsa app_id=${appid},timestamp=${now},nonce=${uuid},expired_seconds=600,sign=${sign}" \
 -h "alipay-request-id: ${requestid}" \
 -h "alipay-app-auth-token: ${app_auth_token}" \
 -h "content-type: multipart/form-data" \
 -f app_logo=@/home/admin/test.jpg \
 -f 'data={
	"app_name":"杭州支小宝潮流女装店",
	"app_english_name":"demoexample",
	"app_slogan":"专注潮流女装20年等等",
	"app_desc":"这是一个小程序的描述这是一个小程序的描述这是一个小程序的描述这是一个小程序的描述",
	"service_phone":"13110101010",
	"service_email":"example@mail.com",
	"mini_category_ids":"xs1001_xs2001_xs3002;xs1011_xs2089;xs1002_xs2008_xs3024"
};type=application/json'
说明:本示例仅供参考。

公共响应参数

参数中文名参数英文名类型是否必选最大长度描述示例值
支付宝响应时间戳alipay-timestampstring可选32
unix时间戳,用于验签及问题排查,参考验签规则。在header参数中传递
1666004496123
支付宝响应签名alipay-signaturestring可选512
支付宝响应报文签名,参考验签规则。在header中返回
支付宝traceidalipay-traceidstring可选64
支付宝traceid ,用于排查问题使用,参考请求规则。在header中返回
0ba7cddb1665744697169391253118
支付宝随机串alipay-noncestring可选64
支付宝nonce标记,每次请求会生成不同的nonce,可用于防重放判断,参考请求规则。在header中返回
515cf24c2f78b13564e94c2a495695ab

业务响应参数

无业务响应参数
响应示例
{}
说明:本示例仅供参考。

公共错误码

前往查看

业务错误码

https://ipr.alipay.com/brand)后,再次提审。若您认为名称不涉及品牌/商标,属于系统误判,请联系 95188" class="ant-table-row ant-table-row-level-0">
状态码错误码错误描述凯发app官方网站的解决方案
400system_error系统繁忙
服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试
400invalid_parameter参数有误
请根据接口返回的参数非法的具体错误信息,修改参数后进行重试
400application_type_not_miniapp该应用不是小程序类型
请使用小程序类型的应用
400app_desc_is_blank应用描述为空
应用描述为空,请补充应用描述
400cannot_modify_category_with_relation_version有非开发版本不能修改类目
存在审核中、灰度、审核驳回、上架状态的版本,不允许修改类目,如果不期望修改类目,不要传入类目id
400can_not_modify_base_info应用上架过,审核中,审核通过,下架过不允许修改,此时只允许提审时修改
请在其他状态下进行修改
400category_is_blank类目为空
类目为空,请补充mini_category_ids
400category_num_is_invalid类目数量需要是1-4个
类目数量需要是1-4个
400categoty_num_is_invalid小程序类目数量不合法
小程序类目数量需要在1-3之内
400developer_info_not_exist开发者信息不存在
检查开发者信息是否存在
400invalid_categoty非法的类目
请重新输入类目,检查类目是否存在
400invalid_logo小程序logo错误
小程序logo只支持jpg,jpeg,png格式
400invalid_logo_ext小程序logo格式错误
小程序logo只支持jpg,jpeg,png格式
400invalid_mini_app_desc小程序应用描述长度超出范围
小程序应用描述长度超出范围(限制20-400个字符)
400invalid_mini_app_desc_length小程序应用描述长度超出范围(限制20-400个字符)
小程序应用描述长度在20-400个字符
400invalid_mini_app_en_name小程序英文名称只允许英文和数字
小程序英文名称只允许英文和数字
400invalid_mini_app_en_name_length小程序英文名称长度超出范围(限制3-30个字符)
请输入合法长度范围的小程序英文名称,3-30个字符
400invalid_mini_app_name小程序中文名称只能包含中文、数字、英文、下划线、 、-
小程序中文名称只能包含中文、数字、英文、下划线、 、-
400invalid_mini_app_name_length小程序中文名称长度超出范围(限制3-30个字符)
小程序中文名称限制为3-30个字符
400invalid_mini_app_service_email请输入正确的邮箱格式,例如example@domain.com
请输入正确的邮箱格式,例如example@domain.com
400invalid_mini_app_service_phone只允许包含数字和-,5-30个字符
请重新输入小程序客服电话,只允许包含数字和-,5-30个字符
400invalid_mini_app_slogan小程序应用简介错误
小程序应用简介长度超出范围(限制10-32个字符)
400invalid_mini_app_slogan_length小程序应用简介长度超出范围
小程序应用简介长度10-32个字符
400logo_exceed_max_size小程序logo大小超出范围(限制2m内)
小程序logo大小不得超过2m
400logo_height_not_equal_width小程序logo长宽比不是1:1
小程序logo长宽比需要为1:1
400logo_is_blanklogo为空
logo为空,请补充app_logo
400logo_size_exceedlogo大小不得超过2m
logo大小不得超过2m
400mini_app_desc_sensitive小程序应用描述存在敏感词
请重新输入小程序应用描述
400mini_app_en_name_duplicate小程序英文名称重名
请重新输入小程序英文名称
400mini_app_en_name_sensitive小程序英文名称包含敏感词
请重新输入小程序英文名称
400mini_app_info_audit_contains已存在应用信息审核
已存在应用信息审核,请检查是否已在提审流程
400mini_app_name_duplicate小程序中文名称重名
请重新输入小程序中文名称
400mini_app_name_sensitive小程序中文名称存在敏感词
请重新输入小程序中文名称
400mini_app_not_online应用状态非法
应用状态非法,请确认是否被处罚或应用处于预创建状态
400mini_app_service_email_sensitive小程序客服邮箱存在敏感词
请重新输入小程序客服邮箱
400mini_app_slogan_sensitive小程序应用简介中包含敏感词
请重新输入小程序应用简介
400modify_params_are_blank修改的参数全部为空
请至少指定一个修改参数
400not_allow_beta_category选择的类目正在内测阶段,暂不支持公开选择
通过邮件申请使用此类目
400op_frequency_limit操作频率过快被限流
降低提交频率
400private_not_allow_category个人开发者不允许使用企业类目
建议模板实例化的开发者,如果通过服务市场帮商户创建小程序,建议将模板发布设置为不允许个人订购 1. 个体工商户或企业:根据类目要求查看账户类型要求,并按照要求完成账户升级。详情参见 https://opendocs.alipay.com/mini/operation/standard/category/material 2. 个人开发者:类目更换为个人可用的类目,个人可用的类目可以通过 查询
400risk_decision_check_fail内容涉及不规范用语,请重新修改
请检查提审的应用信息是否存在不规范用语
400risk_decision_hit_brand小程序名称涉及品牌词,请完成品牌认证()后,再次提审。若您认为名称不涉及品牌/商标,属于系统误判,请联系 95188
小程序名称涉及品牌词,请完成品牌认证()后,再次提审。若您认为名称不涉及品牌/商标,属于系统误判,请联系 95188
400service_tel_and_mail_both_blank服务电话和邮箱同时为空
请录入服务电话或邮箱其中之一
400slogan_is_blank应用简介为空
应用简介为空,请补充app_slogan
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图