通用场景
小程序修改基础信息。
本接口暂不支持已经上过架的小程序调用(只支持小程序首次上架之前修改信息)
本接口暂不支持已经上过架的小程序调用(只支持小程序首次上架之前修改信息)
本接口为文件上传类接口,与普通openapi接口的入参构造格式不同,如果您没有使用官方sdk发起openapi调用,自行构造http请求时,需要使用multipart/form-data格式发起请求,注意以下事项:
1. 文件参数单独作为一个part,key为参数名,内容为文件,需要携带完整文件名(例如:content-disposition: form-data; name="file_content"; filename="example.png"),缺少文件名或后缀,会提示为类型错误。
2. 其余参数,对于v2版本的协议,公共参数需要使用query传入,业务参数使用query或body传入,使用body时每个字段作为一个单独part;v3协议需要按接口约定位置传入
1. 文件参数单独作为一个part,key为参数名,内容为文件,需要携带完整文件名(例如:content-disposition: form-data; name="file_content"; filename="example.png"),缺少文件名或后缀,会提示为类型错误。
2. 其余参数,对于v2版本的协议,公共参数需要使用query传入,业务参数使用query或body传入,使用body时每个字段作为一个单独part;v3协议需要按接口约定位置传入
公共请求参数
业务请求参数
app_name|小程序名称可选string[3,40]
【描述】小程序名称。长度限制 3~30 个字符,仅支持包含中文、数字、英文、下划线、 、-。
如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。如果前期没有设置过该信息,则本次为必填。可通过查询当前小程序信息
【示例值】杭州支小宝潮流女装店
app_english_name|小程序应用英文名称可选string[3,30]
【描述】小程序应用英文名称。长度限制 3~30 个字符,仅支持包含中文、数字、英文、下划线、 、-。
如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。如果前期没有设置过该信息,则本次为必填。可通过查询当前小程序信息
【示例值】demoexample
app_slogan|小程序简介可选string[10,32]
【描述】小程序简介,一句话描述小程序功能,长度限制 10~32个字符。
如果前期已经设置过该信息,本次可不填,平台将会为你默认上传该信息。如果前期没有设置过该信息,则本次为必填。可通过查询当前小程序信息
【示例值】专注潮流女装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/mini/03l21r查询当前小程序信息
【示例值】这是一个小程序的描述这是一个小程序的描述这是一个小程序的描述这是一个小程序的描述
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/mini/03l21r查询当前小程序信息
注意:个人开发者不得使用企业类目。
【示例值】xs1001_xs2001_xs3002;xs1011_xs2089;xs1002_xs2008_xs3024
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.baseinfo.modify&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'app_name=杭州支小宝潮流女装店' \
-f 'app_english_name=demoexample' \
-f 'app_slogan=专注潮流女装20年等等' \
-f 'app_logo=@/home/admin/test.jpg' \
-f 'app_desc=这是一个小程序的描述这是一个小程序的描述这是一个小程序的描述这是一个小程序的描述' \
-f 'service_phone=13110101010' \
-f 'service_email=example@mail.com' \
-f 'mini_category_ids=xs1001_xs2001_xs3002;xs1011_xs2089;xs1002_xs2008_xs3024'
说明:本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_mini_baseinfo_modify_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息,修改参数后进行重试 |
application_type_not_miniapp | 该应用不是小程序类型 | 请使用小程序类型的应用 |
app_desc_is_blank | 应用描述为空 | 应用描述为空,请补充应用描述 |
cannot_modify_category_with_relation_version | 有非开发版本不能修改类目 | 存在审核中、灰度、审核驳回、上架状态的版本,不允许修改类目,如果不期望修改类目,不要传入类目id |
can_not_modify_base_info | 应用上架过,审核中,审核通过,下架过不允许修改,此时只允许提审时修改 | 请在其他状态下进行修改 |
category_is_blank | 类目为空 | 类目为空,请补充mini_category_ids |
category_num_is_invalid | 类目数量需要是1-4个 | 类目数量需要是1-4个 |
categoty_num_is_invalid | 小程序类目数量不合法 | 小程序类目数量需要在1-3之内 |
developer_info_not_exist | 开发者信息不存在 | 检查开发者信息是否存在 |
invalid_categoty | 非法的类目 | 请重新输入类目,检查类目是否存在 |
invalid_logo | 小程序logo错误 | 小程序logo只支持jpg,jpeg,png格式 |
invalid_logo_ext | 小程序logo格式错误 | 小程序logo只支持jpg,jpeg,png格式 |
invalid_mini_app_desc | 小程序应用描述长度超出范围 | 小程序应用描述长度超出范围(限制20-400个字符) |
invalid_mini_app_desc_length | 小程序应用描述长度超出范围(限制20-400个字符) | 小程序应用描述长度在20-400个字符 |
invalid_mini_app_en_name | 小程序英文名称只允许英文和数字 | 小程序英文名称只允许英文和数字 |
invalid_mini_app_en_name_length | 小程序英文名称长度超出范围(限制3-30个字符) | 请输入合法长度范围的小程序英文名称,3-30个字符 |
invalid_mini_app_name | 小程序中文名称只能包含中文、数字、英文、下划线、 、- | 小程序中文名称只能包含中文、数字、英文、下划线、 、- |
invalid_mini_app_name_length | 小程序中文名称长度超出范围(限制3-30个字符) | 小程序中文名称限制为3-30个字符 |
invalid_mini_app_service_email | 请输入正确的邮箱格式,例如example@domain.com | 请输入正确的邮箱格式,例如example@domain.com |
invalid_mini_app_service_phone | 只允许包含数字和-,5-30个字符 | 请重新输入小程序客服电话,只允许包含数字和-,5-30个字符 |
invalid_mini_app_slogan | 小程序应用简介错误 | 小程序应用简介长度超出范围(限制10-32个字符) |
invalid_mini_app_slogan_length | 小程序应用简介长度超出范围 | 小程序应用简介长度10-32个字符 |
logo_exceed_max_size | 小程序logo大小超出范围(限制2m内) | 小程序logo大小不得超过2m |
logo_height_not_equal_width | 小程序logo长宽比不是1:1 | 小程序logo长宽比需要为1:1 |
logo_is_blank | logo为空 | logo为空,请补充app_logo |
logo_size_exceed | logo大小不得超过2m | logo大小不得超过2m |
mini_app_desc_sensitive | 小程序应用描述存在敏感词 | 请重新输入小程序应用描述 |
mini_app_en_name_duplicate | 小程序英文名称重名 | 请重新输入小程序英文名称 |
mini_app_en_name_sensitive | 小程序英文名称包含敏感词 | 请重新输入小程序英文名称 |
mini_app_info_audit_contains | 已存在应用信息审核 | 已存在应用信息审核,请检查是否已在提审流程 |
mini_app_name_duplicate | 小程序中文名称重名 | 请重新输入小程序中文名称 |
mini_app_name_sensitive | 小程序中文名称存在敏感词 | 请重新输入小程序中文名称 |
mini_app_not_online | 应用状态非法 | 应用状态非法,请确认是否被处罚或应用处于预创建状态 |
mini_app_service_email_sensitive | 小程序客服邮箱存在敏感词 | 请重新输入小程序客服邮箱 |
mini_app_slogan_sensitive | 小程序应用简介中包含敏感词 | 请重新输入小程序应用简介 |
modify_params_are_blank | 修改的参数全部为空 | 请至少指定一个修改参数 |
not_allow_beta_category | 选择的类目正在内测阶段,暂不支持公开选择 | 通过邮件申请使用此类目 |
op_frequency_limit | 操作频率过快被限流 | 降低提交频率 |
private_not_allow_category | 个人开发者不允许使用企业类目 | 建议模板实例化的开发者,如果通过服务市场帮商户创建小程序,建议将模板发布设置为不允许个人订购 1. 个体工商户或企业:根据类目要求查看账户类型要求,并按照要求完成账户升级。详情参见 https://opendocs.alipay.com/mini/operation/standard/category/material 2. 个人开发者:类目更换为个人可用的类目,个人可用的类目可以通过https://opendocs.alipay.com/apis/api_49/alipay.open.mini.category.query 查询 |
risk_decision_check_fail | 内容涉及不规范用语,请重新修改 | 请检查提审的应用信息是否存在不规范用语 |
risk_decision_hit_brand | 小程序名称涉及品牌词,请完成品牌认证(https://ipr.alipay.com/brand)后,再次提审。若您认为名称不涉及品牌/商标,属于系统误判,请联系 95188 | 小程序名称涉及品牌词,请完成品牌认证(https://ipr.alipay.com/brand)后,再次提审。若您认为名称不涉及品牌/商标,属于系统误判,请联系 95188 |
service_tel_and_mail_both_blank | 服务电话和邮箱同时为空 | 请录入服务电话或邮箱其中之一 |
slogan_is_blank | 应用简介为空 | 应用简介为空,请补充app_slogan |