# Alibaba Cloud Ticket API

> Alibaba Cloud Ticket API on Apizie: 13 endpoints (Closes a ticket, Creates a ticket, Evaluates a ticket, Queries the Object Storage Service (OSS) URL that is used to upload attachments, …) 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://zieapi.vercel.app/v1/cloud:aliyun-workorder/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-workorder`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/workorder
- Page: https://zieapi.vercel.app/api/cloud/aliyun-workorder
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-workorder/openapi.json

Alibaba Cloud OpenAPI for Ticket (workorder, version 2021-06-10). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Closes a ticket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/close-ticket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| TicketId | string | yes | The ticket ID |
| Uid | string | no | The user UID. You can find your UID by clicking the profile picture in the upper-right corner of the DMS console |

### Creates a ticket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/create-ticket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| Description | string | yes | The description of the issue in the ticket. Only plain text is supported |
| Severity | integer | yes | An enumeration value. A value of 1 indicates a normal issue. A value of 2 indicates an urgent issue |
| CategoryId | string | yes | The ID of the issue category. Obtain this ID from the ListCategories operation |
| Title | string | no | The title of the ticket |
| CreatorId | string | no | The Alibaba Cloud UID of the account that submits the ticket. This parameter is required for Marketplace reseller scenarios |
| Email | string | no | The contact email address for the ticket |
| FileNameList | string | no | A list of attachment names. Use the ObjectKey value returned by the GetAttachmentUploadUrl operation (JSON-encoded) |
| SecretInfo | string | no | Sensitive information (JSON-encoded) |

### Evaluates a ticket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/evaluate-ticket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| TicketId | string | yes | The ticket ID |
| Solved | string | yes | Indicates whether the issue was resolved |
| Score | string | yes | The rating, from 1 to 5 stars |
| Content | string | no | The content of the evaluation |
| Uid | string | no | The UID |

### Queries the Object Storage Service (OSS) URL that is used to upload attachments
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/get-attachment-upload-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| FileName | string | yes | Name of the uploaded file |

### Retrieves the tag for a ticket's RocketMQ message listener
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/get-mq-consumer-tag` (byok)

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

### Queries a ticket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/get-ticket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| TicketId | string | yes | The ticket ID |
| Uid | string | no | UID |

### Obtains the list data of ticket problem categories
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/list-categories` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| ProductId | integer | yes | The ID of the product. You can call the ListProducts operation to obtain the product ID. The ProductId parameter is the ID of an Alibaba… |
| Name | string | no | The name of the classification question. Fuzzy search is supported |
| Language | string | no | Multi-language, support, Chinese, English. Value definition: zh: Chinese, en: English |

### Obtains the data of the Alibaba Cloud product list
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/list-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| Name | string | no | The name of the product. Fuzzy search is supported. This parameter is optional |
| Language | string | no | The language that you use, supporting English, Chinese, and Japanese. Valid values: en, zh, and jp, which indicate English, Chinese, and… |

### Retrieves the communication records for a ticket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/list-ticket-notes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| TicketId | string | yes | The ticket ID |
| Uid | string | no | The UID |

### Retrieves a list of your tickets
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/list-tickets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| StartDate | integer | no | The start time when the ticket was created. Use this parameter with EndDate to query tickets created within a specific time range |
| EndDate | integer | no | The end time when the ticket was created. Use this parameter with StartDate to query tickets created within a specific time range |
| PageNumber | integer | yes | The page number for a paged query |
| PageSize | integer | yes | The number of entries to return on each page |
| TicketId | string | no | The ticket ID |
| Keyword | string | no | The keyword for a fuzzy search. The keyword is used to match the content of the Description field of the ticket |
| StatusList | string | no | A list of ticket statuses (JSON-encoded) |
| TicketIdList | string | no | A list of ticket IDs (JSON-encoded) |
| Uid | string | no | The UID |

### Reopens a ticket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/reopen-ticket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| TicketId | string | yes | The ticket ID |
| Content | string | yes | The content of the reply to reopen the ticket |
| Uid | string | no | The UID |

### Replies to a ticket. You can call the ListTicketNotes operation to retrieve the reply
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/reply-ticket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://workorder.ap-southeast-1.aliyuncs.com |
| TicketId | string | yes | The ticket ID |
| Content | string | yes | The content of the reply to the ticket |
| FileNameList | string | no | A list of attachment names. This is the ObjectKey field returned by the GetAttachmentUploadUrl operation (JSON-encoded) |
| Encrypt | string | yes | Specifies whether to encrypt the content |
| Uid | string | no | The Alibaba Cloud account ID (UID) |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/version` (byok)

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

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-workorder/close-ticket" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Ticket API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-workorder/close-ticket with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

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

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