# Alibaba Cloud Wuying Sale Service API

> Alibaba Cloud Wuying Sale Service API on Apizie: 12 endpoints (Creates an order, renews, or modifies the configuration of specific products such as the monthly duration…, Queries the list of agents and usage summary information under the current username, Queries the credit usage of users, credit packages, or agents based on a specified dimension, Retrieves resource deduction and usage statistics based on specified conditions, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:aliyun-wss/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-wss`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/wss
- Page: https://apizie.tech/api/cloud/aliyun-wss
- OpenAPI: https://apizie.tech/api/cloud/aliyun-wss/openapi.json

Alibaba Cloud OpenAPI for Wuying Sale Service (wss, version 2021-12-21). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Creates an order, renews, or modifies the configuration of specific products such as the monthly duration…
`POST https://apizie.tech/v1/cloud:aliyun-wss/create-multi-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |
| OrderItems | string | no | The product information (JSON-encoded) |
| OrderType | string | no | The order type |
| Properties | string | no | The extended properties (JSON-encoded) |
| ResellerOwnerUid | integer | no | The ID of the actual end user. This parameter is required when a reseller partner places an order |
| ChannelCookie | string | no | The cookie information used for channel attribution. Specify this parameter if channel attribution information exists. Otherwise, you can… |

### Queries the list of agents and usage summary information under the current username
`POST https://apizie.tech/v1/cloud:aliyun-wss/describe-credit-package-agents` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |
| BizType | string | no | The business type |
| AgentType | string | no | The agent type. Valid values: `CREDIT_PACKAGE`, `JVS_CLAW`, `OPEN_CLAW`, and `JVS_COPILOT` |
| AgentIds | string | no | A JSON string of the AgentId list. Example: `["agent-1","agent-2"]` (JSON-encoded) |
| MaxResults | integer | no | The number of entries per page |
| NextToken | string | no | The pagination token. Set this parameter to an empty string for the first request. For subsequent requests, use the `nextToken` value from… |

### Queries the credit usage of users, credit packages, or agents based on a specified dimension
`POST https://apizie.tech/v1/cloud:aliyun-wss/describe-credit-usage-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |
| BizType | string | no | The business type |
| UsageType | string | no | The usage type. Valid values: User: Returns the used amount, remaining amount, and consumption trend of the currently active credit… |
| SceneType | string | no | The operator Scenarios type. Valid values: Not specified or NaturalMonthlyOwn: Natural monthly exclusive. JzYearlyShare: Jz annual shared.… |
| InstanceIds | string | no | The JSON string of the instance ID list. This parameter can be omitted when `UsageType` is set to `User`. Set it to the credit package… |

### Retrieves resource deduction and usage statistics based on specified conditions
`POST https://apizie.tech/v1/cloud:aliyun-wss/describe-deduction-statistic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |
| Periods | string | no | The list of time periods in JSON array format. Each element is a `PeriodParam` object (JSON-encoded) |
| ResourceTypes | string | no | The list of resource types in JSON array format (JSON-encoded) |
| StartTime | integer | no | The start time of the query. UNIX timestamp, in milliseconds |
| EndTime | integer | no | The end time of the query. UNIX timestamp, in milliseconds |
| InstanceIds | string | no | The list of instance IDs in JSON array format (JSON-encoded) |

### Retrieves information about delivery addresses
`POST https://apizie.tech/v1/cloud:aliyun-wss/describe-delivery-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |

### Queries deduction group information
`POST https://apizie.tech/v1/cloud:aliyun-wss/describe-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |
| GroupType | string | yes | The group type |
| NextToken | string | no | The pagination token. Leave this parameter empty for the first request. For subsequent requests, set this parameter to the nextToken value… |
| MaxResults | string | no | The number of entries per page |
| States | string | no | The list of states (JSON-encoded) |
| ResourceIds | string | no | The list of resource IDs (JSON-encoded) |
| StartTime | integer | no | The start time of the period |
| EndTime | integer | no | The end time of the period |
| GroupResourceTypes | string | no | The list of group resource types (JSON-encoded) |
| TimeUsingPeriod | string | no | Specifies whether to query by effective period |
| InstanceIds | string | no | The Lingxiao instance ID (JSON-encoded) |

### Queries the prices of Elastic Desktop Service products for order types such as new purchases, renewals,…
`POST https://apizie.tech/v1/cloud:aliyun-wss/describe-multi-price` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |
| OrderItems | string | no | The product information (JSON-encoded) |
| OrderType | string | no | The order type |
| PackageCode | string | no | The package code. You do not need to specify this parameter for non-package types |
| ResellerOwnerUid | integer | no | The user ID for resource ownership in the reseller pattern. You do not need to specify this parameter for non-reseller patterns |

### Queries the deduction details of core-hour packages
`POST https://apizie.tech/v1/cloud:aliyun-wss/describe-package-deductions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |
| ResourceType | string | no | The resource type |
| PackageIds | string | no | The list of core-hour package IDs in JSON format (JSON-encoded) |
| InstanceIds | string | no | The list of cloud desktop IDs. If this field is specified, the PackageIds field is required (JSON-encoded) |
| PageNum | integer | no | The current page number. Default value: 1 |
| PageSize | integer | no | The number of entries per page set in the paging Settings during a paged query. Maximum value: 100 |
| StartTime | integer | no | The start time of the query. Use a UNIX timestamp in milliseconds |
| EndTime | integer | no | The end time of the query. Use a UNIX timestamp in milliseconds |
| ResourceTypes | string | no | The array of resource types (JSON-encoded) |
| InstanceId | string | no | The instance ID, such as ecd-xxx |
| InstanceIdType | string | no | The instance ID type |
| GroupResourceTypes | string | no | The list of resource group types (JSON-encoded) |
| AgentTypes | string | no | The list of agent types (JSON-encoded) |
| AgentType | string | no | The agent type |
| RunId | string | no | The run ID |
| RunIdList | string | no | The list of run IDs (JSON-encoded) |
| DeductionTypes | string | no | The deduction types (JSON-encoded) |

### Queries AI credit deductions
`POST https://apizie.tech/v1/cloud:aliyun-wss/describe-run-id-deductions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |
| ResourceType | string | no | The resource type |
| InstanceIds | string | no | The list of cloud computer IDs. If this parameter is specified, the `PackageIds` parameter is required (JSON-encoded) |
| PageNum | integer | no | The page number. Default value: 1 |
| PageSize | integer | no | The number of entries per page for a paged query |
| StartTime | integer | no | The start time of the query. This value is a UNIX timestamp. Unit: milliseconds |
| EndTime | integer | no | The end time of the query. This value is a UNIX timestamp. Unit: milliseconds |
| AliUid | integer | no | The Alibaba Cloud UID |
| PackageIds | string | no | The list of core-hour package IDs in JSON format (JSON-encoded) |
| MaxResults | integer | no | The number of entries per page |
| NextToken | string | no | The pagination token. Leave this parameter empty for the first request. For subsequent requests, use the `nextToken` value from the… |
| ResourceTypes | string | no | The list of resource types in JSON array format (JSON-encoded) |
| InstanceIdType | string | no | The instance ID type. Do not specify this parameter for non-knowledge base scenarios |
| BizType | string | no | The business type |
| GroupSeparator | string | no | Specifies whether to group results by deduction type |
| AgentType | string | no | The agent type. Valid values: `CREDIT_PACKAGE`, `JVS_CLAW`, `OPEN_CLAW`, and `JVS_COPILOT` |
| DeductionTypes | string | no | The deduction types. Do not specify this parameter for non-knowledge base scenarios (JSON-encoded) |
| WyId | string | no | The WyId |
| GroupResourceTypes | string | no | The GroupResourceTypes (JSON-encoded) |
| GroupByFields | string | no | The GroupByFields (JSON-encoded) |
| AgentTypes | string | no | The AgentTypes (JSON-encoded) |

### Modifies the attributes of an instance
`POST https://apizie.tech/v1/cloud:aliyun-wss/modify-instance-properties` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |
| ResourceType | string | yes | The resource type. This parameter is case-sensitive. Ensure correct spelling |
| InstanceId | string | no | The ID of the instance |
| Key | string | no | The key of the attribute |
| Value | string | no | The value of the attribute. PackageUsedUpStrategy: [enum] Postpaid (switches to the pay-as-you-go billing method) Shutdown (hibernates or… |
| InstanceIds | string | no | The instance IDs (JSON-encoded) |
| Properties | string | no | The list of instance attributes to modify. You can modify multiple key-value pairs at a time. These pairs are merged with the original Key… |

### Sets the credit usage quota for a specified Agent
`POST https://apizie.tech/v1/cloud:aliyun-wss/set-agent-credit-quota` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |
| BizType | string | no | The business type |
| AgentType | string | no | The Agent type |
| AgentIds | string | no | The list of Agent IDs (JSON-encoded) |
| CreditQuota | integer | no | The credit quota |
| SceneType | string | no | The operator scenarios type. Valid values: If this parameter is not specified or is set to NaturalMonthlyOwn: calendar month exclusive.… |

### version
`POST https://apizie.tech/v1/cloud:aliyun-wss/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://wss.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-wss/create-multi-order" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Wuying Sale Service API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-wss/create-multi-order with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Wuying Sale Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Wuying Sale Service itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Wuying Sale Service API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-wss.

### What is the status of the Alibaba Cloud Wuying Sale Service API?
Needs your own provider key (bring your own key)