概述

此模块提供了linkedin的登录与分享。用户可通过领英帐号登录，无需新建帐号，从而简化注册步骤，提高新用户数量。也可以分享内容到领英。 https://www.linkedin.com/developers/

针对ios平台 注意:iOS平台不能打开第三方App登录,只能用网页进行登录

接口

auth

获取客户端授权

auth({params}, callback(ret,err))

params

client_id

类型：字符串类型
描述：注册应用时生成的“客户端编号”值

client_secret

类型：字符串类型
描述：注册应用时生成的”秘密密钥”值

redirect_uri

类型：字符串类型
描述：将在授权后向用户发送的地址。此值必须与应用配置中某个定义的 OAuth 2.0 重定向网址匹配。

state

类型：字符串类型
描述：由您选择且不易被猜中的唯一字符串值。用于阻止跨站请求伪造攻击

scope：

类型：JSON数组类型
描述：由网址编码组成且限定长度的会员权限列表，表示应用代表用户请求的权限。如果您在调用中未指定范围，我们将使用您在应用配置中定义的默认会员权限
类型：
“BASICPROFILE”：概述名称，照片，标题，和当前的位置 “FULLPROFILE”：个人资料，包括经验、教育、技能和推荐信 “EMAILADDRESS”：主要电子邮箱地址 “CONTACTINFO”：联系信息地址、电话号码和绑定帐户 “COMPANY_ADMIN”：分析编辑公司页面 “SHARE”：分享，评论和喜欢的帖子更新 “LITEPROFILE”：个人信息，头像 “MEMBER_SOCIAL”：分享 //注意:（仅android支持）
例：[“FULLPROFILE”,”EMAILADDRESS”]

callback(ret)

ret：

类型：JSON对象
内部字段：

{       
      status:,           //布尔类型；是否授权成功
      access_token:'',      //字符串类型，用户的访问令牌
      expires_in:,           //数字类型，从提出请求开始到令牌失效之前剩余的秒数
}

err：

类型：JSON对象

内部字段：

{
msg:'',          //字符串类型；错误信息
}

示例代码

    var name = api.require('Linkedin');
    name.auth({
        client_id: "86c2u9l4nqzbkz",
        client_secret: "t24vsTPbHvy8kZBc",
        redirect_uri: "https://jf2.suuzi.cn/api/base/Linkedin/callback",
        state: "apicloud123",
        scope: ["EMAILADDRESS", "LITEPROFILE", "MEMBER_SOCIAL"]
    }, function(ret,err) {
    });

可用性

Android系统

可提供的1.0.0及更高版本

login

第三方登录

params

access_token：

类型：字符串
描述：（可选项）用户的访问令牌 //注意:（iOS不用传此参数）

expires_in：

类型：数字类型
描述：（可选项）从提出请求开始到令牌失效之前剩余的秒数 //注意:（（iOS不用传此参数）

callback(ret)

ret：

类型：JSON对象
内部字段：

{       
       info: ,    //JSON对象；账号内容
       error:'',  //字符串类型；错误描述
       cancel: ,  //字符串类型；取消   //注意:（仅android支持）
}

示例代码

function fnlogin(){
    var name = api.require('Linkedin');
    name.login({
         clientId:'',
         clientSecret:'',
         redirect_uri:'',
         state:'',
         scope:['Liteprofile','EmailAddress']
    }, function(ret) {
        if (ret) {
           alert(JSON.stringify(ret));
        }
    });
}

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getEmailAndURN

获取邮箱以及URN （仅android支持）

getEmailAndURN({params}, callback(ret))

params

access_token：

类型：字符串
描述：（可选项）用户的访问令牌 //注意:（iOS不用传此参数）

expires_in：

类型：数字类型
描述：（可选项）从提出请求开始到令牌失效之前剩余的秒数 //注意:（iOS不用传此参数）

callback(ret)

ret：

类型：JSON对象
内部字段：

{
   info: // JSON对象；
   error:'' // 字符串格式；错误描述
}

示例代码

function fnshareWithURL(){
    var name = api.require('Linkedin');
    name.getEmailAndURN({
    }, function(ret) {
        if (ret) {
           alert(JSON.stringify(ret));
        }
    });
}

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

share({params}, callback(ret))

params

access_token：

类型：字符串
描述：（可选项）用户的访问令牌 //注意:（iOS不用传此参数）

expires_in：

类型：数字类型
描述：（可选项）从提出请求开始到令牌失效之前剩余的秒数 //注意:（iOS不用传此参数）

shareUrl：

类型：字符串类型
描述：分享地址（POST）
默认：‘https://api.linkedin.com/v2/ugcPosts’

request：

类型：JSON对象类型
描述：分享请求文本,详情参考LinkedIn分享文档

示例：分享文本示例

{
  "author": "urn:li:person:8010039680",
  "lifecycleState": "PUBLISHED",
  "specificContent": {
      "com.linkedin.ugc.ShareContent": {
          "shareCommentary": {
              "text": "linkedin share content"
          },
          "shareMediaCategory": "NONE"
      }
  },
  "visibility": {
      "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
  }
}

callback(ret)

ret：

类型：JSON对象
内部字段：

{
   info: // JSON对象；
   error:'' // 字符串格式；错误描述
}

示例代码

function fnshareWithURL(){
    var name = api.require('Linkedin');
    name.share({
               shareUrl:'https://api.linkedin.com/v2/ugcPosts',
               request:{
                       "author": "urn:li:person:DfrucA5U8H",   //DfrucA5U8H:是login接口返回的id
                       "lifecycleState": "PUBLISHED",
                       "specificContent": {
                               "com.linkedin.ugc.ShareContent": {
                                       "shareCommentary": {
                                               "text": "Hello World! This is my first Share on LinkedIn!收到发第三发"
                                       },
                                       "shareMediaCategory": "NONE"
                               }},
                       "visibility": {
                               "com.linkedin.ugc.MemberNetworkVisibility": "CONNECTIONS"
                      }
               }
    }, function(ret) {
        if (ret) {
           alert(JSON.stringify(ret));
        }
    });
}

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本