Integrate Short Message Service into your business systems by calling the HTTP API directly or using an official SDK to send verification codes, notifications, and marketing messages programmatically. This topic covers core integration concepts and helps you choose the right approach.
Usage notes
Short Message Service provides OpenAPI operations for sending messages and querying records. Before you integrate, review the API version, endpoints, and supported caller identities for Short Message Service.
What is OpenAPI? covers the complete call flow, identities, authorization, and credentials.
Version guide
Alibaba Cloud OpenAPI uses version numbers to manage API lists. Short Message Service uses the 2017-05-25 API version. The string 2017-05-25 is a version identifier, not a date — the APIs are the latest available, not an outdated set from 2017-05-25.
|
API version number |
Description |
|
Recommended |
Endpoints
An endpoint is the domain name used to access a cloud service API. Choose the endpoint closest to your resources to minimize latency.
You can use the global endpoint dysmsapi.aliyuncs.com.
All available endpoints are listed in Endpoints.
Supported identities
The OpenAPI portal defaults to your Alibaba Cloud account for API debugging. Because this account has full API access, which poses a high security threat, use a Resource Access Management (RAM) user instead for API calls and daily O&M. Grant only the required permissions to each RAM user before calling API operations. Configure RAM user permissions as described in Use RAM for access control.
|
User identity |
Supported |
|
Support |
|
|
RAM user (Recommended) |
Support |
|
RAM role (Recommended) |
Support |
Integration methods
SDKs are the recommended way to call OpenAPI operations. Use an SDK whenever possible.
|
Integration method |
Description |
|
Alibaba Cloud SDK (Recommended) |
|
|
Custom API calls (Not recommended) |
Native HTTP calls require you to implement the signature algorithm and build requests manually. The signature mechanism is documented in V3 request body and signature mechanism. |
References
-
If an API call returns an error, check the request parameters against API error codes.
-
Record the RequestID from the response or the SDK error message, then use the Alibaba Cloud OpenAPI Diagnostic Platform to diagnose the issue.
-
Identities, credentials, and authorization covers caller identity types, credentials, and authorization.
-
Alibaba Cloud throttles OpenAPI call frequency. Rate limits and quotas are documented in Throttling and quota management.
FAQ
Common questions about API and SDK usage are answered in API and SDK FAQ.