版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

使用场景:

通过自建应用调用第三方生成二维码能力,生成第三方特有规则二维码并在作品内进行展示,用以实现客户自身营销场景

...

接口描述: 获取第三方的二维码

应用权限:自建应用-编辑器-集成场景码


前端会请求 /api2/app/appcenter/getThirdSenceCode 这个接口并将携带部分参数

后端会根据前端传递的参数进行自建应用id查找对应的集成场景码接口地址

然后拼接剩余参数 携带拼接后的完整参数请求查找到的集成场景码接口地址


请求参数(前后端一起拼接而来):请求参数:

字段名

描述

类型

是否必须

audid

兔展客户档案用户id
兔展客户档案用户id,当前访问作品的C端用户IDString
appid兔展作品idString
orgId(后)兔展企业唯一标识IDString
openid微信授权的openIdString
unionid微信授权的unionidString
saudid邀请者用户idString
appUserInfo自建应用授权用户信息
Object
identityId多环境授权识别的用户身份IDString
urlParams
url
作品url参数
作品url地址String
wechatUserDataintegrationAppId自建应用id
shareParams
微信授权的所有用户信息,具体内容取决于运行环境Object
作品分享参数
String

...

appid兔展客户档案用户id
urlParams

字段名

描述

类型

是否必须

作品url参数
String
openid
integrationAppId
微信授权的openId
自建应用id(是一串数字组成的字符串)String
unionid
openids(后)
微信授权的unionid
身份识别标识集合
String
Object
headimgurl

openids 身份识别标识

微信授权字段:头像地址

参数名称

String

参数说明

请求类型

nickname

是否必须

微信授权字段:昵称

数据类型

String

schema

openid
city

body
微信授权字段:城市
false
String
string

unionid
country

body
微信授权字段:国家
false
String
string

privince

微信授权字段:省份String

sex

微信授权字段:性别Number

language

微信授权字段:语言String

privilege

微信授权字段:用户特权信息String[]

附微信授权字段文档:https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html#%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97

注:wechatUserData的数据除了由微信授权而来,也可以由url参数userInfo字段传过来,如果数据来源于userInfo,则wechatUserData字段的格式与值则与url参数上一致。

appUserInfo字段定义:

appUserInfo字段由,自建应用=>APP环境集成=>授权SDK中的getUserInfo字段决定

请求示例:

{
    appUserInfo: null,
    appid: "18347aeb-b3ab-4ccf-a151-1a221acf6a77",
    audid: "1032246609458597888",
    identityId: "",
    integrationAppId: "1032292108047720448",
    openid: "o2shHwq9YY0s3GXQ4XY8lwzwujBs",
    unionid: "olgEc08RabzYkT8Bkt2Ix1D-4hMQ",
    wechatUserData: {
        headimgurl: "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTKicsm1ZhxZTUI338icwkEw0GFbdGjyxF19WONuek7Rwiby3JQiblkbeiaM4YO17b2ibk3MQBVhZdjFic4YA/132",
        nickname: "未授权访客",
        openid: "o2shHwq9YY0s3GXQ4XY8lwzwujBs",
        unionid: "olgEc08RabzYkT8Bkt2Ix1D-4hMQ",
        city: "",
        country: "",
        province: "",
        sex: 0
    },
    urlParams: "a=a&b=b&c=c"
}


fromTo应用类型(contentminiapp:小程序, workwechat:企业微信外部联系人, gzh:公众号, workwechatgroup:客户群)bodyfalsestring
appid应用IDbodyfalsestring
jcappid系统集成应用实例IDbodytruelong
identityId身份识别类型IDbodytruestring
identityType身份识别类型(phone: 手机号码, id: 第三方用户ID, openid: 公众号openid, unionid: 开放平台unionid)bodytruestring


请求示例:




返回参数:

字段名描述类型是否必须
code结果返回码,200为正常,其余都为错误String
msg结果描述String
data返回内容TObject
data
url图片url/要渲染成二维码的内容文本String
└─type0:要渲染的内容。1:图片urltype0:要渲染的内容/1:图片urlNumber

返回实例:

...

是。type和url是key-value成对方式返回
└─urltype=0时,要渲染成二维码的内容文本。type=1时,图片urlString是。注意:url的访问策略支持作品域名跨域访问,总之就是url不要设置额外的访问限制策略


返回示例: