淘宝开放平台

请求地址：

环境	HTTPS请求地址
正式环境	https://openapi.alipay.com/gateway.do

公共请求参数：

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	是	128	接口名称	alipay.eco.renthouse.room.concentration.sync
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
app_auth_token	String	否	40	详见应用授权概述
biz_content	String	是	-	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

参数	类型	是否必填	最大长度	描述	示例值
community_code	String	必须	11	小区Code和小区请求号必输入其一小区Code，详见文档 http://ecopublic.oss-cn-hangzhou.aliyuncs.com/eco/tpmogo/CommunityInfos/CommunityInfos.xls	021111
room_code	String	必须	10	KA内部存储的房源编号	1234565
floor_count	Number	必须	2	所在楼层数值范围：1-99，不能大于房屋总楼层	2
total_floor_count	Number	必须	2	房屋总楼层数值范围：1-99，不能小于所在楼层	6
bedroom_count	Number	必须	2	户型-房数值范围：1-26	2
parlor_count	Number	必须	2	户型-厅数值范围：0-10	1
toilet_count	Number	必须	2	户型-卫数值范围：0-10	1
room_area	String	必须	6	房间面积数值范围：5.00㎡-300.00㎡，支持小数点后面2位	88
rent_status	Number	必须	1	出租状态数值范围：1未租、2已租	1
room_status	Number	可选	1	房源初始上下架状态上架状态租房平台会展示该房间信息，下架状态反之	1：上架 0：下架
max_deposit_amount	Price	可选	9	集中式房源最大押金	数值范围：0-￥420000.00
ali_short_num	String	可选	20	阿里短号	阿里短号:17011111111
room_info_list	EcoRenthouseRoomInfoList []	可选	-	集中式房间列表
└ room_code String 可选 10 KA内部存储的房源编号 2149086 └ ka_room_id String 必填 10 KA内部存储的房房间ID 1 └ room_num String 必填 10 KA内部存储的房房间号 101 └ deposit_end_time Date 可选 8 房间参与免押金的到期日期YYYY-MM-dd 2017-08-10
intro	String	可选	400	房源描述字符串，最大字符长度400	房源描述
comm_req_id	String	可选	11	小区同步请求号	小区同步接口返回值
nickname	String	特殊可选	50	公寓别名是否必须:（新增）是/（修改）否	是
max_amount	String	特殊可选	10	集中式最高价格，支持小数点后面2位。新增时必输字段，修改时如果不转值则以上次接口调用值为准。	10000
room_configs	String []	可选	1	物品配置(房间) 2:空调;3:热水器;4:洗衣机;5:冰箱;6:电视;7:微波炉;8:燃气灶;9:抽油烟机;10:电磁炉;11:床;11:WIFI;12:书桌;13:衣柜;14:沙发;15:阳台;	2
pay_type	Number	必须	2	付款方式（1：付一，2：付二）	1
room_amount	Price	必须	8	租金数值范围：￥100.00 - ￥35000.00 ，支持小数点后面2位	100
foregift_amount	Price	必须	9	押金数值范围：0-￥420000.00	1000
other_amount	EcoRenthouseOtherAmount []	可选	-	其它费用
└ name String 可选 15 费用名称门卡费 └ amount Price 可选 8 30 费用金额 └ unit String 可选 5 费用单位元
free_begin_date	Date	可选	10	免押金开始时间 YYYY-MM-dd	2017-03-10
free_end_date	Date	可选	10	免押金结束时间 YYYY-MM-dd	2017-08-10
images	String []	必须	4000	通过"文件上传"接口返回的房源图片url路径。房间照片可录入0~10张,目前仅支持jpg、png、jpeg格式	["http://ecopublic-dev.img-cn-hangzhou.aliyuncs.com/PicSerTest/pic/uploadPicTest.jpg"]
owners_name	String	必须	15	管家姓名	sam
owners_tel	String	必须	20	管家电话手机号码，必须为400开头	400-8888-888
rent_type	Number	必须	1	出租类型 1：整租，2：合租	1
checkin_time	Date	必须	10	可入住时间 YYYY-MM-DD	2017-03-10

参数	类型	是否必填	最大长度	描述	示例值
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=

参数	类型	是否必填	最大长度	描述	示例值

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");
AlipayEcoRenthouseRoomConcentrationSyncRequest request = new AlipayEcoRenthouseRoomConcentrationSyncRequest();
request.setBizContent("{" +
"\"community_code\":\"021111\"," +
"\"room_code\":\"1234565\"," +
"\"floor_count\":2," +
"\"total_floor_count\":6," +
"\"bedroom_count\":2," +
"\"parlor_count\":1," +
"\"toilet_count\":1," +
"\"room_area\":\"88\"," +
"\"rent_status\":1," +
"\"room_status\":1.00," +
"\"max_deposit_amount\":1.00," +
"\"ali_short_num\":\"阿里短号:17011111111\"," +
"      \"room_info_list\":[{" +
"        \"room_code\":\"2149086\"," +
"\"ka_room_id\":\"1\"," +
"\"room_num\":\"101\"," +
"\"deposit_end_time\":\"2017-08-10\"" +
"        }]," +
"\"intro\":\"房源描述\"," +
"\"comm_req_id\":\"小区同步接口返回值\"," +
"\"nickname\":\"是\"," +
"\"max_amount\":\"10000\"," +
"      \"room_configs\":[" +
"        \"2\"" +
"      ]," +
"\"pay_type\":1," +
"\"room_amount\":100," +
"\"foregift_amount\":1000," +
"      \"other_amount\":[{" +
"        \"name\":\"门卡费\"," +
"\"amount\":1.00," +
"\"unit\":\"元\"" +
"        }]," +
"\"free_begin_date\":\"2017-03-10\"," +
"\"free_end_date\":\"2017-08-10\"," +
"      \"images\":[" +
"        \"[\\\"http://ecopublic-dev.img-cn-hangzhou.aliyuncs.com/PicSerTest/pic/uploadPicTest.jpg\\\"]\"" +
"      ]," +
"\"owners_name\":\"sam\"," +
"\"owners_tel\":\"400-8888-888\"," +
"\"rent_type\":1," +
"\"checkin_time\":\"2017-03-10\"" +
"  }");
AlipayEcoRenthouseRoomConcentrationSyncResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

IAopClient client = new DefaultAopClient("https://openapi.alipay.com/gateway.do", "app_id", "merchant_private_key", "json", "1.0", "RSA2", "alipay_public_key", "GBK", false);
AlipayEcoRenthouseRoomConcentrationSyncRequest  request= new AlipayEcoRenthouseRoomConcentrationSyncRequest() ;
request.BizContent="{" +
"\"community_code\":\"021111\"," +
"\"room_code\":\"1234565\"," +
"\"floor_count\":2," +
"\"total_floor_count\":6," +
"\"bedroom_count\":2," +
"\"parlor_count\":1," +
"\"toilet_count\":1," +
"\"room_area\":\"88\"," +
"\"rent_status\":1," +
"\"room_status\":1.00," +
"\"max_deposit_amount\":1.00," +
"\"ali_short_num\":\"阿里短号:17011111111\"," +
"      \"room_info_list\":[{" +
"        \"room_code\":\"2149086\"," +
"\"ka_room_id\":\"1\"," +
"\"room_num\":\"101\"," +
"\"deposit_end_time\":\"2017-08-10\"" +
"        }]," +
"\"intro\":\"房源描述\"," +
"\"comm_req_id\":\"小区同步接口返回值\"," +
"\"nickname\":\"是\"," +
"\"max_amount\":\"10000\"," +
"      \"room_configs\":[" +
"        \"2\"" +
"      ]," +
"\"pay_type\":1," +
"\"room_amount\":100," +
"\"foregift_amount\":1000," +
"      \"other_amount\":[{" +
"        \"name\":\"门卡费\"," +
"\"amount\":1.00," +
"\"unit\":\"元\"" +
"        }]," +
"\"free_begin_date\":\"2017-03-10\"," +
"\"free_end_date\":\"2017-08-10\"," +
"      \"images\":[" +
"        \"[\\\"http://ecopublic-dev.img-cn-hangzhou.aliyuncs.com/PicSerTest/pic/uploadPicTest.jpg\\\"]\"" +
"      ]," +
"\"owners_name\":\"sam\"," +
"\"owners_tel\":\"400-8888-888\"," +
"\"rent_type\":1," +
"\"checkin_time\":\"2017-03-10\"" +
"  }";
AlipayEcoRenthouseRoomConcentrationSyncResponse response=client.execute(request);
Console.WriteLine(response.Body);

$aop = new AopClient ();
$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
$aop->appId = 'your app_id';
$aop->rsaPrivateKey = '请填写开发者私钥去头去尾去回车，一行字符串';
$aop->alipayrsaPublicKey='请填写支付宝公钥，一行字符串';
$aop->apiVersion = '1.0';
$aop->signType = 'RSA2';
$aop->postCharset='GBK';
$aop->format='json';
$request = new AlipayEcoRenthouseRoomConcentrationSyncRequest ();
$request->setBizContent("{" .
"\"community_code\":\"021111\"," .
"\"room_code\":\"1234565\"," .
"\"floor_count\":2," .
"\"total_floor_count\":6," .
"\"bedroom_count\":2," .
"\"parlor_count\":1," .
"\"toilet_count\":1," .
"\"room_area\":\"88\"," .
"\"rent_status\":1," .
"\"room_status\":1.00," .
"\"max_deposit_amount\":1.00," .
"\"ali_short_num\":\"阿里短号:17011111111\"," .
"      \"room_info_list\":[{" .
"        \"room_code\":\"2149086\"," .
"\"ka_room_id\":\"1\"," .
"\"room_num\":\"101\"," .
"\"deposit_end_time\":\"2017-08-10\"" .
"        }]," .
"\"intro\":\"房源描述\"," .
"\"comm_req_id\":\"小区同步接口返回值\"," .
"\"nickname\":\"是\"," .
"\"max_amount\":\"10000\"," .
"      \"room_configs\":[" .
"        \"2\"" .
"      ]," .
"\"pay_type\":1," .
"\"room_amount\":100," .
"\"foregift_amount\":1000," .
"      \"other_amount\":[{" .
"        \"name\":\"门卡费\"," .
"\"amount\":1.00," .
"\"unit\":\"元\"" .
"        }]," .
"\"free_begin_date\":\"2017-03-10\"," .
"\"free_end_date\":\"2017-08-10\"," .
"      \"images\":[" .
"        \"[\\\"http://ecopublic-dev.img-cn-hangzhou.aliyuncs.com/PicSerTest/pic/uploadPicTest.jpg\\\"]\"" .
"      ]," .
"\"owners_name\":\"sam\"," .
"\"owners_tel\":\"400-8888-888\"," .
"\"rent_type\":1," .
"\"checkin_time\":\"2017-03-10\"" .
"  }");
$result = $aop->execute ( $request); 

$responseNode = str_replace(".", "_", $request->getApiMethodName()) . "_response";
$resultCode = $result->$responseNode->code;
if(!empty($resultCode)&&$resultCode == 10000){
echo "成功";
} else {
echo "失败";
}

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=alipay.eco.renthouse.room.concentration.sync&app_id=4966&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
"community_code":"021111",
"room_code":"1234565",
"floor_count":2,
"total_floor_count":6,
"bedroom_count":2,
"parlor_count":1,
"toilet_count":1,
"room_area":"88",
"rent_status":1,
"room_status":1.00,
"max_deposit_amount":1.00,
"ali_short_num":"阿里短号:17011111111",
      "room_info_list":[{
        "room_code":"2149086",
"ka_room_id":"1",
"room_num":"101",
"deposit_end_time":"2017-08-10"
        }],
"intro":"房源描述",
"comm_req_id":"小区同步接口返回值",
"nickname":"是",
"max_amount":"10000",
      "room_configs":[
        "2"
      ],
"pay_type":1,
"room_amount":100,
"foregift_amount":1000,
      "other_amount":[{
        "name":"门卡费",
"amount":1.00,
"unit":"元"
        }],
"free_begin_date":"2017-03-10",
"free_end_date":"2017-08-10",
      "images":[
        "[\"http://ecopublic-dev.img-cn-hangzhou.aliyuncs.com/PicSerTest/pic/uploadPicTest.jpg\"]"
      ],
"owners_name":"sam",
"owners_tel":"400-8888-888",
"rent_type":1,
"checkin_time":"2017-03-10"
  }

//为确保安全通信，需自行验证响应示例中的sign值是否为蚂蚁金服所提供。

JSON示例

{
	"alipay_eco_renthouse_room_concentration_sync_response":{
		"msg":"Success",
		"code":"10000"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

JSON示例

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

错误码	错误描述	解决方案
INVALID_PARAMETER	参数有误参数无效	检查输入参数的正确性
REPEAT_ROOM	您当前录入的房源已存在于系统中	检查大楼名+行政区+户型（房、厅、卫）+公寓别名是否有重复，判断唯一房源标准
INVALID_ROOMFLOORCOUNT	所在楼层数不能大于总楼层数	所在楼层数不能大于总楼层数
INVALID_COMMUNITYCODE	小区编码错误	合租房源单间房间号不能重复
INVALID_IMAGEURL	图片地址不合法	使用支付宝租房平台提供的文件上传链接
INVALID_IMAGETYPE	图片格式不正确,仅支持jpg、png、jpeg格式	输入正确的图片格式

公共错误码

开放生态API

alipay.eco.renthouse.room.concentration.sync (集中式房源同步)

公共参数

请求参数

公共响应参数

响应参数

请求示例

响应示例

异常示例

业务错误码

公共错误码