REST API belgeleri
SMS ve MMS REST API’leri
Onaylı uygulama mesajlarını gönderin; kabul, iletim olayları, bölümleme ve ücretleri yönetin.
API’yi ve kimlik bilgisini birlikte seçin
Onaylı Geliştirici ve Otomasyon, İşletme ve İletişim Sağlayıcısı hesapları etkinleştirilmiş hizmetleri entegre edebilir. Bireysel bir geliştiricinin şirket gibi davranması gerekmez. Uygulama SMS/MMS’i için geçerli gönderim onayı ve kayıt gerekir. Bireyler ve aileler hizmetinde müşterinin erişebileceği, mesaj gönderimini başlatan bir API yoktur.
| API ailesi | Temel URL | Kimlik doğrulama ve sonuç |
|---|---|---|
| İletişim v3 | https://api.multitel.net/v3 | Onaylı Basic kimlik bilgileri; uygun şekilde sağlanmış belirteçler yalnızca bunları destekleyen işlemlerde. JSON status ve response. |
| Acil durum kaydı | https://api.multi.tel/emergency | Onaylı Basic kimlik bilgileri veya özel olarak sağlanmış bearer erişimi. JSON code, message ve data. |
| Portal REST entegrasyonları | Hesabınızın geliştirici başvuru kaynağında gösterilen ana bilgisayar ve işlem | Bu işlemin belgelenmiş kimlik bilgisini, kapsamlarını ve şemasını kullanın. Tarayıcı oturumu istekleri ayrı bir erişim yoludur. |
Örnekleri kullanmadan önce MULTITEL_API_USERNAME ve MULTITEL_API_PASSWORD değerlerini sunucunuzun gizli bilgi yapılandırması üzerinden ayarlayın. Bunları asla herkese açık tarayıcı JavaScript’ine, URL’lere veya kaynak denetimine eklemeyin. Özel kimlik bilgileri API Entegrasyonu ayarları bölümünde yönetilir.
Bir SMS isteği hazırlayın
Hesabın sahip olduğu, onaylı ve SMS etkin bir gönderici numarası, mesajı almayı kabul etmiş bir alıcı ve gerekli Brand/Campaign veya ücretsiz arama numarası doğrulaması kullanın. Aşağıdaki örnek, çalışan kimlik bilgileri ve numaralarla doldurulduğunda gerçek bir mesaj gönderir; bir sandbox değildir.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
--request POST \
--header "Content-Type: application/json" \
--data '{"from":"YOUR_APPROVED_NUMBER","to":"YOUR_CONSENTED_RECIPIENT","text":"Your requested update is ready."}' \
"https://api.multitel.net/v3/sendsms"Gönderici ve alıcı yer tutucularını ülke kodunu içeren uluslararası rakamlarla değiştirin. MMS için, media alanında desteklenen ve herkese açık olarak erişilebilen medya URL’sini sağlayın; önce MMS uygunluğunu ve fiyatlandırmasını doğrulayın.
Kabul edilmek, teslim edilmek demek değildir
Hem dış uygulama durumunu hem de döndürülen mesajlaşma sonucunu inceleyin. Hizmetin sağladığı mesaj tanımlayıcısını kaydedin, teslim durumunu ve webhook olaylarını takip edin. Başarılı bir gönderim, mesajın alıcının cihazına ulaştığını kanıtlamaz.
SMS faturalandırması segment başınadır. Kodlama ve mesaj uzunluğu birden fazla segment oluşturabilir; medya ve operatörle ilgili ücretler SMS’ten farklı olabilir. Göndermeden önce hesabınızın güncel satış fiyatını okuyun. Zaman aşımına uğrayan bir gönderimi körü körüne yeniden denemeyin: önce kayıtlı sonucunu inceleyin.
Hataları ve yeniden denemeleri yönetme
- Kimlik doğrulama veya yetki hatası
- API kimlik bilgisinin etkin olup olmadığını, izin verilen hizmeti ve kaynak IP kısıtlamasını kontrol edin. Portal oturum çerezi bir entegrasyon kimlik bilgisi değildir.
- Yetersiz kredi veya eksik onay
- İşlemi tekrarlamadan önce hesap bakiyesi, gönderim onayı veya belge gereksinimini çözün.
- Sonuç yok
- Boş envanteri veya bulunamayan arayan adını olağan bir sonuç olarak ele alın. Sözdizimi geçerli bir numaranın her hizmete sahip olduğunu varsaymayın.
- Ağ zaman aşımı veya hizmet hatası
- Okuma işlemlerinde geri çekilmeli (backoff) ve sınırlı sayıda yeniden deneme kullanın. Satın alma, gönderim veya kayıt işlemlerinde önce işlemin durumunu inceleyin; kabul edilmiş bir isteği yeniden denemek faturalandırılabilir bir işlemin tekrarlanmasına yol açabilir.
Idempotency desteği her API ailesine özgüdür. Acil durum API’si yeniden deneme anahtarlarını destekler; bu, v3 isteklerinin keyfi olarak idempotent olduğu anlamına gelmez. Destek için zaman damgalarını, döndürülen kimlikleri ve bilgileri çıkarılmış yanıtları saklayın.
Hesabınızın referansıyla devam edin
Oturum açılmış referans, işlemleri izinlerinize ve etkinleştirilmiş hizmetlerinize göre filtreler. Onun belirttiği ana makine adını, kimlik bilgisi türünü, istek alanlarını ve yanıt şemasını aynen kullanın. Konsollar, satın alma ve mesaj gönderme dahil canlı işlemleri çalıştırabilir.