Ana içeriğe geç

Gelen SMS'leri listeleme

GET 

/inbox

İstek: GET https://ext-sandbox.netgsm.com.tr/sms/v3/inbox
Sandbox: https://ext-sandbox.netgsm.com.tr/sms/v3

Kimliği doğrulanmış hesabın gelen kutusu, isteğe bağlı olarak bir aralıkla sınırlanır. Boş gelen kutusu count 0 ile 200 döner. Saat dilimi farkındaki + işaretini URL'de %2B olarak kodlamalısınız.

startAt ve stopAt değerlerini birlikte göndermeli ya da ikisini de göndermemelisiniz. Hiçbiri gönderilmezse içinde bulunulan ayın bugüne kadarki kısmı, yani ayın 1'i 00:00'dan (Europe/Istanbul) şimdiye kadar kullanılır. Aralık 2 ayı aşamaz.

Request​

Query Parameters

    startAt date-time

    Yalnızca stopAt ile birlikte.

    Example: 2026-08-31T00:00:00+03:00
    stopAt date-time

    Yalnızca startAt ile birlikte. Ondan önce ya da ondan 2 aydan fazla sonra olamaz.

    Example: 2026-08-31T23:59:59+03:00

Responses​

Aralıktaki mesajlar; hiç olmayabilir.

Schema
    countintegerrequired
    messages object[]required
  • Array [
  • idstringnullablerequired
    jobIdstringnullablerequired

    Mesajın ait olduğu görev, atanmışsa; aksi halde null.

    senderstringnullablerequired

    Mesajın geldiği numara; yurt içi numaralar 90 öneki olmadan yazılır.

    textstringnullablerequired
    operatorstringnullablerequired

    Mesajın geldiği operatörün adı (örn. NETGSM MOBIL). Bir ad, kod değil.

    receivedAtdate-timenullablerequired

    Mesajın alındığı zaman, saat dilimi farkı içeren ISO-8601. Zaman bilgisi yoksa null.

  • ]
  • truncatedbooleanrequired

    500 mesaj sınırına ulaşıldığında ve aralıkta daha fazlası olabileceğinde true; geri kalanı için daha dar bir aralık sorgulamalısınız. count 500'ün altındayken de true olabilir.

Örnek istek​

curl -X GET 'https://ext-sandbox.netgsm.com.tr/sms/v3/inbox?startAt=2026-08-31T00%3A00%3A00%2B03%3A00&stopAt=2026-08-31T23%3A59%3A59%2B03%3A00' \
-H 'Authorization: Bearer <token>'