一、动态获取app key

1.oauth2.0接口

(1)code预授权码接口

请求 URL:https://openapi.aldwx.com/Main/action/Oauth/Oauth/authorize

请求方式:POST

请求参数:

名称 类型 是否必填 说明
response_type String 默认值:code
client_id String 第三方 id 登录后台在【开发助手】-【配置认证】中查看
state String 防止 CSRF 攻击。原样返回
redirect_uri String 回调URL,会将生成的code值,返回到URL中(在本URL中GET接受code参数即可)

返回正确参数:

名称 类型 是否必填 说明
code String 返回获取的code。 例如:fe7e2a0b0fca16769e53b43f480cf3f268787e44
state String 前台传过来的 state 原样返回

返回失败参数:

名称 类型 是否必填 说明
error String 错误类型
error_descripti on String 错误详细描述

1111231231231111

(2)access_token令牌钥匙接口

请求 URL:https://openapi.aldwx.com/Main/action/Oauth/Oauth/access_token

请求方式:POST

请求参数:

名称 类型 是否必填 说明
grant_type String 默认值:authorization_code
client_id String 第三方 id 登录后台在【开发助手】-【配置认证】中查看
client_secret String 第三方 登录后台在【开发助手】-【配置认证】中查看
code String code 接口获取的 code
redirect_uri String 该回调URL,与获取code的redirect_uri保持一致

返回正确参数:

名称 类型 是否必填 说明
access_token String 返回 令牌钥匙access_token 例如: 5ec53af0ea9efdee8a11d3dbae83 0a4c22818896
expires_in Int 有效时间 默认一天
token_type String 令牌类型
scope String 权限范围
refresh_token String 刷新令牌:用于重新获取 access_token 有效时间 默认 14 天

返回失败参数:

名称 类型 是否必填 说明
error String 错误类型
error_descripti on String 错误详细描述

(3)access_token刷新令牌钥匙接口

请求 URL:https://openapi.aldwx.com/Main/Action/Oauth/Oauth/refresh_token

请求方式:POST

请求参数:

名称 类型 是否必填 说明
grant_type String 默认值:refresh_token
client_id String 第三方id 登录后台在【开发助手】-【配置认证】中查看
client_secret String 第三方 secret 登录后台在【开发助手】-【配置认证】中查看
refresh_token String 刷新令牌: 用于重新获取 access_token接口获取的refresh_token

返回正确参数:

名称 类型 是否必填 说明
access_token String 返回 令牌钥匙access_token 例如: 5ec53af0ea9efdee8a11d3dbae83 0a4c22818896
expires_in Int 有效时间 默认一天
token_type String 令牌类型
scope String 权限范围
refresh_token String 刷新令牌:用于重新获取 access_token 有效时间 默认 14 天

返回失败参数:

名称 类型 是否必填 说明
error String 错误类型
error_description String 错误详细描述

2.小程序接口

(1)注册小程序接口

请求 URL:

https://openapi.aldwx.com/Main/action/Appregister/Appregister/getApp?access_token=5ec53af0ea9efdee8a11d3dbae830a4c22818896

请求方式:POST

注意:access_token=5ec53af0ea9efdee8a11d3dbae830a4c22818896(自己生成的令牌钥匙)

请求参数:

名称 类型 是否必填 说明
app_name String 小程序名称
app_logo String 小程序 logo 的 URL
user_id String 小程序开发者标识

返回参数:

名称 类型 是否必填 说明
code String 返回状态 200 成功 202 失败
msg String 返回状态说明
data ·Obj 返回数据数组 详细见下

data 表格说明:

名称 类型 是否必填 说明
appkey String 小程序 key

(2)删除小程序接口

请求 URL:

https://openapi.aldwx.com/Main/action/Appregister/Appregister/del_app?access_token=5ec53af0ea9efdee8a11d3dbae830a4c22818896

请求方式:POST

注意:access_token=5ec53af0ea9efdee8a11d3dbae830a4c22818896(自己生成的令牌钥匙)

请求参数:

名称 类型 是否必填 说明
app_key String 小程序app_key,可单个app_key,也可多个app_key.单个app_key例如 :6a5a244a31f3c78d2de7b95fb335d559多个app_key,例如 : 6a5a244a31f3c78d2de7b95fb335d559,6a5a244a31f3c78d2de7b95fb335d559(注意:每个app_key中间使用逗号隔开)

返回参数:

名称 类型 是否必填 说明
code String 返回状态 200 成功 202 失败
msg String 返回状态说明
data Obj 返回数据数组

(3)修改小程序接口

请求 URL:

https://openapi.aldwx.com/Main/action/Appregister/Appregister/update_appname?access_token=5ec53af0ea9efdee8a11d3dbae830a4c22818896

请求方式:POST

注意:access_token=5ec53af0ea9efdee8a11d3dbae830a4c22818896(自己生成的令牌钥匙)

请求参数:

名称 类型 是否必填 说明
app_key String 小程序app_key,可单个app_key,也可多个app_key.单个app_key例如 :6a5a244a31f3c78d2de7b95fb335d559多个app_key,例如 : 6a5a244a31f3c78d2de7b95fb335d559,6a5a244a31f3c78d2de7b95fb335d559(注意:每个app_key中间使用逗号隔开)
app_name 小程序名称

返回参数:

名称 类型 是否必填 说明
code String 返回状态 200 成功 202 失败
msg String 返回状态说明
data Obj 返回数据数组

3.资源请求接口

资源请求接口只需要 access_token 令牌钥匙、appkey(阿拉丁生成的),这两个参数即可。

二、内嵌iframe

在你们自己的商家系统左侧菜单上增加一个菜单

请求方式:

GET

请求参数:

app_key=常见小程序后获取的 appkey

access_token=会话密钥

Demo:

https://statistic.plugin.aldwx.com/assets?app_key=demo1&access_token=demo_access_key

三、引入SDK

1.引入san.js

使用微信开放平台后,saas平台会有管理代码的权限,将代码添加成为模板后,将获取的SDK(san.js)拷贝到对应模板项目的 utils文件夹中,目前SDK提供了两种接入方式

1.1标准版引入方式

针对没有使用微信小程序插件(例如腾讯视频)的接入方式

在app.js中引入:var ald = require('./utils/san.js')

1.2引用插件小程序版本引入方式

针对有使用微信小程序插件(例:腾讯视频)的小程序,需要在app.js中声明引入:var App = require('./utils/san.js').App

C:\\Users\\18072\\AppData\\Local\\Temp\\WeChat Files\\425994284197391577.png

小程序所有页面需要声明引入:var Page = require('../../utils/san.js').Page

2.配置ald-cof.js

微信开放平台规定:为了便于第三方平台使用同一个小程序模版为不同的小程序提供服务,第三方可以将自定义信息放置在ext_json中。所以可以将如下我们的配置内容放在第三方自定义的配置ext_json中,san.js会使用wx.getExtconfig获取ald-conf.js配置。

"ald_config":{

"app_key":"阿拉丁分配给小程序的标识",

"getLocation":0, //1代表启⽤用,0代表关闭

"getUserinfo":0, //1代表启⽤用,0代表关闭

}

四、配置request合法域名

五、反向代理自己的域名

内嵌iframe页面成功后,点击iframe页面button,进入阿拉丁统计后台的域名可以修改为您自己平台的域名。具体配置流程:

  1. 虚拟主机配置

  2. 页面添加平台一级域名

在open.aldwx.com登录之后,后台的【设置】-【更换域名】中,填写您平台下的域名,提交确认后,商家在您平台上从iframe页面跳转至阿拉丁的一级域名为您提交的域名。

配置完成检查

  1. 在小程序开发者工具Network中看到有log.aldwx.com请求上报,且headers中状态为“200 ok”及“ak”字段中确认与您小程序动态生成的app key相同,视为接入成功 。

C:\\Users\\18072\\AppData\\Local\\Temp\\WeChat Files\\417568501698785321.png

© aldwx.com 北京阿拉丁未来科技有限责任公司 all right reserved,powered by Gitbook修订时间: 2018-11-15 10:20:45

results matching ""

    No results matching ""