# 新手入门

为帮助开发者更快地熟悉AECORE数字中台,能够迅速地在平台对接服务开发应用、新手入门将讲述如何注册成为AECORE的开发者、创建一个应用、开通服务、接口鉴权、应用案例

# 成为开发者

任何个人和企业可以在AECORE注册成为开发者,如果之前有广联达账号,可以直接登录

若没有广联达账号,请点击AECORE官网右上角“免费注册”按钮,进行注册

点击注册后,会跳转至注册界面,请按照界面完成基本信息的填写。如下图所示:

TIP

1、AECORE既面向内部开发者又面向行业开发者开放,公司内部员工请统一使用公司邮箱注册,外部开发者使用手机号注册

2、公司内部员工,若通过管理员邀请未收到邀请邮件,说明之前该邮箱已经成功注册过,如果不记得可使用忘记密码进行账号密码重置和登录。

公司员工注册只需填写邮箱前缀即可。

邮箱注册后会给填写的邮箱中发一份激活验证邮件,请点击邮箱激活链接完成注册激活,只有完成邮箱激活后该账号才算真正注册成功。

行业开发者注册,请填写正确的手机号,按照手机收到的验证码完成验证激活。

# 创建一个应用

注册登录后即可进入应用开发。点击【创建应用】进行应用创建。创建应用获取的appkey和appsecret是调用服务的秘钥证书,一定要妥善保管。

  • 创建应用

  • 填写应用信息

    应用名称:产品/应用的中文名称,创建后可修改。请填写有意的名称,方便后期团队或自己对应用的管理。

    应用标识:产品/应用的英文标识,全局唯一,创建后不可修改。请填写与中文名对应的英文缩写或简称。

    联系邮箱/联系电话:请填写正确的联系邮箱和电话,否则校验失败会报错。默认创建者就是对应联系人;

    其中:属性分为内外产品,广联达内部产品请选择对应的产品线。

PS:一个账号下可创建多个应用,用于不同场景下对服务调用的使用。如一个appkey测试,一个appkey正式环境调用,大家都可以在应用名称上做以标识。

# 开通订阅服务

应用创建成功后即刻进入到应用详情页,在应用详情页,你可以查看应用证书(即appkey和appsecret),可选择AECORE平台上上架发布服务,进行服务开通订阅。

其中,用户中心为默认开通的服务,基础功能权限默认开放,如需高级功能权限请点击红框标记的图标申请。

除此之外,大家可以在全部产品与服务里选择需要的进行开通订阅。

以开通“样例技术服务”为例,操作如下

1.选择样例技术服务

2.点击立即开通

3.选择所需要的scope

4.进入服务控制台,根据服务快速启动和开发文档进行对接,具体详见各产品与服务的文档,点击进入文档中心

5.服务开通后,在应用详情页就会展示当前已开通的服务信息,但服务功能是否可以掉通,一定要查看对应服务的scope授权状态,只有“已授权”状态才可以

TIP

1、并非所有服务都会设置服务权限范围,未设置scope的服务开通即可使用全部服务资源;

2、设置了服务范围(即scope)的服务,开通后并不代表可立刻使用该功能,需要再次确认scope的授权状态,

非“已授权”状态的scope,在调用该功能的时候会报错!

# 接口鉴权

当服务开通后,进行API调用前,首先需要用创建应用获得的appkey和appsecret换取accesstoken。当前AECORE使用统一的应用认证,做到了一个appkey可以开通使用平台上的所有技术服务,保证随应用场景的实时开通、实时调用。

# 获取访问服务token方式

  1. 将创建应用时获得的appkey和appsecret,进行base64编码,示例如下
String creds = String.format("%s:%s", appKey, appSecret); // appkey和appsecret之间有一个冒号,拼成字符串,如: appKey:appSecret
String credential = Base64.encode(creds.getBytes("UTF-8"));
1
2

​ 也可通过在线网站获取base64编码https://www.base64encode.org/

  1. 在shell命令行中向用户中心发起获取token http请求,将上面的base64编码放入请求头Authorization中,并在前面加上"Basic "中。
curl -X POST -H "Authorization: Basic XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX=" \
"https://account.glodon.com/oauth2/token?grant_type=client_credentials"
1
2

注意

1、注意Basic后有空格;

2、请使用自己创建的appkey和appsecret生成base64编码替换文中的XXX;

3、如果是在windows平台的CMD命令行中运行,请将上面的shell命令行分隔符""替换成windows CMD分隔符"^"

  1. 请求返回结果如下
{
    "access_token": "cn-16615e2b-a522-4cb6-9cb8-b8d2405cde94",
    "token_type": "bearer",
    "expires_in": 359420,
    "scope": "document_enterprise_files_write colibri_sms run document_project_files_read delete file:modify file:read member_overview document_enterprise_files_read account_info_write read document_project_files_write document_incoming_files_read file:delete document_my_files_read modify document_incoming_files_write account_token_login document_appdata_read document_my_files_write thirdservices file:create writer document_appdata_write account_info_read"
}
1
2
3
4
5
6

其中access_token即为后续发起服务API调用请求时所需的认证token。

  • 在线客服

  • 意见反馈