文档中心 > API类目 > 服务平台API

taobao.fuwu.sku.get (获取内购服务及SKU详情)

通过服务code和用户nick,获取该服务对应的收费项目的sku信息,包括价格、可购买周期、用户能否购买等信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
article_code String 必须 FW_GOODS_123 服务code
nick String 必须 taobaonick 用户的淘宝nick

响应参数

名称 类型 示例值 描述
result ArticleViewResult 内购服务及SKU详情
  • └ article_code
  • String
  • FW_GOODS_151
  • 服务code
  • └ article_commment
  • String
  • 服务简介
  • 服务简介
  • article_item_view_units
  • ArticleItemViewUnit []
  • sku详情列表
  • └ actual_price
  • String
  • 6.50
  • 需要支付的价格,单位:元
  • └ can_sub
  • Boolean
  • false
  • 用户是否可以购买
  • └ cyc_num
  • Number
  • 3
  • 周期数,如1,3,6,12。对于周期型和周期计量型返回。
  • └ cyc_unit
  • Number
  • 2
  • 1-年,2-月,3-日。对于周期型和周期计量型返回。
  • └ error_code
  • String
  • 1234
  • 错误码
  • └ error_msg
  • String
  • 当前订购服务上,您有“待付款”的订单,请先<a href="http://fuwu.daily.taobao.net/ser/order/biz_order_list.htm?tabIndex=2" target="_blank">付款(或关闭)订单</a>!
  • 错误文案
  • └ item_code
  • String
  • FW_GOODS_151_1
  • 收费项目code
  • └ item_name
  • String
  • 收费项目1
  • 收费项目名称
  • └ origin_price
  • String
  • 10.00
  • 原价,单位:元
  • └ prom_price
  • String
  • 3.50
  • 优惠,单位:元
  • └ quantity
  • Number
  • 1
  • 数量。对于周期计量型返回计量数。
  • └ article_name
  • String
  • 服务1
  • 服务名称
  • └ error_code
  • String
  • isv.articleCode is null
  • 错误码
  • └ error_msg
  • String
  • 服务code为null
  • 错误消息
  • └ nick
  • String
  • sun123
  • 用户淘宝nick
  • └ pict_url
  • String
  • https://img.alicdn.com/tps/i4/T1atRKXg4tXXXXXXXX-80-80.png
  • 服务图片地址

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FuwuSkuGetRequest req = new FuwuSkuGetRequest();
req.setArticleCode("FW_GOODS_123");
req.setNick("taobaonick");
FuwuSkuGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<fuwu_sku_get_response>
    <result>
        <article_code>FW_GOODS_151</article_code>
        <article_commment>服务简介</article_commment>
        <article_item_view_units>
            <article_item_view_unit>
                <actual_price>6.50</actual_price>
                <can_sub>false</can_sub>
                <cyc_num>3</cyc_num>
                <cyc_unit>2</cyc_unit>
                <error_code>1234</error_code>
                <error_msg>当前订购服务上,您有“待付款”的订单,请先&lt;a href=&quot;http://fuwu.daily.taobao.net/ser/order/biz_order_list.htm?tabIndex=2&quot; target=&quot;_blank&quot;&gt;付款(或关闭)订单&lt;/a&gt;!</error_msg>
                <item_code>FW_GOODS_151_1</item_code>
                <item_name>收费项目1</item_name>
                <origin_price>10.00</origin_price>
                <prom_price>3.50</prom_price>
                <quantity>1</quantity>
            </article_item_view_unit>
        </article_item_view_units>
        <article_name>服务1</article_name>
        <error_code>isv.articleCode is null</error_code>
        <error_msg>服务code为null</error_msg>
        <nick>sun123</nick>
        <pict_url>https://img.alicdn.com/tps/i4/T1atRKXg4tXXXXXXXX-80-80.png</pict_url>
    </result>
</fuwu_sku_get_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>

错误码解释

错误码 错误描述 解决方案
isv.articleCode is null 服务code为null 请填入article_code
isv.appkey does not support in-purchase appkey对应的服务不支持内购 请更换appKey或者在服务商后台设置内购服务的关联服务为该appKey对应的服务
isv.nick is null nick为null 请传入nick
isv.appKey is null appKey为null 请传入appKey
isv.articleCode does not exist 服务code不存在 请传入正确的article code
isv.appkey does not exist appkey不存在 请传入正确的appKey
isv.articleCode is not in-purchase 服务code不是内购服务 请传入内购服务的article code
isv.articleCode is not depended on appkey 服务code与appkey未进行关联 请传入正确的内购服务article code和与之关联的appKey
isv.nick is invalid nick非法 请传入正确的nick
isp.system error 系统错误 请稍后再试或联系淘宝客服
isv.article has no item 服务code无收费项目 请传入正确的内购article code或者为内购服务添加收费项目
isv.sku type does not support 服务code的skuType不支持内购 请传入正确的内购服务article code
isv.articleis frozen 服务被冻结 请先解冻服务
isv.sp is frozen 服务商被冻结 请先解冻
isv.article is invalid 服务状态无效 请更新服务上架和审核状态

API工具

如何获得此API

FAQ

返回
顶部