This topic describes the endpoints, protocol, methods, components, and encoding of the Message Service (MNS) API requests.

MNS is deployed in multiple regions. Each region provides an Internet endpoint and an internal endpoint. An Elastic Compute Service (ECS) instance that resides in the classic network or a virtual private cloud (VPC) can access MNS by using the internal endpoint.

Endpoint

Region Internet endpoint Internal endpoint
China (Qingdao) http(s)://{AccountId}.mns.cn-qingdao.aliyuncs.com http://{AccountId}.mns.cn-qingdao-internal.aliyuncs.com
China (Beijing) http(s)://{AccountId}.mns.cn-beijing.aliyuncs.com http://{AccountId}.mns.cn-beijing-internal.aliyuncs.com
China (Hangzhou) http(s)://{AccountId}.mns.cn-hangzhou.aliyuncs.com http://{AccountId}.mns.cn-hangzhou-internal.aliyuncs.com
China (Shanghai) http(s)://{AccountId}.mns.cn-shanghai.aliyuncs.com http://{AccountId}.mns.cn-shanghai-internal.aliyuncs.com
China (Shenzhen) http(s)://{AccountId}.mns.cn-shenzhen.aliyuncs.com http://{AccountId}.mns.cn-shenzhen-internal.aliyuncs.com
Singapore (Singapore) http(s)://{AccountId}.mns.ap-southeast-1.aliyuncs.com http://{AccountId}.mns.ap-southeast-1-internal.aliyuncs.com
US (Silicon Valley) http(s)://{AccountId}.mns.us-west-1.aliyuncs.com http://{AccountId}.mns.us-west-1-internal.aliyuncs.com
Japan (Tokyo) http(s)://{AccountId}.mns.ap-northeast-1.aliyuncs.com http://{AccountId}.mns.ap-northeast-1-internal.aliyuncs.com
Australia (Sydney) http(s)://{AccountId}.mns.ap-southeast-2.aliyuncs.com http://{AccountId}.mns.ap-southeast-2-internal.aliyuncs.com
Germany (Frankfurt) http(s)://{AccountId}.mns.eu-central-1.aliyuncs.com http://{AccountId}.mns.eu-central-1-internal.aliyuncs.com
UAE (Dubai) http(s)://{AccountId}.mns.me-east-1.aliyuncs.com http://{AccountId}.mns.me-east-1-internal.aliyuncs.com
China East 1 Finance N/A http://{AccountId}.mns.cn-hzjbp-a-internal.aliyuncs.com
China East 2 Finance N/A http://{AccountId}.mns.cn-shanghai-finance-internal.aliyuncs.com
China South 1 Finance N/A http://{AccountId}.mns.cn-shenzhen-finance-internal.aliyuncs.com

An account ID is the ID of an Alibaba Cloud account. You can view the account ID on the official website of Alibaba Cloud. To ensure data security, MNS provides HTTPS Internet endpoints. If you want to use HTTPS endpoints, replace http:// with https://.

Protocol

MNS supports the HTTP protocol for data communication.

Methods

MNS supports HTTP methods such as PUT, POST, GET, and DELETE to send requests. For more information about how to call API operations, see List of RESTful API operations by function for queues and List of RESTful API operations by function for topics.

Components

When you use an HTTP request to call an API operation, make sure that the URL parameters, request headers, and request body are valid.

Encoding

Requests and responses are encoded in UTF-8.