将商家订阅的行业包升级到指定版本。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 UpgradePackage

系统规定参数,取值:UpgradePackage

RobotCodes Array of String 是 1cY9drMec4b2uzS2

机器人Code

PackageDTO Object 是

需要升级的行业包

PackageCode String 是 common

行业包code

PackageVersion String 是 2

行业包版本

Operator Object 是

操作人信息

OperatorId String 是 10006

操作人id

OperatorName String 是 张三

操作人显示名称

返回数据

名称 类型 示例值 描述
RequestId String 59C3CCE4-24B1-4277-A4A0-C0EFE4C14E0A

请求id

Data Object

成功和失败的机器人code

SuccessRobotCodes Array of String 1cY9drMec4b2uzS2

机器人code

FailedRobotCodes Array of String 1hyxlX1n9T0mMwwo

机器人code

Success Boolean true

是否成功

Code String 200

错误码

Message String successful

错误信息

示例

请求示例

http(s)://[Endpoint]/?Action=UpgradePackage
&RobotCodes=["1cY9drMec4b2uzS2"]
&PackageDTO={"PackageCode":"common","PackageVersion":"2"}
&Operator={"OperatorId":"10006","OperatorName":"张三"}
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<UpgradePackageResponse>
    <RequestId>59C3CCE4-24B1-4277-A4A0-C0EFE4C14E0A</RequestId>
    <Data>
        <SuccessRobotCodes>1cY9drMec4b2uzS2</SuccessRobotCodes>
        <FailedRobotCodes>1hyxlX1n9T0mMwwo</FailedRobotCodes>
    </Data>
    <Success>true</Success>
    <Code>200</Code>
    <Message>successful</Message>
</UpgradePackageResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "59C3CCE4-24B1-4277-A4A0-C0EFE4C14E0A",
  "Data" : {
    "SuccessRobotCodes" : [ "1cY9drMec4b2uzS2" ],
    "FailedRobotCodes" : [ "1hyxlX1n9T0mMwwo" ]
  },
  "Success" : true,
  "Code" : "200",
  "Message" : "successful"
}

错误码

HttpCode 错误码 错误信息 描述
429 Throttling.Api The request was denied due to API flow control. 请求已超过最大允许的流量
500 InternalError The request processing has failed due to some unknown error. 内部服务出现错误

访问错误中心查看更多错误码。