文档中心 > API类目 > 淘宝客API

taobao.tbk.seed.event.write (淘宝客-推广者-种草内容数据写入)

淘宝客-推广者-种草内容数据写入

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
event_id Number 必须 12340 活动ID
media_event_id String 可选 12341 媒体活动ID
kox_nick_name String 可选 达人 达人昵称
content_url String 可选 url 内容链接
kox_commision_fee String 可选 20.00 达人费用(单位:元)
media_platform_fee String 可选 20.00 平台费用(单位:元)
media_total_fee String 可选 40.00 总费用(单位:元)
media_event_status String 必须 SUCCESS 订单状态:CANCEL-取消,SUCCESS-成功 TRY-预算占用
secret_key String 必须 024A 服务密钥
cancel_reason String 可选 xxx 取消原因
media_event_name String 可选 xxx 媒体任务名称
content_expect_publish_time Date 可选 2023-02-10 23:59:59 预算占用之后,内容预期发布时间
media_event_type String 可选 KOC 媒体任务类型
delivery_type String 可选 内容 交付类型
delivery_result Number 可选 100 交付结果
content_id String 可选 abcd 内容id
content_publish_time Date 可选 2023-02-11 23:59:59 内容实际发布时间

响应参数

名称 类型 示例值 描述
data MediaEventDTO 确认写入信息
  • └ event_id
  • Number
  • 12340
  • 星任务id
  • └ media_event_id
  • String
  • 12341
  • 媒体内容id
  • └ sub_event_id
  • Number
  • 12345
  • 子任务id
result_code Number 200 返回码
biz_error_code Number 110 错误码
result_msg String "result" 返回码释义
biz_error_desc String "error" 错误码释义

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkSeedEventWriteRequest req = new TbkSeedEventWriteRequest();
req.setEventId(12340L);
req.setMediaEventId("12341");
req.setKoxNickName("达人");
req.setContentUrl("url");
req.setKoxCommisionFee("20.00");
req.setMediaPlatformFee("20.00");
req.setMediaTotalFee("40.00");
req.setMediaEventStatus("SUCCESS");
req.setSecretKey("024A");
req.setCancelReason("xxx");
req.setMediaEventName("xxx");
req.setContentExpectPublishTime(StringUtils.parseDateTime("2023-02-10 23:59:59"));
req.setMediaEventType("KOC");
req.setDeliveryType("内容");
req.setDeliveryResult(100L);
req.setContentId("abcd");
req.setContentPublishTime(StringUtils.parseDateTime("2023-02-11 23:59:59"));
TbkSeedEventWriteResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_seed_event_write_response>
    <data>
        <event_id>12340</event_id>
        <media_event_id>12341</media_event_id>
        <sub_event_id>12345</sub_event_id>
    </data>
    <result_code>200</result_code>
    <biz_error_code>110</biz_error_code>
    <result_msg>&quot;result&quot;</result_msg>
    <biz_error_desc>&quot;error&quot;</biz_error_desc>
</tbk_seed_event_write_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部