为用户授权软件License

本接口用于无影应用中心通知ISV为用户授权软件License,即为用户发放软件License。

接口说明

无影应用中心的用户分为便捷用户和AD用户,授权时,至少需要提供其中一种类型的用户列表,即edsSimpleUserList和edsAdUserList中,至少配置一个。

请求参数

名称

类型

是否必选

示例值

描述

action

String

CREATE_ORDER

请求操作类型。取值:LICENSE_ADD_USERS。

orderId

Long

1234512345

订单ID。

buyerId

Long

123451234512345

买家ID。

hashBuyerId

String

abc123abc123abc123

买家ID经过Hash算法转换后生成的值。

edsUserType

String

SIMPLE

用户类型。取值范围:

  • SIMPLE :便捷用户

  • AD:AD用户

edsSimpleUserList

String

[{ "userId": "1234", "userName": "alice", "userEmail": "a***@example.net"}]

要授权的便捷用户列表。包含以下参数:

  • userId:便捷用户ID

  • userName:便捷用户名

  • userEmail:便捷用户邮箱

edsAdUserList

String

[{ "userName": "alice", "workspaceName": "cn-hangzhou+dir-5628123***"}]

要授权的AD用户列表。包含以下参数:

  • userName:AD用户名

  • workspaceName:AD用户所属的工作区ID

请求示例如下:

{
   "action": "LICENSE_ADD_USERS",
   "orderId": 1234512345,
   "buyerId": 123451234512345,
   "hashBuyerId": "abc123abc123abc123",
   "edsUserType": "SIMPLE",
   "edsSimpleUserList": [{ "userId": "1234", "userName": "alice", "userEmail": "a***@example.net"}],
   "edsAdUserList": [{ "userName": "alice", "workspaceName": "cn-hangzhou+dir-5628123***"}]
}

返回数据

名称

类型

示例值

描述

success

Boolean

true

是否成功授权。可能值:

  • true:授权成功

  • false:授权失败

edsSimpleUserList

String

[{ "userId": "1234", "userName": "alice", "userEmail": "a***@example.net"}]

如果授权成功,则返回所有已授权的便捷用户列表。包含以下参数:

  • userId:便捷用户ID

  • userName:便捷用户名

  • userEmail:便捷用户邮箱

edsAdUserList

String

[{ "userName": "alice", "workspaceName": "cn-hangzhou+dir-5628123***"}]

如果授权成功,则返回所有已授权的AD用户列表。包含以下参数:

  • userName:AD用户名

  • workspaceName:AD用户所属的工作区ID

errorMessage

String

error msg

如果授权失败,则返回具体的错误信息。

errorCode

String

XXXX_YYYY

如果授权失败,则返回具体的错误码。

返回示例如下:

  • 授权成功

    {
        "success": true,
        "edsSimpleUserList": [{ "userId": "1234", "userName": "alice", "userEmail": "a***@example.net"}],
        "edsAdUserList": [{ "userName": "alice", "workspaceName": "cn-hangzhou+dir-5628123***"}],
        "errorMessage": null,
        "errorCode": null
    }
  • 授权失败

    {
        "success": false,
        "edsSimpleUserList": [],
        "edsAdUserList": [],
        "errorMessage": "error msg",
        "errorCode": "XXXX_YYYY"
    }