易信开放平台

还没帐号?

易信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分享纯文本为例,代码样例如下:
js代码示例

三、收藏

除了分享至朋友圈之外,易信开放平台还支持收藏至易信“我的收藏”,目前支持纯文本、图片、图文三种类型的收藏。
易信开放平台收藏接口地址:http://open.yixin.im/fav,url拼接及参数要求与分享一致。