Intégrez Short Message Service à vos systèmes métier en appelant directement l'API HTTP ou en utilisant un SDK officiel pour envoyer des codes de vérification, des notifications et des messages marketing par programmation. Cette rubrique présente les concepts fondamentaux de l'intégration et vous aide à choisir la méthode la plus adaptée.
Remarques sur l'utilisation
Short Message Service met à disposition des opérations OpenAPI pour l'envoi de messages et la consultation des enregistrements. Avant de procéder à l'intégration, consultez la version de l'API, les endpoints et les identités d'appelant prises en charge pour Short Message Service.
La rubrique Qu'est-ce qu'OpenAPI ? détaille le flux d'appel complet, ainsi que les identités, l'autorisation et les informations d'identification.
Guide des versions
Alibaba Cloud OpenAPI utilise des numéros de version pour gérer les listes d'API. La version de l'API Short Message Service est 2018-05-01. La chaîne 2018-05-01 est un identifiant de version, et non une date : les API sont les plus récentes disponibles, il ne s'agit pas d'un ensemble obsolète datant du 2018-05-01.
|
Numéro de version de l'API |
Description |
|
Recommandée |
Endpoints
Un endpoint est le nom de domaine utilisé pour accéder à l'API d'un service cloud. Choisissez l'endpoint le plus proche de vos ressources afin de minimiser la latence.
Vous pouvez utiliser l'endpoint de Singapour dysmsapi.ap-southeast-1.aliyuncs.com.
La liste complète des endpoints disponibles figure dans la rubrique Endpoints.
Identités prises en charge
Le portail OpenAPI utilise par défaut votre compte Alibaba Cloud pour le débogage des API. Étant donné que ce compte dispose d'un accès complet aux API, ce qui représente une menace importante pour la sécurité, il est recommandé d'utiliser plutôt un utilisateur Resource Access Management (RAM) pour les appels d'API et les opérations quotidiennes de maintenance et d'exploitation. Accordez uniquement les permissions requises à chaque utilisateur RAM avant d'effectuer des appels d'API.
|
Identité de l'utilisateur |
Prise en charge |
|
Prise en charge |
|
|
Utilisateur RAM (Recommandé) |
Prise en charge |
|
Rôle RAM (Recommandé) |
Prise en charge |
Méthodes d'intégration
Les SDK constituent la méthode recommandée pour appeler les opérations OpenAPI. Privilégiez l'utilisation d'un SDK chaque fois que possible.
|
Méthode d'intégration |
Description |
|
SDK Alibaba Cloud (Recommandé) |
|
|
Appels d'API personnalisés (non recommandé) |
Les appels HTTP natifs nécessitent que vous implémentiez l'algorithme de signature et construisiez les requêtes manuellement. Le mécanisme de signature est documenté dans la rubrique Mécanisme de signature et corps de requête V3. |
Références
Si un appel d'API renvoie une erreur, vérifiez les paramètres de la requête en vous référant aux Codes d'erreur de l'API.
Enregistrez l'ID de requête (RequestID) figurant dans la réponse ou le message d'erreur du SDK, puis utilisez la Plateforme de diagnostic OpenAPI d'Alibaba Cloud pour diagnostiquer le problème.
Identités, informations d'identification et autorisation traite des types d'identité de l'appelant, des informations d'identification et de l'autorisation.
Alibaba Cloud applique une limitation du débit (throttling) sur la fréquence des appels OpenAPI . Les limites de débit et les quotas sont documentés dans la rubrique Gestion de la limitation du débit et des quotas.