文档中心 > API类目 > 车主服务API

alipay.eco.mycar.parking.parkinglotinfo.create (录入停车场信息)

录入停车场信息,内容信息通过该接口提交到支付宝,支付宝会生成支付宝这边停车场ID反馈给开发者,用户后续更新和上送车辆信息。

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.eco.mycar.parking.parkinglotinfo.create
format String 40 仅支持JSON JSON
charset String 10 请求使用的编码格式,如utf-8,gbk,gb2312等 utf-8
sign_type String 10 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2
sign String 256 商户请求参数的签名串,详见签名 详见示例
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 - 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
city_id String 必须 6 城市编号(国家统一标准编码),请务必填写正确,详见 点此下载 110101
equipment_name String 可选 512 设备商名称 杭州立方
out_parking_id String 必须 28 ISV停车场ID,由ISV提供,同一个isv或商户范围内唯一 10000110001
parking_address String 必须 512 停车场地址 浙江省杭州市古墩路与疏港公路的交汇处
longitude String 必须 15 经度,最长15位字符(包括小数点),注:高德坐标系。经纬度是门店搜索和活动推荐的重要参数,录入时请确保经纬度参数的准确。高德经纬度询:http://lbs.amap.com/console/show/picker 114.266418
latitude String 必须 15 纬度,最长15位字符(包括小数点),注:高德坐标系。经纬度是门店搜索和活动推荐的重要参数,录入时请确保经纬度参数的准确。高德经纬度询:http://lbs.amap.com/console/show/picker 30.548828
parking_start_time String 必须 8 停车场开始营业时间,格式 "HH:mm:ss" 07:00:00
parking_end_time String 必须 8 停车场结束营业时间,格式 "HH:mm:ss" 03:07:50
parking_number String 必须 10 停车位数目 10000
parking_lot_type String 必须 8 停车场类型,1为小区停车场、2为商圈停车场、3为路面停车场、4为园区停车场、5为写字楼停车场、6为私人停车场 1
parking_type String 必须 8 停车场类型(1为地面,2为地下,3为路边)(多个类型,中间用,隔开 2
payment_mode String 必须 16 缴费模式(1为停车卡缴费,2为物料缴费,3为中央缴费机) 1
pay_type String 必须 16 支付方式(1为支付宝在线缴费,2为支付宝代扣缴费,3当面付),如支持多种方式以','进行间隔 2
shopingmall_id String 可选 28 商圈id 100001008
parking_fee_description String 可选 512 收费说明 小车一小时10元
contact_name String 可选 10 停车场联系人,如果有则填入 张三
contact_mobile String 可选 11 停车场联系人手机,如果有则填入 189xxxxxxxx
contact_tel String 可选 18 停车场联系人座机,如果有则填入 0571xxxxxxxx
contact_emali String 可选 50 停车场联系人邮箱,如果有则填入 alipay@alipay.com
contact_weixin String 可选 50 停车场联系人微信,如果有则填入 923422342
contact_alipay String 可选 50 停车场联系人支付宝账户,如果有则填入 189xxxxxxxx
parking_name String 必须 512 停车场名称 城西停车场
time_out String 可选 10 用户支付未离场的超时时间(以分钟为单位) 13

公共响应参数

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

响应参数

参数 类型 是否必填 最大长度 描述 示例值
parking_id String 必填 28 支付宝返回停车场id。成功不为空,失败返回空 2014072300007148

请求示例

  • 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");
AlipayEcoMycarParkingParkinglotinfoCreateRequest request = new AlipayEcoMycarParkingParkinglotinfoCreateRequest();
request.setBizContent("{" +
"\"city_id\":\"110101\"," +
"\"equipment_name\":\"杭州立方\"," +
"\"out_parking_id\":\"10000110001\"," +
"\"parking_address\":\"浙江省杭州市古墩路与疏港公路的交汇处\"," +
"\"longitude\":\"114.266418\"," +
"\"latitude\":\"30.548828\"," +
"\"parking_start_time\":\"07:00:00\"," +
"\"parking_end_time\":\"03:07:50\"," +
"\"parking_number\":\"10000\"," +
"\"parking_lot_type\":\"1\"," +
"\"parking_type\":\"2\"," +
"\"payment_mode\":\"1\"," +
"\"pay_type\":\"2\"," +
"\"shopingmall_id\":\"100001008\"," +
"\"parking_fee_description\":\"小车一小时10元\"," +
"\"contact_name\":\"张三\"," +
"\"contact_mobile\":\"189xxxxxxxx\"," +
"\"contact_tel\":\"0571xxxxxxxx\"," +
"\"contact_emali\":\"alipay@alipay.com\"," +
"\"contact_weixin\":\"923422342\"," +
"\"contact_alipay\":\"189xxxxxxxx\"," +
"\"parking_name\":\"城西停车场\"," +
"\"time_out\":\"13\"" +
"}");
AlipayEcoMycarParkingParkinglotinfoCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"alipay_eco_mycar_parking_parkinglotinfo_create_response":{
		"msg":"Success",
		"code":"10000",
		"parking_id":"2014072300007148"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

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

业务错误码

错误码 错误描述 解决方案
INVALID_PARAMETER 参数有误。参数非法 检查并修改请求参数
BIZ_ERROR 业务异常。JSON转换异常 检查并修改JSON
INVALID_PARAMETER 参数有误。停车场ID【alipay_parking_id】为空 检查并修改请求参数
INVALID_PARAMETER 参数有误。城市编号【city_id】为空 检查并修改请求参数
INVALID_PARAMETER 参数有误。停车场编号【parking_id】为空 检查并修改请求参数
INVALID_PARAMETER 参数有误。车辆地址【parking_address】为空 检查并修改请求参数
INVALID_PARAMETER 参数有误。停车场开始营业时间【parking_start_time】为空 检查并修改请求参数
INVALID_PARAMETER 参数有误。停车场结束营业时间【parking_end_time】为空 检查并修改请求参数
INVALID_PARAMETER 参数有误。停车位数目【parking_number】为空 检查并修改请求参数
INVALID_PARAMETER 参数有误。停车场类型【parking_lot_type】为空 检查并修改请求参数
INVALID_PARAMETER 参数有误。停车场类型【parking_type】为空 检查并修改请求参数
INVALID_PARAMETER 参数有误。缴费模式【payment_mode】为空 缴费模式【payment_mode】为空
INVALID_PARAMETER 参数有误。支付方式【pay_type】为空 检查并修改请求参数
INVALID_PARAMETER 参数有误。停车场名称【parking_name】为空 检查并修改请求参数
BIZ_ERROR 业务异常。ISV AppId验证失败 请重试
INVALID_PARAMETER 参数有误。用户ID不能为空 检查并修改请求参数
BIZ_ERROR 业务异常。调用车主平台接口异常 请重试
BIZ_ERROR 业务异常。当前用户注册车辆过多 请检查业务逻辑
BIZ_ERROR 业务异常。车辆添加失败 请重试
BIZ_ERROR 业务异常。已添加过该车辆 检查业务逻辑
BIZ_ERROR 业务异常。车辆删除失败 请重试
BIZ_ERROR 业务异常。车主车辆添加失败 请重试
BIZ_ERROR 业务异常。停车场修改异常 请重试

公共错误码

返回
顶部