Short Message Service:Call the SMS API

Başlamadan Önce

Aşağıdaki hazırlıkları tamamlayın:

1. Hesap oluşturun ve kurumsal kimlik doğrulamasını tamamlayın: SMS hizmeti kurumsal bir hesap gerektirir. Kurumsal kimlik doğrulamasını tamamlayın.

Bir satıcı son kullanıcısıysanız (End User), SMS'i etkinleştirdiğinizde sistem zincirdeki tüm üst düzey satıcı hesapları için kurumsal kimlik doğrulamasını da kontrol eder. Satıcı zincirindeki tüm hesap seviyelerinin kurumsal kimlik doğrulamasını tamamladığından emin olun. Aksi takdirde SMS etkinleştirme işlemi başarısız olur.

2. SMS'i etkinleştirin: SMS konsoluna giriş yapın ve hizmeti etkinleştirin.

3. Kaynak paketi satın alın: SMS varsayılan olarak ön ödemeli kaynak paketlerini kullanır. Kullanımdan önce bir kaynak paketi satın alın.

   • Alibaba Cloud hesabınıza bir kredi kartı veya PayPal hesabı ekleyin.

   • Hedeflerinize ve paket teknik özelliklerine göre bir paket seçin. Kullandıkça öde faturalandırmasını kullanmak için satış ekibiyle iletişime geçin ve bu özelliği etkinleştirin.

4. Geliştirme ortamını yapılandırın: Bu süreç, bir RAM Kullanıcısı oluşturmayı, izinler atamayı ve bir AccessKey çifti elde etmeyi içerir. Ayrıntılar için Kimlik bilgilerini yapılandırma konusuna bakın.

5. Uyumluluk gereksinimleri hedef bölgeye göre değişiklik gösterir. Gerekli prosedürleri tamamlayın:

   • Çin anakarasına (Go China) mesaj göndermek için bir SMS imzası ve mesaj şablonu oluşturun. Bunlar kullanılmadan önce onaylanmalıdır.

   • Çin anakarası dışındaki bölgelere (Go Globe) mesaj göndermek için hedef ülke veya bölgenin gönderen kimliği kaydı gerektirip gerektirmediğini kontrol edin.

OpenAPI Explorer'ı Kullanın

OpenAPI Explorer API çağrılarının hata ayıklaması için gerçek zamanlı yanıt önizlemeleri, parametre doğrulama ve çok dilli örnek kod oluşturma özelliklerine sahip etkileşimli bir arayüz sağlar.

Herhangi bir API referans sayfasındaki Test düğmesine tıklayarak OpenAPI Explorer'ı açın.

SMS SDK'sını Entegre Edin

SMS API'sini çağırmak için resmi SDK'yı kullanın. Bu örnekte Java SDK ile SendMessageToGlobe çağrısı yapılır. Diğer diller için SDK referansına bakın.

1. Java ortamını doğrulayın: Java 8 veya üzeri bir sürüm gereklidir. Talimatlar için Windows'ta Java geliştirme ortamı kurma konusuna bakın.

2. SDK'yı yükleyin: Projenize bir Maven bağımlılığı ekleyin.

   Aşağıdaki kodu <dependencies> etiketi içindeki pom.xml dosyanıza ekleyin. the-latest-version değerini en son sürüm numarası ile değiştirin ve ardından Maven bağımlılıklarını yeniden yükleyin.

   <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. Örnek kodu görüntüleyin: Java SDK kullanarak SendMessageToGlobe işlevini çağırın. Parametreleri yorumlarda belirtildiği şekilde doldurun.

   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. Ayrıca örnek kodu indirebilir ve doğrudan çalıştırabilirsiniz.

   1. Parameters sekmesinde gerekli parametre değerlerini girin.

   2. Sağ taraftaki SDK Sample Code sekmesinde SDK sürümü olarak V2.0 ve dil olarak Java seçin, ardından örnek kod paketini indirmek için Download Project öğesine tıklayın.

   3. Paketi zip dosyasından çıkardıktan sonra projeyi IDE'nizde açın. Bağımlılıklar yüklendikten sonra src/main/java/com/aliyun/sample/Sample.java dosyasını açın.

5. Yanıtı inceleyin: Başarılı bir çağrı aşağıdakine benzer bir çıktı döndürür:

   {
     "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"
     }
   }

Teslimat makbuzları

Simple Message Queue (eski adıyla MNS) tüketicisi veya toplu HTTP gönderimleri için bir Webhook uç noktası kurarak teslimat raporlarını ve kullanıcı yanıtlarını alın. Bu yöntem teslimat izleme ve iki yönlü iletişim sağlar.

Daha fazla bilgi için Teslimat makbuzlarını yapılandırma konusuna bakın.

İlgili Konular

• API'ye genel bakış: API işlemlerini, parametreleri ve sınırları kapsar.

• Uluslararası hata kodları: API çağrıları veya teslimat makbuzları tarafından döndürülen hata kodlarını ve çözümlerini listeler.

• İlk API çağrınızı yapın: Ortam kurulumunu, çağrı sürecini ve örnek kodu kapsar.

Video Eğitimi

SMS'in nasıl etkinleştirileceği.