# 新手入门

为帮助开发者更快地熟悉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。

← 应用案例 →

  • 在线客服

  • 意见反馈