Seamlessly integrate SMS functionality into your business systems by leveraging Alibaba Cloud's APIs and official SDK. This allows you to automatically send verification codes, notifications, and promotional messages. By integrating directly, you can enhance operational efficiency while reducing costs. This guide covers the core concepts and recommended integration methods to help you get started.
Before you begin
Short Message Service (SMS) provides various API operations, such as sending messages and querying records. Before integration, review our API versioning, service endpoints, and supported identities.
To learn more about the procedure for calling an API operation and the identities, authorization, and credentials involved, see What is an API?
API versions
Alibaba Cloud OpenAPI uses version numbers to manage the API sets for its various cloud services. For instance, the SMS API is currently on version 2018-05-01. This is a version identifier, not a date. This version contains the latest API data and receives ongoing updates; it does not mean the API has been frozen since May 1, 2018.
API version | Description |
Recommended |
Service endpoints
A service endpoint is the entry point for accessing an Alibaba Cloud service. It is the network domain used to make API requests. For the lowest latency, choose the service endpoint in the same region as your resources.
You can use the Singapore endpoint: dysmsapi.ap-southeast-1.aliyuncs.com
For more information, see Endpoints.
Supported identities
By default, the OpenAPI Explorer uses your Alibaba Cloud account for API debugging. This practice is highly discouraged as your account has full access to all APIs, creating a significant security risk. We recommend using a RAM user for API calls and daily operations. Ensure you grant this user only the specific permissions required for tasks.
User identity | Supported |
Support | |
RAM user (Recommended) | Support |
RAM role (Recommended) | Support |
Integration methods
We recommend using Alibaba Cloud SDK, which is the easiest method to integrate and offers the best support for API calls.
Integration method | Description |
Alibaba Cloud SDK (Recommended) |
|
Raw HTTP requests (Not recommended) | To make raw HTTP requests, you must manually implement the signing algorithm and build custom requests. For more information about the signing mechanism, see Request syntax and signature method V3. |
References
If an error is returned, use the returned error code to verify that the request parameters and their values are valid. For more information, see Error codes.
You can also use the returned RequestID or SDK error message on the OpenAPI Troubleshoot page for diagnosis.
For more information about user identities, credentials, and authorization, see Identity, credential, and authorization.
Alibaba Cloud limits the frequency of calls to OpenAPI . For more information, see Throttling and quota management.