使用场景:
通过自建应用调用第三方生成二维码能力,生成第三方特有规则二维码并在作品内进行展示,用以实现客户自身营销场景
...
接口描述: 获取第三方的二维码
应用权限:自建应用-编辑器-集成场景码
前端会请求 /api2/app/appcenter/getThirdSenceCode 这个接口并将携带部分参数
后端会根据前端传递的参数进行自建应用id查找对应的集成场景码接口地址
然后拼接剩余参数 携带拼接后的完整参数请求查找到的集成场景码接口地址
请求参数(前后端一起拼接而来):请求参数:
字段名 | 描述 | 类型 | 是否必须 |
---|---|---|---|
audid |
兔展客户档案用户id,当前访问作品的C端用户ID | String | 否 | |
appid | 兔展作品id | String | 是 |
orgId(后) | 兔展企业唯一标识ID | String | 是 |
openid | 微信授权的openId | String | 否 |
unionid | 微信授权的unionid | String | 否 |
saudid | 邀请者用户id | String | 否 |
identityId | 多环境授权识别的用户身份ID | String | 否 |
url |
作品url地址 | String |
是 |
shareParams |
作品分享参数 |
String | 否 |
...
urlParams |
字段名
描述
类型
是否必须
作品url参数 |
String | 否 |
integrationAppId |
自建应用id(是一串数字组成的字符串) | String | 否 |
openids(后) |
身份识别标识集合 |
Object |
是 |
openids 身份识别标识
参数名称 |
---|
参数说明 |
---|
请求类型 |
---|
是否必须 |
---|
数据类型 |
---|
schema |
---|
openid |
body |
false |
string |
unionid |
body |
false |
string |
privince
sex
language
privilege
注:wechatUserData的数据除了由微信授权而来,也可以由url参数userInfo字段传过来,如果数据来源于userInfo,则wechatUserData字段的格式与值则与url参数上一致。
appUserInfo字段定义:
appUserInfo字段由,自建应用=>APP环境集成=>授权SDK中的getUserInfo字段决定
请求示例:
|
fromTo | 应用类型(contentminiapp:小程序, workwechat:企业微信外部联系人, gzh:公众号, workwechatgroup:客户群) | body | false | string | |
appid | 应用ID | body | false | string | |
jcappid | 系统集成应用实例ID | body | true | long | |
identityId | 身份识别类型ID | body | true | string | |
identityType | 身份识别类型(phone: 手机号码, id: 第三方用户ID, openid: 公众号openid, unionid: 开放平台unionid) | body | true | string |
请求示例:
返回参数:
字段名 | 描述 | 类型 | 是否必须 | ||
---|---|---|---|---|---|
code | 结果返回码,200为正常,其余都为错误 | String | 是 | ||
msg | 结果描述 | String | 是 | ||
data | 返回内容 | TObject | 是 | ||
data | |||||
url | 图片url/要渲染成二维码的内容文本 | String | 是 | ||
└─type | 0:要渲染的内容。1:图片url | type | 0:要渲染的内容/1:图片url | Number | 是 |
返回实例:
...
是。type和url是key-value成对方式返回 | |||
└─url | type=0时,要渲染成二维码的内容文本。type=1时,图片url | String | 是。注意:url的访问策略支持作品域名跨域访问,总之就是url不要设置额外的访问限制策略 |
返回示例: