更新:
- 将 Project 设置为 N/A 以将 API 客户端定义为团队级客户端。
- 将角色设置为管理员
- 请检查您的客户角色是否为管理员。
成员的角色决定了 AppGallery Connect 中的权限。管理员拥有大部分操作权限,可以添加成员账户并为其分配权限。角色与权限的对应关系请参考Roles and Permissions。
- 使用 AppGallery Connect API
调用AppGallery Connect API,您需要通过API客户端模式和OAuth客户端模式,提前获得AppGallery Connect服务器的授权。以API客户端方式调用AppGallery Connect API,您需要在AppGallery Connect中管理您的API客户端。 API 客户端只能由您的团队帐户持有人管理。基本流程如下:
A.创建 API 客户端
- 登录AppGallery Connect 并选择用户和权限。
- 从左侧导航树中转到Api Key > AppGalleryConnect API,然后点击创建。
- 将Name设置为自定义的客户端名称,将Roles设置为对应的角色,然后点击Confirm。
- 客户端创建成功后,在客户端信息列表中记录Client ID和Key的值。
查看下面的截图:
B.获取访问API的Token
创建API客户端后,需要在AppGallery Connect中对API客户端进行认证。认证成功后,API客户端获取访问AppGallery Connect API的访问令牌。使用此访问令牌,您可以访问 AppGallery Connect API。
要获取访问令牌,您需要将调用Obtaining a Token API 的代码添加到您的应用程序中。
public static String getToken(String domain, String clientId, String clientSecret) {
String token = null;
try {
HttpPost post = new HttpPost(domain + "/oauth2/v1/token");
JSONObject keyString = new JSONObject();
keyString.put("client_id", "18893***83957248");
keyString.put("client_secret", "B15B497B44E080EBE2C4DE4E74930***52409516B2A1A5C8F0FCD2C579A8EB14");
keyString.put("grant_type", "client_credentials");
StringEntity entity = new StringEntity(keyString.toString(), Charset.forName("UTF-8"));
entity.setContentEncoding("UTF-8");
entity.setContentType("application/json");
post.setEntity(entity);
CloseableHttpClient httpClient = HttpClients.createDefault();
HttpResponse response = httpClient.execute(post);
int statusCode = response.getStatusLine().getStatusCode();
if (statusCode == HttpStatus.SC_OK) {
BufferedReader br =
new BufferedReader(new InputStreamReader(response.getEntity().getContent(), Consts.UTF_8));
String result = br.readLine();
JSONObject object = JSON.parseObject(result);
token = object.getString("access_token");
}
post.releaseConnection();
httpClient.close();
} catch (Exception e) {
}
return token;
}
获取访问令牌后,您可以在访问AppGallery Connect API时使用访问令牌进行身份认证。访问令牌的默认有效期为 48 小时。如果访问令牌过期,您需要获取新的访问令牌。
C.访问 API
获取访问令牌后,您可以使用访问令牌调用AppGallery Connect API完成功能开发。