Short Message Service:Appeler l'API SMS

Avant de commencer

Préparez les éléments suivants :

1. Créez un compte et effectuez la vérification d'identité entreprise : le service SMS nécessite un compte entreprise. Effectuez la vérification d'identité entreprise.

Si vous êtes un utilisateur final revendeur (End User), le système valide également la vérification d'identité entreprise pour tous les comptes revendeurs en amont dans la chaîne lors de l'activation du service SMS. Assurez-vous que tous les niveaux de comptes dans la chaîne de revente ont effectué la vérification d'identité entreprise. Sinon, l'activation du service SMS échouera.

Si vous êtes un utilisateur final revendeur (End User), le système valide également la vérification d'identité entreprise pour tous les comptes revendeurs en amont dans la chaîne lors de l'activation du service SMS. Assurez-vous que tous les niveaux de comptes dans la chaîne de revente ont effectué la vérification d'identité entreprise. Sinon, l'activation du service SMS échouera.

2. Activez le service SMS : connectez-vous à la console SMS et activez le service.

3. Achetez un pack de ressources : le service SMS utilise par défaut des packs de ressources prépayés. Achetez un pack de ressources avant utilisation.

   • Ajoutez une carte de crédit ou un compte PayPal à votre compte Alibaba Cloud.

   • Choisissez un pack en fonction de vos destinations et des spécifications des packs. Pour utiliser la facturation au paiement à l'utilisation, contactez le service commercial afin de l'activer.

4. Configurez l'environnement de développement : cette étape implique la création d'un utilisateur RAM, l'octroi d'autorisations et l'obtention d'une paire AccessKey. Pour plus de détails, consultez la rubrique Configurer les identifiants.

5. Les exigences de conformité varient selon la destination. Effectuez les procédures requises :

   • Pour envoyer des messages vers la Chine continentale (Go China), créez une signature SMS et un modèle de message. Ils doivent être approuvés avant utilisation.

   • Pour envoyer des messages vers des régions hors de Chine continentale (Go Globe), vérifiez si le pays ou la région de destination exige l'enregistrement de l'ID d'expéditeur.

Utiliser OpenAPI Explorer

OpenAPI Explorer fournit une interface interactive pour déboguer les appels API avec des aperçus de réponses en temps réel, la validation des paramètres et la génération d'exemples de code dans plusieurs langages.

Cliquez sur le bouton Test sur n'importe quelle page de référence API pour ouvrir OpenAPI Explorer.

Intégrer le SDK SMS

Utilisez le SDK officiel pour appeler l'API SMS. Cet exemple appelle SendMessageToGlobe avec le SDK Java. Pour les autres langages, consultez la référence du SDK.

1. Vérifiez l'environnement Java : Java 8 ou version ultérieure est requis. Pour obtenir des instructions, consultez la rubrique Configurer un environnement de développement Java sous Windows.

2. Installez le SDK : ajoutez une dépendance Maven à votre projet.

   Ajoutez ce qui suit à votre fichier pom.xml dans la balise <dependencies>. Remplacez the-latest-version par le numéro de version le plus récent, puis rechargez les dépendances Maven.

   <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>dysmsapi20180501</artifactId>
       <!-- Replace 'the-latest-version' with the latest version number: https://mvnrepository.com/artifact/com.aliyun/dysmsapi20180501 -->
       <version>the-latest-version</version>
   </dependency>

3. Consultez l'exemple de code : appelez SendMessageToGlobe à l'aide du SDK Java. Renseignez les paramètres comme indiqué dans les commentaires.

   package com.aliyun.sample;
   
   import com.aliyun.teaopenapi.models.Config;
   import com.aliyun.dysmsapi20180501.Client;
   import com.aliyun.dysmsapi20180501.models.SendMessageToGlobeRequest;
   import com.aliyun.dysmsapi20180501.models.SendMessageToGlobeResponse;
   import static com.aliyun.teautil.Common.toJSONString;
   
   public class Sample {
       public static Client createClient() throws Exception {
           Config config = new Config()
                   // Configure the AccessKey ID. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
                   .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                   // Configure the AccessKey secret. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
                   .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
   
           // Configure the endpoint.
           config.endpoint = "dysmsapi.ap-southeast-1.aliyuncs.com";
   
           return new Client(config);
       }
   
       public static void main(String[] args) throws Exception {
           // Initialize the request client.
           Client client = Sample.createClient();
   
           // Construct the request object. Fill in the parameter values.
           SendMessageToGlobeRequest sendSmsRequest = new SendMessageToGlobeRequest()
                   .setTo("<YOUR_VALUE>")
                   .setMessage("<YOUR_VALUE>");
   
           // Get the response object.
           SendMessageToGlobeResponse sendSmsResponse = client.sendMessageToGlobe(sendSmsRequest);
   
           // The response contains the body and headers from the server.
           System.out.println(toJSONString(sendSmsResponse));
       }
   }

4. Vous pouvez également télécharger l'exemple de code et l'exécuter directement.

   1. Dans l'onglet ParametersParameters, saisissez les valeurs de paramètre requises.

   2. Dans l'onglet SDK Sample CodeSDK Sample Code à droite, sélectionnez V2.0 pour la version du SDK et JavaJava pour le langage, puis cliquez sur Download ProjectDownload Project pour télécharger le package d'exemple de code.

   3. Après avoir décompressé le package, ouvrez le projet dans votre IDE. Une fois les dépendances chargées, ouvrez le fichier src/main/java/com/aliyun/sample/Sample.java.

5. Examinez la réponse : un appel réussi renvoie une sortie similaire à la suivante :

   {
     "headers": {
       "date": "Tue, 24 Oct 2023 07:47:17 GMT",
       "content-type": "application/json;charset=utf-8",
       "content-length": "263",
       "connection": "keep-alive",
       "keep-alive": "timeout=25",
       "access-control-allow-origin": "*",
       "access-control-expose-headers": "*",
       "x-acs-request-id": "97B1D7B6-F2F6-3A50-97BC-A90B43EC962F",
       "x-acs-trace-id": "29c11fe4c778b74774d5f5602f0e7975",
       "etag": "2a+mcDRTDkXqx9VF7b6U57Q3"
     },
     "statusCode": 200,
     "body": {
       "ResponseCode": "OK",
       "NumberDetail": {
       "Region": "Taiwan",
       "Country": "Taiwan, Province of China",
       "Carrier": "FarEasTone"
     },
       "RequestId": "97B1D7B6-F2F6-3A50-97BC-A90B43EC962F",
       "Segments": "1",
       "ResponseDescription": "OK",
       "To": "88691567****",
       "MessageId": "191921698133637273"
     }
   }

Accusés de réception

Recevez des rapports de livraison et des réponses des utilisateurs en configurant un consommateur Simple Message Queue (anciennement MNS) ou un point de terminaison webhook pour des pushes HTTP par lots. Cela permet la surveillance de la livraison et la communication bidirectionnelle.

Pour plus d'informations, consultez la rubrique Configurer les accusés de réception.

Références

• Aperçu des API : couvre les opérations API, les paramètres et les limites.

• Codes d'erreur internationaux : répertorie les codes d'erreur renvoyés par les appels API ou les accusés de réception, avec des solutions.

• Effectuer votre premier appel API : couvre la configuration de l'environnement, le processus d'appel et des exemples de code.

Tutoriel vidéo

Comment activer le service SMS.