Teslimat raporlarını HTTP sunucusundan almak için bir geri arama URL'si belirtebilirsiniz. Bir geri arama URL'si ayarlayarak SMS mesajlarınızın durumu hakkında zamanında ve doğru bilgilere erişebilirsiniz.
Teslimat raporlarının idempotent olması garanti edilmez. Verilerin doğruluğunu ve tutarlılığını sağlamak için gerekli önlemleri alın.
Protokol
|
|
|
|
|
|
|
|
|
İstek parametreleri
POST isteğinin verileri JSON Array formatındadır. Tek seferde HTTP sunucusuna birden fazla teslimat raporu gönderilebilir.
Parametre | Tür | Örnek | Açıklama |
To | String | 8521234**** | Teslimat raporlarını alan cep telefonu numarası. |
Status | String | 1 | Mesajın durumu.
|
MessageId | String | 123456789**** | Teslimat raporunun ID'si. |
SmsSize | String | 1 | Mesaj sayısı. Uzun bir mesaj birden fazla parçaya bölünür. |
TaskId | String | 123456 | Görevin ID'si. |
SendDate | String | Thu, 25 Nov 2021 10:27:00 +0800 | Mesajın operatöre gönderildiği zaman. |
ReceiveDate | String | Thu, 25 Nov 2021 10:27:33 +0800 | Teslimat raporunun operatörden alındığı zaman. |
ErrorCode | String | success | Hata kodu. |
ErrorDescription | String | success | Hata mesajı. |
Örnek
[{
"To" : "8521111****",
"SendDate" : "Thu, 25 Nov 2021 10:25:00 +0800",
"ReceiveDate" : "Thu, 25 Nov 2021 10:25:33 +0800",
"Status" : "1",
"ErrorCode" : "success",
"ErrorDescription" : "success",
"TaskId" : "67890",
"SmsSize":"2",
"MessageId" : "123450000****"
}]Yanıt parametreleri
Bir teslimat raporu HTTP sunucunuza gönderildiğinde sistem 200 döndürür. Aksi takdirde sistem teslimat raporunu yeniden göndermeyi dener.
-
Örnek yanıt
{ "code" : 0, "msg" : "The message is received." } -
Yanıt parametreleri
Parametre
Tür
Zorunlu
Örnek
Açıklama
code
Number
Evet
0
Yanıt kodu.
msg
String
Hayır
Received
Hata mesajı.
Yeniden denemeler
Sistem bir teslimat raporunu göndermede başarısız olursa raporu başarılı bir şekilde gönderilene kadar 1 dakika veya 5 dakika sonra yeniden dener. Sistem bir teslimat raporunu art arda üç kez göndermede başarısız olursa gönderme işlemini durdurur.