开发码上淘相关应用，会用到的平台：

 开放平台：http://my.open.taobao.com/

 TAE：http://tae.taobao.com/ide/myapps

 如何入驻开放平台：//open.taobao.com/doc/detail.htm?id=66#s0

 

一. 码上淘提供两种方式生成二维码：

1.通过Top接口生成二维码

taobao.ma.qrcode.common.create免费 创建码平台常用二维码

taobao.ma.packcode.create免费  生成包裹码二维码图片链接

a.     适合在已发布的应用中增加创建二维码功能

b.     适合批量生成的二维码的场景

c.     适合新申请的码上淘相关应用

优点：快速开发

缺点：只能固定样式默认的二维码，无法集成码上淘美化，下载，添加渠道等功能

2. 通过码上淘页面生成二维码

 

适合新申请的码上淘相关应用:自定义生成二维码对应的h5页面，关联推广渠道，生成二维码

优点：

                a.可以生成多样的二维码，和视觉码等酷炫二维码

                b.不许开发下载二维码，放大，缩小二维码图片等功能

                c.通过码上淘后台可以查看相关扫码数据

缺点：需要了解集成码上淘页面创建二维码知识

二. 如何集成码上淘页面创建二维码

       1.     码上淘介绍

 

        商家进入码上淘后台后，选择工具创建二维码，填写相关内容，生成h5页面，管理推广渠道，创建完成二维码，下载二维码

 

       2.     ISV需要完成的是第二步，制作生成二维码对应h5页面的地址（将生成的h5页面url传递给码上淘），该页面嵌套在码上淘页面提供的iframe内

 

       3.     如何完成该页面的制作：

 

        首先在开放平台创建：互动应用，具体流程参考：

 

码上淘iframe父页面样式如下

红框部分是iframe（宽940px，高度自适应  ）嵌入的ISV页面地址，这里有可能码平台会传入参数，如果有传入，ISV页面在制作完成后，post到码平台时需要回传过来， 例如：<ifame src=” http://container.open.taobao.com/container?appkey=xxxxx?from=ma>

将完整链接回传给码平台，码平台页面处理逻辑如下：

详细说明：

1.     码上淘父iframe页面地址

 http://ma.taobao.com/web/template_page.htm

 

2.     ISV 制作iframe页面 登录授权

基于TOP协议的登录授权方式：见：//open.taobao.com/doc/detail.htm?id=101423

3.     ISV制作的iframe页面与码上淘父页面通信

参数	是否必须	说明
appkey:	必选	后台应用appkey
bizId	可选	参数bizId=xxxx （返回上一步，读取用户填写的内容） 码平台传入的固定参数，不必关心参数内容，接收后，后面完成制作跳转到码平台一样回传； 业务参数：bizId=xxx。 这个参数是在编辑二维码时，ISV传给淘宝的参数，用以记录当次编辑的那条记录，这样子在用户创建码进入选择渠道第5步时，返回上一步，码平台iframe会带上此参数：<ifame src=”http://www.xxxisv.com/make_qrcode.htm?bizId=xxxx”>,ISV能通过此参数，查找编辑的数据，加载给用户重新编辑； 如果一个APP对一个用户只有一条记录，此参数可以 忽略
name	必选	可以是APP应用名等，方便用户在二维码列表管理查看
url	必选	*   //输入*
drawerId	可选	生成二维码美化类似旺旺头像的样式名、会动的二维码等
其他码平台iframe传入的参数	必选	全部回传

 

      与iframe父页面通信，采用postMessage，实现跨域通信。iframe向父页面发送消息：

 

     window.parent.postMessage(message,’*’);//2个参数缺一不可，第一个参数是要发送的数据，第二个参数是允许通信的域名，需要进行限定。

     说明：

     message是字符串，JSON.stringify({”step”：”pre”，”content”:{“name”:””，”url”:””}}),即需要将json对象转化为字符串形式传输。

       url：* //输入*

       name：二维码名称

       step：'pre':跳转第一步，'next'：跳转第三步

 

4.     ISV制作的iframe页面注意的问题

1）该页面不需要登录

淘宝会员未登录用户就能访问并完成H5页面互动的页面，由于不需要登录拿到用户信息，即不需要会员授权，这样的页面，直接可以用H5页面地址作为扫码后的结果页，可以把H5直接地址作为上面制作二维码的url地址参数；

2）  需要淘宝会员登录，这种需要用户授权，所以扫码后，授权页面：

访问完成后，授权完成跳转到直接的ISV的H5页面，并把前面的参数带下来，ISV页面才知道要显示什么内容，这时候的H5页面，能拿到当前登录淘宝会员的混淆nick,会员的一些操作行为可以通过记录这个混淆nick的行为和商家的关系了。

 这种情况下，制作二维码的url地址参数就不是直接H5页面了，而是上面的TOP登录授权地址加上业务参数，ISV制作完成H5页面，要把这样的url作为参数传给码上淘

 

三. 其他相关知识

1. 互动应用

 

互动应用以两种方式接入，PC版本以店铺模块方式接入，无线版本以无线店铺应用方式接入。均需接入TAE（JAE）环境。以下为详细接入方式介绍：

店铺模块（PC版本）：//open.taobao.com/doc/detail.htm?id=102341

无线店铺应用（无线版本）：//open.taobao.com/doc/detail.htm?id=102469

 

2.手淘前端JSSDK，集成手淘相关开放能力

http://coolgame.play.m.jaeapp.com/doc/index.html

 

FAQ

关于此文档暂时还没有FAQ