Linkedin

auth login getEmailAndURN share

概述

此插件提供了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

第三方登录

login({params}, callback(ret))

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) {
           api.alert({
            msg: 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) {
           api.alert({
            msg: JSON.stringify(ret)
        })
        }
    });
}

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

share

分享

share({params}, callback(ret))

params

access_token：

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

expires_in：

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

shareUrl：

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) {
           api.alert({
            msg: JSON.stringify(ret)
        })
        }
    });
}

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18