# Alibaba Cloud Simple Message Queue (formerly MNS) API

> Alibaba Cloud Simple Message Queue (formerly MNS) API on Apizie: 8 endpoints (Deletes up to 16 messages from a queue in a single batch, Batch peeks at messages in a queue without changing the message status, Receives up to 16 messages in a batch from a specified queue for consumption, Sends up to 16 messages in a batch to a specified queue, with a total size not exceeding 64 KB, …) 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-smqproxy/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for Simple Message Queue (formerly MNS) (smqproxy, version 2026-04-09). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Deletes up to 16 messages from a queue in a single batch
`POST https://apizie.tech/v1/cloud:aliyun-smqproxy/batch-delete-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| queueName | string | yes | The name of the queue |
| ReceiptHandles | array | no | The receipt handles of multiple messages |

### Batch peeks at messages in a queue without changing the message status
`GET https://apizie.tech/v1/cloud:aliyun-smqproxy/batch-peek-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| queueName | string | yes | The queue name |
| peekonly | string | no | Indicates that this request only peeks at messages at the top of the queue without changing the message status. Fixed value: true |
| numOfMessages | integer | no | The maximum number of messages to peek at in this BatchPeekMessage request |

### Receives up to 16 messages in a batch from a specified queue for consumption
`GET https://apizie.tech/v1/cloud:aliyun-smqproxy/batch-receive-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| queueName | string | yes | The name of the queue |
| numOfMessages | integer | no | The maximum number of messages to receive in this request |
| waitseconds | integer | no | The maximum polling wait time for this request, in seconds. A value of 0 indicates that the request returns immediately |

### Sends up to 16 messages in a batch to a specified queue, with a total size not exceeding 64 KB
`POST https://apizie.tech/v1/cloud:aliyun-smqproxy/batch-send-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| queueName | string | yes | The name of the queue |
| Messages | array | no | The list of messages |

### Extends or shortens the invisibility period of a message in the Inactive state
`POST https://apizie.tech/v1/cloud:aliyun-smqproxy/change-message-visibility` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| queueName | string | yes | The name of the queue |
| receiptHandle | string | no | The temporary handle of the message returned after the last consumption |
| visibilityTimeout | integer | no | The countdown from the current time until the message becomes Active again. Valid values: 1 to 43200. Unit: seconds, which ranges from 1… |

### Publishes a message to a specified topic. The message is pushed to all subscribed endpoints
`POST https://apizie.tech/v1/cloud:aliyun-smqproxy/publish-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| topicName | string | yes | The topic name |
| MessageAttributes | object | no | The message attributes. This parameter is not required when pushing messages to queue or HTTP endpoints |
| MessageBody | string | no | The message content. Base64-encode the content in advance. Maximum size: 64 KB |
| MessageGroupId | string | no | The MessageGroupId |
| MessageTag | string | no | The message tag, which is used for message filtering in subscriptions. Maximum length: 64 characters |

### Sends a message to a specified queue with configurable delay and priority
`POST https://apizie.tech/v1/cloud:aliyun-smqproxy/send-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| queueName | string | yes | The queue name |
| DelaySeconds | integer | no | The delay period before the message can be consumed after it is sent, in seconds. The maximum value is 7 days |
| MessageBody | string | no | The message body. Base64-encode the message body in advance to avoid issues with special characters |
| MessageGroupId | string | no | The message group ID. This ensures ordered delivery of messages within the same group. Valid only for FIFO queues |
| Priority | integer | no | The message priority. A smaller value indicates a higher priority, where 1 is the highest priority |
| UserProperties | object | no | The user-defined properties |

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

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-smqproxy/batch-delete-message" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Simple Message Queue (formerly MNS) API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-smqproxy/batch-delete-message with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Alibaba Cloud Simple Message Queue (formerly MNS) 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-smqproxy.

### What is the status of the Alibaba Cloud Simple Message Queue (formerly MNS) API?
Needs your own provider key (bring your own key)