Intégrez Short Message Service à vos systèmes métier en appelant directement l'API HTTP ou en utilisant un SDK officiel pour envoyer par programmation des codes de vérification, des notifications et des messages marketing. 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 propose des opérations OpenAPI pour l'envoi de messages et la consultation des journaux. Avant l'intégration, vérifiez 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écrit 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 dernières disponibles, et non 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. Sélectionnez l'endpoint le plus proche de vos ressources afin de minimiser la latence.
Utilisez 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. Comme ce compte dispose d'un accès complet aux API, ce qui représente un risque de sécurité élevé, utilisez plutôt un utilisateur Resource Access Management (RAM) pour les appels d'API et les opérations quotidiennes d'exploitation et de maintenance. Accordez uniquement les autorisations nécessaires à chaque utilisateur RAM avant d'appeler les opérations 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. Utilisez un SDK chaque fois que possible.
|
Méthode d'intégration |
Description |
|
Alibaba Cloud SDK (Recommandé) |
|
|
Appels d'API personnalisés (Non recommandé) |
Les appels HTTP natifs vous obligent à implémenter l'algorithme de signature et à construire manuellement les requêtes. Le mécanisme de signature est documenté dans la rubrique Corps de requête V3 et mécanisme de signature. |
Références
Si un appel d'API renvoie une erreur, vérifiez les paramètres de la requête en consultant les Codes d'erreur de l'API.
Enregistrez le 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.
La rubrique Identités, informations d'identification et autorisation couvre les types d'identité de l'appelant, les informations d'identification et l'autorisation.
Alibaba Cloud applique une limitation du débit 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.