淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
item_create_request	OpenItemCreateRequest	可选			创建请求
└ sales_period_end String 必须 2021-01-20 19:56:47 售卖开始时间 └ ticket_display_mode String 必须 NO_DISPLAY_CODE 核销方式，也即凭证使用展示方式：付款码USER_PAY_CODE,券码TICKET_CODE,无码核销NO_DISPLAY_CODE service_package_dto ServicePackageDto 必须详情结构 └ price Number 必须 100 价格等于商品原价,目前无地方消费 package_content_list PackageContentDTO [] 必须 [{"title":"基础项目","content_group_list":[{"content":"内科","price":15,"unit":"份","num":1},{"content":"外科","price":20,"unit":"份","num":1}]},{"title":"实验室项目","content_group_list":[{"content":"血常规18项目","price":25,"unit":"份","num":1},{"content":"尿常规","price":15,"unit":"份","num":1}]}] 详情描述内容组 content_group_list ContentGroupDto [] 必须内容组 └ unit String 可选份单位 └ price Number 可选 20000 价值。单位分 └ content String 可选咽拭子内容 └ num String 可选 1 数量 └ title String 可选内容组标题1 内容组标题 └ has_service_unit Boolean 可选 false 目前top接口只支持false └ explanation String 可选 "说明xx" 补充说明 └ service_package_name String 可选测试请不要拍测试体检预约一般和标题名一样，可改 └ service_category_id String 必须 1020191219001000000 需要分配 service_flow_list ServiceFlowDTO [] 可选服务流程 └ explanation String 可选补充说明补充说明 └ unit String 可选份单位 └ num Number 可选 1 数量 └ service_content String 可选服务内容描述服务内容 └ step String 可选 1 流程步骤 graphic_text_list GraphicTextDTO [] 可选图文详情 └ django_id String 可选 LpbRZPO0QZeh9pneiUhgNwAAACMAAQED 专用字段,口碑侧的图片ID, 只会在 type=IMAGE 时存在 └ type String 可选 IMAGE 类型：IMAGE-图片；TEXT-文字描述 └ content String 可选 /imgextra/i4/2088102146931393/O1CN011MA2520D367McKI_!!2088102146931393-0-koubei.jpg 描述：IMAGE-图片地址；TEXT-文本内容 └ industry String 必须 SERV_INDUSTRY 行业信息 └ origin_price Number 必须 100 商品原价,单位分,1元=100分 └ title String 必须快速入职体检赠早餐商品名称，请勿超过40汉字，80个字符 └ inventory Number 必须 99999 库存总量 available_times AvailableTimeDTO [] 可选部分时间可用,如果全时段24小时都可用availableTimes就传null └ to_time String 可选 12:00 几点到几点，前后不能超过24小时 └ from_time String 可选 19:00 几点到几点，前后不能超过24小时 └ week_day String [] 可选 ["1",”2","3","4","5"] ["1",”2","3","4","5"]这里表示周一到周五 └ cover String 必须 0yaPA96AQPqJDIju28pvAgAAACMAAQEC //商品头图，必填，4：3，图片大小范围20KB~5000KB，格式：bmp，png，jpeg，gif，建议尺寸：2000x1500 forbidden_dates DateRangeDTO [] 可选 //不可用日期,如果具体某日不可用，from和to一样就好,如果全日期可用就传null └ to_date String 可选 2018-06-30 结束时间 └ from_date String 可选 2018-05-30 起始时间 └ validity_period_from String 可选 2021-01-12 00:00:00 有效期开始 └ display_channels String 必须 ALL 商品展示渠道，正常展示用ALL，定投用ORIENTATION └ price Number 必须 100 商品售价,单位分,1元=100分 └ shop_ids String [] 必须 ["2015100300077000000001860010","2015100100077000000001855137"] 门店列表 └ request_id String 必须 xxxx 请求id └ verify_frequency String 可选 single 商品可核销频度(single/multi) 可创建不可修改,目前本接口只支持single └ validity_period_to String 可选 2021-04-12 23:59:59 有效期截止 └ verify_enable_times Number 必须 1 本接口目前,结合single,只支持传1 buyer_notes BuyTipsDTO [] 可选更多购买须知 └ details String [] 可选 ["desc1","desc2"] 购买须知描述组 └ title String 可选须知标题1 更多购买须知标题 └ test_item Boolean 必须 false 线上售卖的商品是false buy_limit_dto_list ItemBuyLimitDTO [] 可选购买限制 └ limit_num Number 可选 1 限购数量 └ limit_type String 可选 BUY_LIMIT_PER_ORDER_MAX 商品限购规则 └ picture_details String [] 可选 ["0yaPA96AQPqJDIju28pvAgAAACMAAQEC"] //商品图片列表，可选，跟cover一样4:3比例，最多5张 └ valid_period Number 可选 90 相对有效期时长（单位天） buy_tips_template BuyTipsTemplateDto 可选购买须知属性 └ free_wifi Boolean 可选 true 免费wifi └ limit_user_num Boolean 可选 true 使用数量限制 └ reserve_note String 可选预约说明信息预约说明 └ invoice_types String [] 可选 [//发票 "ELECTRONIC_INVOICE",//电子发票 "PAPER_INVOICE"//纸质发票 ] 支持的发票类型,"ELECTRONIC_INVOICE",//电子发票; "PAPER_INVOICE"//纸质发票 └ park_fee_per_hour String 可选 5 每小时停车费 └ need_reserve Boolean 可选 true 是否需要预约 └ supply_invoice Boolean 可选 true 是否提供发票 └ free_park_hours Number 可选 3 免费停车3小时，最大值24 └ reserve_type String 可选 MOBILE 预约方式，电话预约MOBILE，在线预约ONLINE └ user_num_limited Number 可选 10 每张限用10人，区间1-100 └ free_park Boolean 可选 true 免费停车 └ park_fee_upper_bound_per_day Number 可选 50 24小时停车费上限值 └ sales_period_start String 可选 2021-01-12 00:00:00 售卖开始时间 └ taobao_cover String 必须 0yaPA96AQPqJDIju28pvAgAAACMAAQEC 商品1:1首图，用于频道栏目、店铺等商品入口展示 └ validity_period_type String 必须 RELATIVE 有效期类型FIXED和RELATIVE两种 └ merchant_pid String 必须 xxx 商户id └ operator_type String 必须 ISV 身份类型 └ category_id String 必须商品类目id 2020062900464093 └ forbid_reverse Boolean 可选 false 是否禁止反圈,设置禁止反圈时,必须为定向投放;默认是允许反圈的

名称	类型	示例值	描述
result	Result	结果对象	接口返回model
└ trace_id String xxxxxx 链路traceId data ItemMngRespone 1234 api变更结果 └ tb_item_id Number 6xxx8845 淘系商品id └ retry String false 操作，重试是否能成功，业务异常，重试是不能成功的，网络异常，系统异常重试能幂等成功 └ success Boolean false 是否成功 error TribeError demo 错误信息描述信息 └ view String 无 └ code String 错误码 └ message String 错误信息描述

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LifeserviceItemCreateRequest req = new LifeserviceItemCreateRequest();
LifeserviceItemCreateRequest.OpenItemCreateRequest obj1 = new LifeserviceItemCreateRequest.OpenItemCreateRequest();
obj1.setSalesPeriodEnd("2021-01-20 19:56:47");
obj1.setTicketDisplayMode("NO_DISPLAY_CODE");
LifeserviceItemCreateRequest.ServicePackageDto obj2 = new LifeserviceItemCreateRequest.ServicePackageDto();
obj2.setPrice(100L);
List<LifeserviceItemCreateRequest.PackageContentDTO> list4 = new ArrayList<LifeserviceItemCreateRequest.PackageContentDTO>();
LifeserviceItemCreateRequest.PackageContentDTO obj5 = new LifeserviceItemCreateRequest.PackageContentDTO();
list4.add(obj5);
List<LifeserviceItemCreateRequest.ContentGroupDto> list8 = new ArrayList<LifeserviceItemCreateRequest.ContentGroupDto>();
LifeserviceItemCreateRequest.ContentGroupDto obj9 = new LifeserviceItemCreateRequest.ContentGroupDto();
list8.add(obj9);
obj9.setUnit("份");
obj9.setPrice(20000L);
obj9.setContent("咽拭子");
obj9.setNum("1");
list6.setContentGroupList(list8);
obj5.setTitle("内容组标题1");
obj2.setPackageContentList(list4);
obj2.setHasServiceUnit(false);
obj2.setExplanation("\"说明xx\"");
obj2.setServicePackageName("测试请不要拍测试体检预约");
obj2.setServiceCategoryId("1020191219001000000");
List<LifeserviceItemCreateRequest.ServiceFlowDTO> list11 = new ArrayList<LifeserviceItemCreateRequest.ServiceFlowDTO>();
LifeserviceItemCreateRequest.ServiceFlowDTO obj12 = new LifeserviceItemCreateRequest.ServiceFlowDTO();
list11.add(obj12);
obj12.setExplanation("补充说明");
obj12.setUnit("份");
obj12.setNum(1L);
obj12.setServiceContent("服务内容描述");
obj12.setStep("1");
obj2.setServiceFlowList(list11);
List<LifeserviceItemCreateRequest.GraphicTextDTO> list14 = new ArrayList<LifeserviceItemCreateRequest.GraphicTextDTO>();
LifeserviceItemCreateRequest.GraphicTextDTO obj15 = new LifeserviceItemCreateRequest.GraphicTextDTO();
list14.add(obj15);
obj15.setDjangoId("LpbRZPO0QZeh9pneiUhgNwAAACMAAQED");
obj15.setType("IMAGE");
obj15.setContent("/imgextra/i4/2088102146931393/O1CN011MA2520D367McKI_!!2088102146931393-0-koubei.jpg");
obj2.setGraphicTextList(list14);
obj1.setServicePackageDto(obj2);
obj1.setIndustry("SERV_INDUSTRY");
obj1.setOriginPrice(100L);
obj1.setTitle("快速入职体检赠早餐");
obj1.setInventory(99999L);
List<LifeserviceItemCreateRequest.AvailableTimeDTO> list17 = new ArrayList<LifeserviceItemCreateRequest.AvailableTimeDTO>();
LifeserviceItemCreateRequest.AvailableTimeDTO obj18 = new LifeserviceItemCreateRequest.AvailableTimeDTO();
list17.add(obj18);
obj18.setToTime("12:00");
obj18.setFromTime("19:00");
obj18.setWeekDay(""1",”2","3","4","5"");
obj1.setAvailableTimes(list17);
obj1.setCover("0yaPA96AQPqJDIju28pvAgAAACMAAQEC");
List<LifeserviceItemCreateRequest.DateRangeDTO> list20 = new ArrayList<LifeserviceItemCreateRequest.DateRangeDTO>();
LifeserviceItemCreateRequest.DateRangeDTO obj21 = new LifeserviceItemCreateRequest.DateRangeDTO();
list20.add(obj21);
obj21.setToDate("2018-06-30");
obj21.setFromDate("2018-05-30");
obj1.setForbiddenDates(list20);
obj1.setValidityPeriodFrom("2021-01-12 00:00:00");
obj1.setDisplayChannels("ALL");
obj1.setPrice(100L);
obj1.setShopIds(""2015100300077000000001860010","2015100100077000000001855137"");
obj1.setRequestId("xxxx");
obj1.setVerifyFrequency("single");
obj1.setValidityPeriodTo("2021-04-12 23:59:59");
obj1.setVerifyEnableTimes(1L);
List<LifeserviceItemCreateRequest.BuyTipsDTO> list23 = new ArrayList<LifeserviceItemCreateRequest.BuyTipsDTO>();
LifeserviceItemCreateRequest.BuyTipsDTO obj24 = new LifeserviceItemCreateRequest.BuyTipsDTO();
list23.add(obj24);
obj24.setDetails(""desc1","desc2"");
obj24.setTitle("须知标题1");
obj1.setBuyerNotes(list23);
obj1.setTestItem(false);
List<LifeserviceItemCreateRequest.ItemBuyLimitDTO> list26 = new ArrayList<LifeserviceItemCreateRequest.ItemBuyLimitDTO>();
LifeserviceItemCreateRequest.ItemBuyLimitDTO obj27 = new LifeserviceItemCreateRequest.ItemBuyLimitDTO();
list26.add(obj27);
obj27.setLimitNum(1L);
obj27.setLimitType("BUY_LIMIT_PER_ORDER_MAX");
obj1.setBuyLimitDtoList(list26);
obj1.setPictureDetails(""0yaPA96AQPqJDIju28pvAgAAACMAAQEC"");
obj1.setValidPeriod(90L);
LifeserviceItemCreateRequest.BuyTipsTemplateDto obj28 = new LifeserviceItemCreateRequest.BuyTipsTemplateDto();
obj28.setFreeWifi(true);
obj28.setLimitUserNum(true);
obj28.setReserveNote("预约说明信息");
obj28.setInvoiceTypes("//发票               "ELECTRONIC_INVOICE",//电子发票               "PAPER_INVOICE"//纸质发票             ");
obj28.setParkFeePerHour("5");
obj28.setNeedReserve(true);
obj28.setSupplyInvoice(true);
obj28.setFreeParkHours(3L);
obj28.setReserveType("MOBILE");
obj28.setUserNumLimited(10L);
obj28.setFreePark(true);
obj28.setParkFeeUpperBoundPerDay(50L);
obj1.setBuyTipsTemplate(obj28);
obj1.setSalesPeriodStart("2021-01-12 00:00:00");
obj1.setTaobaoCover("0yaPA96AQPqJDIju28pvAgAAACMAAQEC");
obj1.setValidityPeriodType("RELATIVE");
obj1.setMerchantPid("xxx");
obj1.setOperatorType("ISV");
obj1.setCategoryId("商品类目id");
obj1.setForbidReverse(false);
req.setItemCreateRequest(obj1);
LifeserviceItemCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
LifeserviceItemCreateRequest req = new LifeserviceItemCreateRequest();
LifeserviceItemCreateRequest.OpenItemCreateRequestDomain obj1 = new LifeserviceItemCreateRequest.OpenItemCreateRequestDomain();
obj1.SalesPeriodEnd = "2021-01-20 19:56:47";
obj1.TicketDisplayMode = "NO_DISPLAY_CODE";
LifeserviceItemCreateRequest.ServicePackageDtoDomain obj2 = new LifeserviceItemCreateRequest.ServicePackageDtoDomain();
obj2.Price = 100L;
List<LifeserviceItemCreateRequest.PackageContentDTODomain> list4 = new List<LifeserviceItemCreateRequest.PackageContentDTODomain>();
LifeserviceItemCreateRequest.PackageContentDTODomain obj5 = new LifeserviceItemCreateRequest.PackageContentDTODomain();
list4.Add(obj5);
List<LifeserviceItemCreateRequest.ContentGroupDtoDomain> list7 = new List<LifeserviceItemCreateRequest.ContentGroupDtoDomain>();
LifeserviceItemCreateRequest.ContentGroupDtoDomain obj8 = new LifeserviceItemCreateRequest.ContentGroupDtoDomain();
list7.Add(obj8);
obj8.Unit = "份";
obj8.Price = 20000L;
obj8.Content = "咽拭子";
obj8.Num = "1";
obj5.ContentGroupList= list7;
obj5.Title = "内容组标题1";
obj2.PackageContentList= list4;
obj2.HasServiceUnit = false;
obj2.Explanation = "\"说明xx\"";
obj2.ServicePackageName = "测试请不要拍测试体检预约";
obj2.ServiceCategoryId = "1020191219001000000";
List<LifeserviceItemCreateRequest.ServiceFlowDTODomain> list10 = new List<LifeserviceItemCreateRequest.ServiceFlowDTODomain>();
LifeserviceItemCreateRequest.ServiceFlowDTODomain obj11 = new LifeserviceItemCreateRequest.ServiceFlowDTODomain();
list10.Add(obj11);
obj11.Explanation = "补充说明";
obj11.Unit = "份";
obj11.Num = 1L;
obj11.ServiceContent = "服务内容描述";
obj11.Step = "1";
obj2.ServiceFlowList= list10;
List<LifeserviceItemCreateRequest.GraphicTextDTODomain> list13 = new List<LifeserviceItemCreateRequest.GraphicTextDTODomain>();
LifeserviceItemCreateRequest.GraphicTextDTODomain obj14 = new LifeserviceItemCreateRequest.GraphicTextDTODomain();
list13.Add(obj14);
obj14.DjangoId = "LpbRZPO0QZeh9pneiUhgNwAAACMAAQED";
obj14.Type = "IMAGE";
obj14.Content = "/imgextra/i4/2088102146931393/O1CN011MA2520D367McKI_!!2088102146931393-0-koubei.jpg";
obj2.GraphicTextList= list13;
obj1.ServicePackageDto= obj2;
obj1.Industry = "SERV_INDUSTRY";
obj1.OriginPrice = 100L;
obj1.Title = "快速入职体检赠早餐";
obj1.Inventory = 99999L;
List<LifeserviceItemCreateRequest.AvailableTimeDTODomain> list16 = new List<LifeserviceItemCreateRequest.AvailableTimeDTODomain>();
LifeserviceItemCreateRequest.AvailableTimeDTODomain obj17 = new LifeserviceItemCreateRequest.AvailableTimeDTODomain();
list16.Add(obj17);
obj17.ToTime = "12:00";
obj17.FromTime = "19:00";
obj17.WeekDay = ""1",”2","3","4","5"";
obj1.AvailableTimes= list16;
obj1.Cover = "0yaPA96AQPqJDIju28pvAgAAACMAAQEC";
List<LifeserviceItemCreateRequest.DateRangeDTODomain> list19 = new List<LifeserviceItemCreateRequest.DateRangeDTODomain>();
LifeserviceItemCreateRequest.DateRangeDTODomain obj20 = new LifeserviceItemCreateRequest.DateRangeDTODomain();
list19.Add(obj20);
obj20.ToDate = "2018-06-30";
obj20.FromDate = "2018-05-30";
obj1.ForbiddenDates= list19;
obj1.ValidityPeriodFrom = "2021-01-12 00:00:00";
obj1.DisplayChannels = "ALL";
obj1.Price = 100L;
obj1.ShopIds = ""2015100300077000000001860010","2015100100077000000001855137"";
obj1.RequestId = "xxxx";
obj1.VerifyFrequency = "single";
obj1.ValidityPeriodTo = "2021-04-12 23:59:59";
obj1.VerifyEnableTimes = 1L;
List<LifeserviceItemCreateRequest.BuyTipsDTODomain> list22 = new List<LifeserviceItemCreateRequest.BuyTipsDTODomain>();
LifeserviceItemCreateRequest.BuyTipsDTODomain obj23 = new LifeserviceItemCreateRequest.BuyTipsDTODomain();
list22.Add(obj23);
obj23.Details = ""desc1","desc2"";
obj23.Title = "须知标题1";
obj1.BuyerNotes= list22;
obj1.TestItem = false;
List<LifeserviceItemCreateRequest.ItemBuyLimitDTODomain> list25 = new List<LifeserviceItemCreateRequest.ItemBuyLimitDTODomain>();
LifeserviceItemCreateRequest.ItemBuyLimitDTODomain obj26 = new LifeserviceItemCreateRequest.ItemBuyLimitDTODomain();
list25.Add(obj26);
obj26.LimitNum = 1L;
obj26.LimitType = "BUY_LIMIT_PER_ORDER_MAX";
obj1.BuyLimitDtoList= list25;
obj1.PictureDetails = ""0yaPA96AQPqJDIju28pvAgAAACMAAQEC"";
obj1.ValidPeriod = 90L;
LifeserviceItemCreateRequest.BuyTipsTemplateDtoDomain obj27 = new LifeserviceItemCreateRequest.BuyTipsTemplateDtoDomain();
obj27.FreeWifi = true;
obj27.LimitUserNum = true;
obj27.ReserveNote = "预约说明信息";
obj27.InvoiceTypes = "//发票               "ELECTRONIC_INVOICE",//电子发票               "PAPER_INVOICE"//纸质发票             ";
obj27.ParkFeePerHour = "5";
obj27.NeedReserve = true;
obj27.SupplyInvoice = true;
obj27.FreeParkHours = 3L;
obj27.ReserveType = "MOBILE";
obj27.UserNumLimited = 10L;
obj27.FreePark = true;
obj27.ParkFeeUpperBoundPerDay = 50L;
obj1.BuyTipsTemplate= obj27;
obj1.SalesPeriodStart = "2021-01-12 00:00:00";
obj1.TaobaoCover = "0yaPA96AQPqJDIju28pvAgAAACMAAQEC";
obj1.ValidityPeriodType = "RELATIVE";
obj1.MerchantPid = "xxx";
obj1.OperatorType = "ISV";
obj1.CategoryId = "商品类目id";
obj1.ForbidReverse = false;
req.ItemCreateRequest_ = obj1;
LifeserviceItemCreateResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new LifeserviceItemCreateRequest;
$item_create_request = new OpenItemCreateRequest;
$item_create_request->sales_period_end="2021-01-20 19:56:47";
$item_create_request->ticket_display_mode="NO_DISPLAY_CODE";
$service_package_dto = new ServicePackageDto;
$service_package_dto->price="100";
$package_content_list = new PackageContentDTO;
$content_group_list = new ContentGroupDto;
$content_group_list->unit="份";
$content_group_list->price="20000";
$content_group_list->content="咽拭子";
$content_group_list->num="1";
$package_content_list->content_group_list = $content_group_list;
$package_content_list->title="内容组标题1";
$service_package_dto->package_content_list = $package_content_list;
$service_package_dto->has_service_unit="false";
$service_package_dto->explanation="\"说明xx\"";
$service_package_dto->service_package_name="测试请不要拍测试体检预约";
$service_package_dto->service_category_id="1020191219001000000";
$service_flow_list = new ServiceFlowDTO;
$service_flow_list->explanation="补充说明";
$service_flow_list->unit="份";
$service_flow_list->num="1";
$service_flow_list->service_content="服务内容描述";
$service_flow_list->step="1";
$service_package_dto->service_flow_list = $service_flow_list;
$graphic_text_list = new GraphicTextDTO;
$graphic_text_list->django_id="LpbRZPO0QZeh9pneiUhgNwAAACMAAQED";
$graphic_text_list->type="IMAGE";
$graphic_text_list->content="/imgextra/i4/2088102146931393/O1CN011MA2520D367McKI_!!2088102146931393-0-koubei.jpg";
$service_package_dto->graphic_text_list = $graphic_text_list;
$item_create_request->service_package_dto = $service_package_dto;
$item_create_request->industry="SERV_INDUSTRY";
$item_create_request->origin_price="100";
$item_create_request->title="快速入职体检赠早餐";
$item_create_request->inventory="99999";
$available_times = new AvailableTimeDTO;
$available_times->to_time="12:00";
$available_times->from_time="19:00";
$available_times->week_day="[\"1\",”2\",\"3\",\"4\",\"5\"]";
$item_create_request->available_times = $available_times;
$item_create_request->cover="0yaPA96AQPqJDIju28pvAgAAACMAAQEC";
$forbidden_dates = new DateRangeDTO;
$forbidden_dates->to_date="2018-06-30";
$forbidden_dates->from_date="2018-05-30";
$item_create_request->forbidden_dates = $forbidden_dates;
$item_create_request->validity_period_from="2021-01-12 00:00:00";
$item_create_request->display_channels="ALL";
$item_create_request->price="100";
$item_create_request->shop_ids="[\"2015100300077000000001860010\",\"2015100100077000000001855137\"]";
$item_create_request->request_id="xxxx";
$item_create_request->verify_frequency="single";
$item_create_request->validity_period_to="2021-04-12 23:59:59";
$item_create_request->verify_enable_times="1";
$buyer_notes = new BuyTipsDTO;
$buyer_notes->details="[\"desc1\",\"desc2\"]";
$buyer_notes->title="须知标题1";
$item_create_request->buyer_notes = $buyer_notes;
$item_create_request->test_item="false";
$buy_limit_dto_list = new ItemBuyLimitDTO;
$buy_limit_dto_list->limit_num="1";
$buy_limit_dto_list->limit_type="BUY_LIMIT_PER_ORDER_MAX";
$item_create_request->buy_limit_dto_list = $buy_limit_dto_list;
$item_create_request->picture_details="[\"0yaPA96AQPqJDIju28pvAgAAACMAAQEC\"]";
$item_create_request->valid_period="90";
$buy_tips_template = new BuyTipsTemplateDto;
$buy_tips_template->free_wifi="true";
$buy_tips_template->limit_user_num="true";
$buy_tips_template->reserve_note="预约说明信息";
$buy_tips_template->invoice_types="[//发票               \"ELECTRONIC_INVOICE\",//电子发票               \"PAPER_INVOICE\"//纸质发票             ]";
$buy_tips_template->park_fee_per_hour="5";
$buy_tips_template->need_reserve="true";
$buy_tips_template->supply_invoice="true";
$buy_tips_template->free_park_hours="3";
$buy_tips_template->reserve_type="MOBILE";
$buy_tips_template->user_num_limited="10";
$buy_tips_template->free_park="true";
$buy_tips_template->park_fee_upper_bound_per_day="50";
$item_create_request->buy_tips_template = $buy_tips_template;
$item_create_request->sales_period_start="2021-01-12 00:00:00";
$item_create_request->taobao_cover="0yaPA96AQPqJDIju28pvAgAAACMAAQEC";
$item_create_request->validity_period_type="RELATIVE";
$item_create_request->merchant_pid="xxx";
$item_create_request->operator_type="ISV";
$item_create_request->category_id="商品类目id";
$item_create_request->forbid_reverse="false";
$req->setItemCreateRequest(json_encode($item_create_request));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.lifeservice.item.create' \
-d 'partner_id=apidoc' \
-d 'sign=5E99ED3C9C218E335D91E81CDB1D3950' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+06%3A41%3A29' \
-d 'v=2.0' \
-d 'item_create_request=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.LifeserviceItemCreateRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.item_create_request=""
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.lifeservice.item.create");
add_param(pRequest,"item_create_request","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.lifeservice.item.create', {
	'item_create_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<lifeservice_item_create_response>
    <result>
        <trace_id>xxxxxx</trace_id>
        <data>
            <tb_item_id>6xxx8845</tb_item_id>
            <retry>false</retry>
        </data>
        <success>false</success>
        <error>
            <view></view>
            <code></code>
            <message></message>
        </error>
    </result>
</lifeservice_item_create_response>

{
    "lifeservice_item_create_response":{
        "result":{
            "trace_id":"xxxxxx",
            "data":{
                "tb_item_id":6xxx8845,
                "retry":"false"
            },
            "success":false,
            "error":{
                "view":"",
                "code":"",
                "message":""
            }
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

商品API

taobao.lifeservice.item.create (生服商品创建)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ