文档中心 > API类目 > 生活号(原服务窗)API

alipay.open.public.info.modify (生活号基础信息修改接口)

适用于口碑商户签约当面付2.0默认创建的服务窗(名称为“服务窗+时间戳”,头像为空),系统商需要通过该接口帮助口碑商户修改服务窗名称、头像、欢迎语基础信息,修改名称、头像需要上传相关资质材料,触发风控审核

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.open.public.info.modify
format String 40 仅支持JSON JSON
charset String 10 请求使用的编码格式,如utf-8,gbk,gb2312等 utf-8
sign_type String 10 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2
sign String 344 商户请求参数的签名串,详见签名 详见示例
timestamp String 19 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50
version String 3 调用的接口版本,固定为:1.0 1.0
notify_url String 256 支付宝服务器主动通知商户服务器里指定的页面http/https路径。 http://api.test.alipay.net/atinterface/receive_notify.htm
app_auth_token String 40 详见应用授权概述
biz_content String - 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
app_name String 可选 20 生活号名称,2-20个字之间;不得含有违反法律法规和公序良俗的相关信息;不得侵害他人名誉权、知识产权、商业秘密等合法权利;不得以太过广泛的、或产品、行业词组来命名,如:女装、皮革批发;不得以实名认证的媒体资质账号创建服务窗,或媒体相关名称命名服务窗,如:XX电视台、XX杂志等 生活号名称
logo_url String 可选 128 生活号头像地址,建议尺寸 320 x 320px,支持.jpg .jpeg .png 格式,小于1M。使用alipay.offline.material.image.upload上传,将得到的image_url回填与此处 http://pic.alipayobjects.com/e/201311/1ZQ
public_greeting String 可选 200 欢迎语 欢迎光临
license_url String 可选 128 营业执照地址,建议尺寸 320 x 320px,支持.jpg .jpeg .png 格式,小于1M。使用alipay.offline.material.image.upload上传,将得到的image_url回填与此处。 http://pic.alipayobjects.com/e/201311/1ZQ
shop_pics String [] 可选 128 门店照片地址,支持.jpg .jpeg .png格式,小于1M。使用alipay.offline.material.image.upload上传,将得到的image_url回填与此处。 http://pic.alipayobjects.com/e/201311/1ZQ
auth_pic String 可选 128 授权运营书图片地址,企业商户若为被经营方授权,需上传加盖公章的扫描件,支持.jpg .jpeg .png格式,小于1M。使用alipay.offline.material.image.upload上传,将得到的image_url回填与此处。 http://pic.alipayobjects.com/e/201311/1ZQ
introduction String 可选 100 简介 生活号简介
background_url String 可选 128 背景图片地址,建议尺寸 1600 x 1000px,支持.jpg .jpeg .png格式,小于1M。使用alipay.offline.material.image.upload上传,将得到的image_url回填与此处 http://pic.alipayobjects.com/e/201311/1ZQ

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
code String - 网关返回码,详见文档 40004
msg String - 网关返回码描述,详见文档 Business Failed
sub_code String - 业务返回码,详见文档 ACQ.TRADE_HAS_SUCCESS
sub_msg String - 业务返回码描述,详见文档 交易已被支付
sign String - 签名,详见文档 DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

响应参数

参数 类型 是否必填 最大长度 描述 示例值
audit_status String 必填 32 服务窗审核状态,申请成功后返回AUDITING,等待风控审核 AUDITING
audit_desc String 必填 256 服务窗审核状态描述 审核中

请求示例

  • JAVA
  • .NET
  • PHP
  • HTTP请求源码
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayOpenPublicInfoModifyRequest request = new AlipayOpenPublicInfoModifyRequest();
request.setBizContent("{" +
"\"app_name\":\"生活号名称\"," +
"\"logo_url\":\"http://pic.alipayobjects.com/e/201311/1ZQ\"," +
"\"public_greeting\":\"欢迎光临\"," +
"\"license_url\":\"http://pic.alipayobjects.com/e/201311/1ZQ\"," +
"      \"shop_pics\":[" +
"        \"http://pic.alipayobjects.com/e/201311/1ZQ\"" +
"      ]," +
"\"auth_pic\":\"http://pic.alipayobjects.com/e/201311/1ZQ\"," +
"\"introduction\":\"生活号简介\"," +
"\"background_url\":\"http://pic.alipayobjects.com/e/201311/1ZQ\"" +
"  }");
AlipayOpenPublicInfoModifyResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"alipay_open_public_info_modify_response":{
		"msg":"Success",
		"code":"10000",
		"audit_status":"AUDITING",
		"audit_desc":"审核中"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

  • JSON示例
{
	"alipay_open_public_info_modify_response":{
		"msg":"Service Currently Unavailable",
		"code":"20000",
		"sub_msg":"系统繁忙",
		"sub_code":"isp.unknow-error"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

错误码 错误描述 解决方案
PUBLIC_MODIFY_PARAM_ILLEGAL 名称、头像、欢迎语、背景图片、简介不能同时都为空 名称、头像、欢迎语、背景图片、简介至少传入一个
APPINFO_NOT_EXIST 公众账号信息不存在 检查输入的参数应用名称是否存在
PUBLIC_GREETING_OVERLIMT 欢迎语长度超过限制,只允许在200字以内 保证欢迎语长度在200字以内
APP_ORDER_AUDING_EXIST 服务窗有正在审核中的工单,不允许修改 等工单全部审核完毕再来修改
PUBLIC_ORDER_DAY_LIMIT 名称、头像、简介不允许修改,一个月只允许修改一次 下个自然月再申请
ILLEGAL_LOGO_URL 不合法的LOGO图片链接,如(http://dl.django.t.taobao.com/*** 请使用alipay.offline.material.image.upload上传图片) 请使用alipay.offline.material.image.upload上传图片
PUBLIC_LOGO_NOT_NULL 头像不能为空 请设置头像
ILLEGAL_LICENSE_URL 不合法的营业执照图片链接,如(http://dl.django.t.taobao.com/*** 请使用alipay.offline.material.image.upload上传图片) 请使用alipay.offline.material.image.upload上传图片
PUBLIC_GREETING_ILLEGAL 欢迎语中有敏感词,请修改 请检查欢迎语,保证没有敏感词
APP_NAME_LENGTH_LIMIT 服务窗名称长度超限,只允许在2~20个字 修改服务窗名称,保证长度在范围内
APP_NAME_ILLEGAL 服务窗名称包含敏感词,请更改另一名称 更换合法的服务窗名称
APP_NAME_EXIST 服务窗名称已存在,不允许使用该名称 重新换一个合法的服务窗名称
SYSTEM_ERROR 系统繁忙 请检查输入参数是否正确,或者稍后重试
PUBLIC_NAME_MODIFY_LIMIT 名称只允许修改一次 取消名称传参
INTRODUCTION_LENGTH_LIMIT 简介长度超限 修改简介,保证简介长度在限制范围内
ILLEGAL_BACKGROUND_URL 不合法的背景图片链接,如(http://dl.django.t.taobao.com/*** 请使用alipay.offline.material.image.upload上传图片) 请使用alipay.offline.material.image.upload上传图片

公共错误码

触发通知类型

通知类型 描述 默认开启
public_audit_failed 审核失败 1
public_audit_success 审核成功 1

触发通知字段

参数 类型 是否必填 最大长度 描述 示例值
audit_status String 必填 32 审核状态,参考通知类型 public_audit_failed
audit_desc String 必填 256 审核描述,如果审核驳回则有相关的驳回理由 名称不符合规范
audit_type String 必填 32 审核类型,NAME为名称、AVATAR为头像、INTRODUCTION为简介 AVATAR
app_id String 必填 64 调用发起者的appid,如果由服务商发起修改,该appid为服务商的appid 20160428102213699
life_app_id String 必填 64 被修改信息的生活号app_id 20160428102214601
notify_type String 必填 64 该通知的类型,可以根据该类型进行处理 alipay_public_audit_notify

触发通知示例

https://www.merchant.com/receive_notify.htm?notify_type=trade_status_sync&notify_id=91722adff935e8cfa58b3aabf4dead6ibe&notify_time=2017-02-16 21:46:15&sign_type=RSA2&sign=WcO+t3D8Kg71dTlKwN7r9PzUOXeaBJwp8/FOuSxcuSkXsoVYxBpsAidprySCjHCjmaglNcjoKJQLJ28/Asl93joTW39FX6i07lXhnbPknezAlwmvPdnQuI01HZsZF9V1i6ggZjBiAd5lG8bZtTxZOJ87ub2i9GuJ3Nr/NUc9VeY=&audit_status=public_audit_failed&audit_desc=名称不符合规范&audit_type=AVATAR&app_id=20160428102213699&life_app_id=20160428102214601&notify_type=alipay_public_audit_notify

异步通知验签方式

返回
顶部