易信Web/Wap分享使用新手指南
本文将介绍通过web(浏览器)/wap(手机浏览器)分享到易信朋友圈的使用方法。如果你开发的是手机app,想使用SDK进行分享,请查阅
IOS指南 或
Android指南。
一、准备
- 如果您已经在易信开放平台注册了该产品,获取了appId【同一个产品的不同终端app都可以采用同一个appId】,那么请直接使用该appId。否则,请按照下面的
流程注册开通您的产品并提交审核。
- 1. 注册一个易信帐号,如果您还没有易信帐号,请下载易信客户端APP注册开通一个易信帐号。
- 2. 使用易信帐号登录开放平台,转到应用管理页面,添加一个新应用。
- 3. 填写你的应用资料,完成后保存,你会获得一个AppID,同时请提交审核。
- 审核通过的应用将在内容来源处显示你填写的应用名称,否则显示“未审核应用”。
二、开发
- 目前您可分享到易信朋友圈的内容类型包括纯文本(text)、图片(image)、图文(webpage)、音频(music)、视频(video)五种类型,分享时请将相应的类型字符串设置到type字段!
- 1. 纯文本分享(type="text"):
-
appkey :你在易信开放平台申请的appId,审核通过的应用将在内容来源处显示你填写的应用名称,否则显示“未审核应用”。用户在分享界面不可修改。
-
type :纯文本类型的分享请设置为"text"。用户在分享界面不可修改。
-
text :从你的应用中预设分享出去的文本,用户在分享界面不可修改。该字段必需。
-
userdesc :你的应用为用户预设的输入文本,用户可自行修改。
- 2. 图片分享(type="image"):
-
appkey :你在易信开放平台申请的appId,审核通过的应用将在内容来源处显示你填写的应用名称,否则显示“未审核应用”。用户在分享界面不可修改 。
-
type :图片分享类型的分享请设置为"image"。用户在分享界面不可修改。
-
title :从你的应用中预设分享出去的标题。用户在分享界面不可修改。
-
desc :从你的应用中预设分享出去的文本,用户在分享界面不可修改。
-
userdesc :你的应用为用户预设的输入文本,用户可自行修改。
-
pic :缩略图url,建议尺寸300px*300px。用户在分享界面不可修改。
-
url :图片的大图url。该字段必需。
- 3. 图文分享(type="webpage"):
-
appkey :你在易信开放平台申请的appId,审核通过的应用将在内容来源处显示你填写的应用名称,否则显示“未审核应用”。用户在分享界面不可修改。
-
type :图片分享类型的分享请设置为"webpage"。用户在分享界面不可修改。
-
title :从你的应用中预设分享出去的标题。用户在分享界面不可修改。
-
desc :从你的应用中预设分享出去的文本,用户在分享界面不可修改。
-
userdesc :你的应用为用户预设的输入文本,用户可自行修改。
-
pic :缩略图url,建议尺寸300px*300px。用户在分享界面不可修改。
-
url :该图文资源对应的网页地址url,易信中点击该消息时将调用webview进行访问。用户在分享界面不可修改。该字段必需。
- 4. 音频(type="music"):
-
appkey :你在易信开放平台申请的appId,审核通过的应用将在内容来源处显示你填写的应用名称,否则显示“未审核应用”。用户在分享界面不可修改。
-
type :图片分享类型的分享请设置为"music"。用户在分享界面不可修改。
-
title :从你的应用中预设分享出去的标题。用户在分享界面不可修改。
-
desc :从你的应用中预设分享出去的文本,用户在分享界面不可修改。用户在分享界面不可修改。
-
userdesc :你的应用为用户预设的输入文本,用户可自行修改。用户在分享界面不可修改。
-
pic :缩略图url,建议尺寸300px*300px。用户在分享界面不可修改。
-
music :音频资源的url,点击播放时候将加载此url资源。该字段必需。
-
url :该音频资源对应的网页地址url,易信中点击该消息时将调用webview进行访问。用户在分享界面不可修改。该字段必需。
- 5. 视频(type="video"):
-
appkey :你在易信开放平台申请的appId,审核通过的应用将在内容来源处显示你填写的应用名称,否则显示“未审核应用”。用户在分享界面不可修改。
-
type :图片分享类型的分享请设置为"video"。用户在分享界面不可修改。
-
title :从你的应用中预设分享出去的标题 。用户在分享界面不可修改。
-
desc :从你的应用中预设分享出去的文本,用户在分享界面不可修改。
-
userdesc :你的应用为用户预设的输入文本,用户可自行修改
-
pic :缩略图url,建议尺寸300px*300px。用户在分享界面不可修改。
-
url :该视频资源对应的网页地址url,易信中点击该消息时将调用webview进行访问。用户在分享界面不可修改。该字段必需。
- url构造:
-
易信开放平台分享地址:http://open.yixin.im/share,根据不同的type拼装相应的字段,形如http://open.yixin
.im/share?appkey=xxx&type&……, 特殊字段请进行encode,然后使用get方式访问
以第三方网站网页点击使用js分享纯文本为例,代码样例如下:
三、收藏
除了分享至朋友圈之外,易信开放平台还支持收藏至易信“我的收藏”,目前支持纯文本、图片、图文三种类型的收藏。
易信开放平台收藏接口地址:http://open.yixin.im/fav,url拼接及参数要求与分享一致。