koubei.advert.delivery.discount.web.batchquery (口碑广告投放优惠查询接口)

用于媒体接入口碑广告平台后,通过渠道和地理位置查询券列表的接口。该接口是页面接口,ISV提供用户信息,并引导用户跳转口碑,并在口碑页面查询并领券。

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 koubei.advert.delivery.discount.web.batchquery
format String 40 仅支持JSON JSON
return_url String 256 HTTP/HTTPS开头字符串 https://m.alipay.com/Gk8NF23
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 - 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
mobile String 必须 11 手机号码,根据手机号码查询支付宝账户ID 15000123456
shop_id String 可选 32 门店ID,如果设置门店,则查询门店下发行的券 2015072900077000000001362202
latitude String 必须 32 纬度,根据经纬度查询附近的券 31.22967
longitude String 必须 32 经度,根据经纬度查询附近的券 121.4762
channel String 必须 64 分配的固定的渠道CODE,需要找运营申请 ele

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
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");
KoubeiAdvertDeliveryDiscountWebBatchqueryRequest request = new KoubeiAdvertDeliveryDiscountWebBatchqueryRequest();
request.setBizContent("{" +
"\"mobile\":\"15000123456\"," +
"\"shop_id\":\"2015072900077000000001362202\"," +
"\"latitude\":\"31.22967\"," +
"\"longitude\":\"121.4762\"," +
"\"channel\":\"ele\"" +
"}");
KoubeiAdvertDeliveryDiscountWebBatchqueryResponse response = alipayClient.pageExecute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE",
	"koubei_advert_delivery_discount_web_batchquery_response":{
		"msg":"Success",
		"code":"10000"
	}
}

异常示例

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

公共错误码

返回
顶部