【腾讯项目】个性化商城一键设置接口文档

一、注意事项

1、调用接口方必须是qq.com的三级域名，形如：xxx.qq.com。在调试阶段，可以通过构造HOST来进行联调和设置。

2、必须在手Q环境进行调试和测试。

二、接口代码

URL：
http://imgcache.qq.com/club/themes/mobile/test/interface/individuation_onestep.html

二维码：

需要在手Q环境中才能正常运行。

三、接口说明

该接口依赖一些库文件，如下：

<script src="http://imgcache.qq.com/club/themes/mobile/common/qw/qw.core.js?_bid=321"></script>
<script src="http://imgcache.qq.com/club/themes/mobile/common/qt/qt.common.js?_bid=321"></script>
<script src="http://imgcache.qq.com/club/themes/mobile/test/interface/js/lib/async.min.js"></script>

接口的调用：

var loadScript = function(url, callback) {
    var sc = document.createElement("script"), head = document.getElementsByTagName("head")[0];
    sc.src = url;
    sc.onload = function() {
        callback && callback();
        head.removeChild(sc);
    };
    head.appendChild(sc);
};
loadScript('http://imgcache.qq.com/club/themes/mobile/test/interface/js/business.js', function() {
    new OneSetep({
        bubbleId: 60,
        headPendantId: 4,
        bgId: 114
    }, function(data) {
        if (data.ret == 0) {
            alert('设置个性装扮成功!');
        } else {
            alert(data.ret);
        }
    })
})

其中触发一键设置最核心的是下面的语句：

new OneSetep({
        bubbleId: 60,
        headPendantId: 4,
        bgId: 114
    }, function(data) {
        if (data.ret == 0) {
            alert('设置个性装扮成功!');
        } else {
            alert(data.ret);
        }
    })

函数原型：

OneSetep(options, callback)

参数说明：

options.bubbleId //必填，气泡ID
options.headPendantId //必填，挂件ID
options.bgId //必填，背景ID

callback //选填，一键设置之后的回调，会返回设置是否成功的标识，形如{ret: 0}
其中
ret = 0 表示一键设置所有装扮成功
ret = 1 表示气泡设置失败
ret = 2 表示挂件设置失败
ret = 3 表示背景设置失败

接口的逻辑是当第一个失败发生时，便不再继续设置，且返回是哪个装扮设置失败。

四、接口更新

1、接口增加了关于鉴权失败的逻辑

个性化商城一键设置流程图.eddx11.2kB