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

alipay.overseas.travel.content.create (跨境游内容对接-内容创建修改接口)

跨境游内容对接-内容创建修改接口

公共参数

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

请求参数

参数 类型 是否必填 最大长度 描述 示例值
content_id String 必须 64 内容id skjlefj3k3345
content String 可选 50000 内容详情,不包含页面样式 位置在岭南天地马路旁边,很容易找到,和朋友在一起叙旧,环境挺舒服的,比较安静,小吃味道都挺好的,甜甜辣辣,虽然有点小贵,但是晚上和朋友一起出来小聚是非常棒的。
title String 必须 1024 内容标题 跟我一起穷游澳洲
cover String 可选 4096 内容封面 http://alipay-rmsdeploy-dev-image.oss-cn-hangzhou-zmf.aliyuncs.com/publiccore/MevyYpMRQJwwyLS.jpg
detail_url String 必须 4096 内容详情H5链接 https://place.fliggy.com/newguide/2017081515225304388?spm=181.7736978.3.2.734d5ae3Li1vqB
modified_date Number 必须 1024 内容修改时间,请确保本次修改的时间大于上一次修改的时间 1511503236853
publish_date Number 必须 1024 内容发布时间 1511503236853
category_name String 必须 128 内容分类名称 旅行头条
category_code String 必须 128 内容分类code 3DJA9
tag_list String [] 可选 128000 标签列表,单个tag大小不超过128,tag个数不超过1000 Tag1, Tag2
author String 必须 128 内容作者 快乐旅行
image_list String [] 可选 204800 图片链接列表,单个image大小不超过4096,image个数不超过50 link1, link2
poi_list ContentPoiData [] 可选 - poi列表,单个poi名称大小不超过512,poi个数不超过50个
  • └ poi_name
  • String
  • 必填
  • 512
  • 位置信息
  • 天安门
  • └ latitude
  • String
  • 可选
  • 128
  • poi纬度
  • 30.0324234
  • └ longitude
  • String
  • 可选
  • 128
  • poi经度
  • 43.934803

公共响应参数

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

响应参数

参数 类型 是否必填 最大长度 描述 示例值
result_msg String 选填 512 可选,仅当请求中的modified_date等于已落地内容的modified_date并且内容状态一致,认为幂等成功,返回Success 幂等成功

请求示例

  • 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");
AlipayOverseasTravelContentCreateRequest request = new AlipayOverseasTravelContentCreateRequest();
request.setBizContent("{" +
"\"content_id\":\"skjlefj3k3345\"," +
"\"content\":\"位置在岭南天地马路旁边,很容易找到,和朋友在一起叙旧,环境挺舒服的,比较安静,小吃味道都挺好的,甜甜辣辣,虽然有点小贵,但是晚上和朋友一起出来小聚是非常棒的。\"," +
"\"title\":\"跟我一起穷游澳洲\"," +
"\"cover\":\"http://alipay-rmsdeploy-dev-image.oss-cn-hangzhou-zmf.aliyuncs.com/publiccore/MevyYpMRQJwwyLS.jpg\"," +
"\"detail_url\":\"https://place.fliggy.com/newguide/2017081515225304388?spm=181.7736978.3.2.734d5ae3Li1vqB\"," +
"\"modified_date\":1511503236853," +
"\"publish_date\":1511503236853," +
"\"category_name\":\"旅行头条\"," +
"\"category_code\":\"3DJA9\"," +
"      \"tag_list\":[" +
"        \"Tag1\",\" Tag2\"" +
"      ]," +
"\"author\":\"快乐旅行\"," +
"      \"image_list\":[" +
"        \"link1\",\" link2\"" +
"      ]," +
"      \"poi_list\":[{" +
"        \"poi_name\":\"天安门\"," +
"\"latitude\":\"30.0324234\"," +
"\"longitude\":\"43.934803\"" +
"        }]" +
"  }");
AlipayOverseasTravelContentCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE",
	"alipay_overseas_travel_content_create_response":{
		"msg":"Success",
		"result_msg":"幂等成功",
		"code":"10000"
	}
}

异常示例

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

业务错误码

错误码 错误描述 解决方案
SYSTEM_ERROR 系统异常 系统异常,需要重试
TITLE_EMPTY 参数有误内容标题为空 确保内容标题不为空,建议修改后重新发起请求
DETAIL_URL_EMPTY 参数有误内容详情链接为空 确保内容详情链接不为空,建议修改后重新发起请求
MODIFIED_DATE_EMPTY 参数有误修改时间为空 确保修改时间不为空,建议修改后重新发起请求
PUBLISH_DATE_EMPTY 参数有误发布时间为空 确保发布时间不为空,建议修改后重新发起请求
CATEGORY_NAME_EMPTY 参数有误内容分类名称为空 确保内容分类名称不为空,建议修改后重新发起请求
CATEGORY_CODE_EMPTY 参数有误内容分类码为空 确保内容分类码不为空,建议修改后重新发起请求
AUTHOR_EMPTY 参数有误内容作者为空 确保内容作者不为空,建议修改后重新发起请求
MODIFY_EXPIRED 修改操作已过期 确保修改操作不能过期,建议修改传入的修改时间大于上一次的修改时间,并重新发起请求
CONTENT_ID_EMPTY 内容id为空 确保内容id不为空,建议修改后重新发起请求
ARGUMENT_TYPE_ILLEGAL 参数类型不合法 确保参数类型合法,建议修改后重新发起请求
POI_NAME_EMPTY poi名字为空 确保poi名字不为空,建议修改后重新发起请求
POI_LAT_LNG_ILLEGAL poi经纬度不合法 确保poi经纬度合法 1. 类型正确 2. 范围正确(经度:必须为数字内容的字符串,取值范围-180到180;经度:必须为数字内容的字符串,取值范围-90到90) 3. 经纬度同时存在 建议修改后重新发起请求

公共错误码

返回
顶部