# Netgsm SMS API

> SMS gönderimi ve gelen SMS okuma için v3 REST API. Canlı ortam: https://ext-api.netgsm.com.tr/sms/v3. Sandbox: https://ext-sandbox.netgsm.com.tr/sms/v3. Token Authorization API'den alınır (/auth).

Sunucu adresleri (base URL):

- Netgsm SMS API — Canlı ortam: `https://ext-api.netgsm.com.tr/sms/v3` (kimlik doğrulama: `Authorization: Bearer <token>`; OpenAPI tanımı: https://api-docs.netgsm.com.tr/openapi/sms-v3.yaml)
- SMS API v3 Sandbox — Sandbox: `https://ext-sandbox.netgsm.com.tr/sms/v3` (kimlik doğrulama: `Authorization: Bearer <token>`; OpenAPI tanımı: https://api-docs.netgsm.com.tr/openapi/sandbox-v3.yaml)
- Netgsm Authorization API — Canlı ortam: `https://ext-api.netgsm.com.tr/auth/v3` (kimlik doğrulama: gerekmez; OpenAPI tanımı: https://api-docs.netgsm.com.tr/openapi/auth-v3.yaml)
- Netgsm Authorization API — Sandbox: `https://ext-sandbox.netgsm.com.tr/auth/v3` (kimlik doğrulama: gerekmez; OpenAPI tanımı: https://api-docs.netgsm.com.tr/openapi/auth-v3.yaml)
- Netgsm İYS API — Canlı ortam: `https://ext-api.netgsm.com.tr/iys/v1` (kimlik doğrulama: `Authorization: Bearer <token>`; OpenAPI tanımı: https://api-docs.netgsm.com.tr/openapi/iys-v1.yaml)

Her sayfanın markdown sürümü vardır: sayfa adresindeki sondaki `/` yerine `.md` (örneğin `/send-sms/` → `/send-sms.md`). API sayfalarının markdown sürümü alanları, kısıtları, curl örneğini ve tüm yanıt kodlarını içerir.

## SMS API (v3.0)

- [Netgsm SMS API](https://api-docs.netgsm.com.tr/netgsm-sms-api.md): Bu API ile SMS gönderebilir, iletim raporlarını takip edebilir ve size gelen SMS'leri okuyabilirsiniz.
- [Giriş](https://api-docs.netgsm.com.tr/introduction.md): API Dokümanı
- [Gönderici adları](https://api-docs.netgsm.com.tr/gonderici-adlari.md): Gönderici adları
- [Gönderim](https://api-docs.netgsm.com.tr/gonderim.md): Gönderim
- [Hesap](https://api-docs.netgsm.com.tr/hesap.md): Hesap
- [Kara liste](https://api-docs.netgsm.com.tr/kara-liste.md): Kara liste
- [Raporlar ve gelen kutusu](https://api-docs.netgsm.com.tr/raporlar-ve-gelen-kutusu.md): Raporlar ve gelen kutusu
- [Template](https://api-docs.netgsm.com.tr/template.md): Template
- [Webhook'lar](https://api-docs.netgsm.com.tr/webhooklar.md): Webhook'lar
- [Bakiye sorgulama](https://api-docs.netgsm.com.tr/get-balance.md): Hesabın kalan paketlerini, kampanyalarını ve kredi bakiyesini döner.
- [Gelen SMS webhook'u kaydetme](https://api-docs.netgsm.com.tr/register-inbox-webhook.md): Hesaba gelen SMS'lerin gönderileceği adres.
- [Gelen SMS webhook'unu silme](https://api-docs.netgsm.com.tr/delete-inbox-webhook.md): Gelen SMS webhook'unu silme
- [Gelen SMS'leri listeleme](https://api-docs.netgsm.com.tr/read-inbox.md): Kimliği doğrulanmış hesabın gelen kutusu, isteğe bağlı olarak bir aralıkla sınırlanır.
- [Gönderici başlıklarını listeleme](https://api-docs.netgsm.com.tr/list-senders.md): Kimliği doğrulanmış hesaba kayıtlı gönderici başlıkları.
- [Gönderim istatistiklerini sorgulama](https://api-docs.netgsm.com.tr/read-stats.md): Kimliği doğrulanmış hesabın bir görevi için, gönderildiği ay üzerinden toplanmış, her farklı sonuç başına bir satır.
- [İletim raporlarını sorgulama](https://api-docs.netgsm.com.tr/read-reports.md): Kimliği doğrulanmış hesabın iletim raporlarından bir sayfa.
- [İletim raporu webhook'u kaydetme](https://api-docs.netgsm.com.tr/register-report-webhook.md): Hesabın iletim raporlarının gönderileceği adres.
- [İletim raporu webhook'unu silme](https://api-docs.netgsm.com.tr/delete-report-webhook.md): İletim raporu webhook'unu silme
- [Kara listeyi öğrenme](https://api-docs.netgsm.com.tr/read-blacklist.md): Hesabın kara listesindeki numaraları döndürür.
- [OTP SMS gönderme](https://api-docs.netgsm.com.tr/send-otp.md): Tek bir alıcıya OTP (tek kullanımlık şifre) SMS'i gönderir.
- [Rehbere SMS gönderme](https://api-docs.netgsm.com.tr/send-to-directory.md): Rehberdeki kişi gruplarına, istekte verilen kişilere ya da her ikisine tek bir metinle gönderimi kuyruğa alır.
- [SMS gönderme](https://api-docs.netgsm.com.tr/send-sms.md): Bir ya da daha fazla alıcıya SMS gönderen bir görev oluşturur.
- [SMS uzunluğunu hesaplama](https://api-docs.netgsm.com.tr/measure-length.md): Bir metnin kaç parça tuttuğu ve sınıra ne kadar uzak olduğu; send uç noktasının saydığı şekilde birebir sayılır.
- [Template ile SMS gönderme](https://api-docs.netgsm.com.tr/send-from-template.md): Kayıtlı template'leri verilen parametrelerle doldurup gönderen bir görev oluşturur.
- [Template'leri listeleme](https://api-docs.netgsm.com.tr/list-templates.md): Hesabın POST /send/template ile kullanabileceği template'leri, en yenisi önce, sayfa sayfa listeler: hesabın kendi template'leri ve herkese açık template'ler.
- [Varsayılan gönderici başlığını değiştirme](https://api-docs.netgsm.com.tr/change-default-sender.md): Kayıtlı bir başlığı varsayılan yapar.
- [Varsayılan gönderici başlığını öğrenme](https://api-docs.netgsm.com.tr/read-default-sender.md): Hesabın varsayılan gönderici başlığı, anlık olarak okunur; bu yüzden bir değişiklik hemen görünür.
- [Zamanlanmış gönderimi iptal etme](https://api-docs.netgsm.com.tr/cancel-job.md): Hesabınızın henüz gönderilmemiş bir görevini geri çeker.

## Authorization API

- [Authorization API](https://api-docs.netgsm.com.tr/auth.md): Kullanıcı adı ve şifreyle token alma ve token yenileme için v3 REST API. Canlı ortam: https://ext-api.netgsm.com.tr/auth/v3. Sandbox: https://ext-sandbox.netgsm.com.tr/auth/v3.
- [Netgsm Authorization API](https://api-docs.netgsm.com.tr/auth/netgsm-authorization-api.md): Bu API ile kullanıcı adı ve şifrenizle token alabilir, süresi dolmadan token'larınızı yenileyebilirsiniz.
- [Token](https://api-docs.netgsm.com.tr/auth/token.md): Token
- [Token alma](https://api-docs.netgsm.com.tr/auth/create-token.md): username ve password doğrulanır; başarılıysa bir access token ve bir refresh token döner.
- [Token yenileme](https://api-docs.netgsm.com.tr/auth/refresh-token.md): Refresh token ile yeni bir token çifti üretir.

## İYS API

- [İYS API](https://api-docs.netgsm.com.tr/iys.md): İYS'ye izin kaydetme, izin sorgulama ve webhook tanımlama için v1 REST API. Canlı ortam: https://ext-api.netgsm.com.tr/iys/v1. Token Authorization API'den alınır (/auth).
- [Netgsm İYS API](https://api-docs.netgsm.com.tr/iys/netgsm-iys-api.md): Bu API ile İleti Yönetim Sistemi'ne (İYS) izin kaydedebilir, kayıtlı izinleri sorgulayabilir ve izin sonuçlarının bildirileceği webhook adresinizi…
- [İzinler](https://api-docs.netgsm.com.tr/iys/izinler.md): İzinler
- [Webhook](https://api-docs.netgsm.com.tr/iys/webhook.md): Webhook
- [İzin kaydetme](https://api-docs.netgsm.com.tr/iys/save-consents.md): İzinleri İYS'ye kaydeder.
- [İzin sorgulama](https://api-docs.netgsm.com.tr/iys/search-consents.md): Bir ya da birden fazla alıcının İYS'deki izin durumunu sorgular.
- [Webhook kaydetme ve güncelleme](https://api-docs.netgsm.com.tr/iys/save-webhook.md): İYS'ye yüklediğiniz izinlerin işlenme sonuçlarının ve izin değişikliklerinin bildirileceği adresi tanımlar.

## Faks

- [Dosya yükleme](https://api-docs.netgsm.com.tr/guides/faks/dosya-yukleme.md): * Faks API, faks dosyanızı ve göndermek istediğiniz numara / numaraları belirleyerek iki aşamalı olarak faks gönderebilirsiniz. 1. aşamada faks dosyanızı random bir değerle yükleyerek, aynı random değerle gönderim işlemini 2. aşamada tekrar POST işlemi ile sağlayabilirsiniz.
- [Faks gönderme](https://api-docs.netgsm.com.tr/guides/faks/faks-gonderme.md): * İstediğiniz faks numarasına belirleyeceğiniz zaman aralıklarıyla faks gönderilmesi işlemidir.
- [Gelen faks](https://api-docs.netgsm.com.tr/guides/faks/gelen-faks.md): * Abone numaranıza gelen fakslarınızı API ile sorguyabilirsiniz.
- [Raporlama](https://api-docs.netgsm.com.tr/guides/faks/raporlama.md): * Abone numaranız ile gönderdiğiniz fakslarınızın iletim durumlarını sorgulayabilirsiniz.

## Sabit telefon

- [Görüşme detayı](https://api-docs.netgsm.com.tr/guides/sabit-telefon/gorusme-detayi.md): Gelen ve giden aramalarınızı bu servisi kullanarak sorgulayabilirsiniz.
- [Telesekreter mesajları](https://api-docs.netgsm.com.tr/guides/sabit-telefon/telesekreter-mesajlari.md): Abone numaranıza gelen sesli mesajları sorguyabilirsiniz.

## Sesli mesaj

- [Sesli mesaj başlatma](https://api-docs.netgsm.com.tr/guides/sesli-mesaj/sesli-mesaj-baslatma.md): Sesli Mesaj API ile, sesli mesajlarınızı senaryonuza göre basit ya da dinamik şekilde başlatabilirsiniz. Sistemimize yüklü ses dosyanız ya da göndereceğiniz textin* tarafımızda ses dosyasına dönüşümü ile Sesli Mesaj başlatabilirsiniz,
- [Sesli mesaj iptali](https://api-docs.netgsm.com.tr/guides/sesli-mesaj/sesli-mesaj-iptali.md): * İleri tarihe zamanlanmış sesli mesajlarınızı iptal edebilirsiniz.
- [Ses dosyaları](https://api-docs.netgsm.com.tr/guides/sesli-mesaj/ses-dosyalari.md): Yükleme
- [Raporlama servisi](https://api-docs.netgsm.com.tr/guides/sesli-mesaj/raporlama-servisi.md): Göndermiş olduğunuz sesli mesajların iletim durumlarını sorgulayabilirsiniz. Burada iki yöntemden birini tercih edebilirsiniz; HTTP POST ya da URL'e yönlendirme metodu.

## WhatsApp

- [Genel bakış](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-genel.md): Netgsm müşterisi, kendi Netgsm kullanıcı adı ve şifresiyle WhatsApp numarasından mesaj gönderir.
- [Mesaj gönderme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-mesaj-gonderme.md): Mesajlar POST https text, template, image, video, document, audio, location, replyReaction, markAsRead (örneğin .../messages/text). Başarılı gönderimde data.id mesajın kimliğidir; durumu (iletildi, okundu) mesaj geçmişinden ya da bildirimlerden izlenir.
- [Şablonlar ve mesaj geçmişi](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-sablonlar.md): Şablon listesi
- [İşletme profili](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-isletme-profili.md): WhatsApp'ta kişilerin gördüğü işletme bilgileri.
- [Bildirimler (webhook)](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-webhook.md): Gönderilen mesajlar, mesaj durumları ve gelen mesajlar, tanımladığınız bildirim adresine POST ile iletilir. Bu API'de webhook için bir işlem yoktur: adres portaldan tanımlanır, WhatsApp → Ayarlar → Yeni Webhook Ekle.
- [Ücretlendirme](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-ucretlendirme.md): Ücret, mesajın türüne ve alıcının ülkesine göre alınır:
- [Hatalar](https://api-docs.netgsm.com.tr/guides/whatsapp/whatsapp-api-hatalar.md): Hata yanıtı { "status" "..." } biçimindedir; ücretle ilgili hatalarda ayrıca error.code gelir.

## Sandbox

- [Sandbox](https://api-docs.netgsm.com.tr/sandbox.md): SMS API v3'ü gerçek SMS göndermeden ve ücret ödemeden denemek için test ortamı. Sandbox: https://ext-sandbox.netgsm.com.tr/sms/v3.
- [SMS API v3 Sandbox](https://api-docs.netgsm.com.tr/sandbox/sms-api-v-3-sandbox.md): SMS API v3'ü canlı ortama geçmeden, gerçek SMS göndermeden ve ücret ödemeden denemeniz için hazırlanmış test ortamıdır.
- [Gönderici adları](https://api-docs.netgsm.com.tr/sandbox/gonderici-adlari.md): Gönderici adları
- [Gönderim](https://api-docs.netgsm.com.tr/sandbox/gonderim.md): Gönderim
- [Hesap](https://api-docs.netgsm.com.tr/sandbox/hesap.md): Hesap
- [Kara liste](https://api-docs.netgsm.com.tr/sandbox/kara-liste.md): Kara liste
- [Raporlar ve gelen kutusu](https://api-docs.netgsm.com.tr/sandbox/raporlar-ve-gelen-kutusu.md): Raporlar ve gelen kutusu
- [Template](https://api-docs.netgsm.com.tr/sandbox/template.md): Template
- [Bakiye sorgulama (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/get-balance.md): Hesabın kalan paketlerini, kampanyalarını ve kredi bakiyesini döner. (Sandbox)
- [Gelen SMS'leri listeleme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/read-inbox.md): Kimliği doğrulanmış hesabın gelen kutusu, isteğe bağlı olarak bir aralıkla sınırlanır. (Sandbox)
- [Gönderici başlıklarını listeleme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/list-senders.md): Kimliği doğrulanmış hesaba kayıtlı gönderici başlıkları. (Sandbox)
- [Gönderim istatistiklerini sorgulama (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/read-stats.md): Kimliği doğrulanmış hesabın bir görevi için, gönderildiği ay üzerinden toplanmış, her farklı sonuç başına bir satır. (Sandbox)
- [İletim raporlarını sorgulama (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/read-reports.md): Kimliği doğrulanmış hesabın iletim raporlarından bir sayfa. (Sandbox)
- [Kara listeyi öğrenme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/read-blacklist.md): Hesabın kara listesindeki numaraları döndürür. (Sandbox)
- [OTP SMS gönderme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/send-otp.md): Tek bir alıcıya OTP (tek kullanımlık şifre) SMS'i gönderir. (Sandbox)
- [Rehbere SMS gönderme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/send-to-directory.md): Rehberdeki kişi gruplarına, istekte verilen kişilere ya da her ikisine tek bir metinle gönderimi kuyruğa alır. (Sandbox)
- [SMS gönderme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/send-sms.md): Bir ya da daha fazla alıcıya SMS gönderen bir görev oluşturur. (Sandbox)
- [SMS uzunluğunu hesaplama (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/measure-length.md): Bir metnin kaç parça tuttuğu ve sınıra ne kadar uzak olduğu; send uç noktasının saydığı şekilde birebir sayılır. (Sandbox)
- [Template ile SMS gönderme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/send-from-template.md): Kayıtlı template'leri verilen parametrelerle doldurup gönderen bir görev oluşturur. (Sandbox)
- [Template'leri listeleme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/list-templates.md): Hesabın POST /send/template ile kullanabileceği template'leri, en yenisi önce, sayfa sayfa listeler: hesabın kendi template'leri ve herkese açık template'ler. (Sandbox)
- [Varsayılan gönderici başlığını değiştirme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/change-default-sender.md): Kayıtlı bir başlığı varsayılan yapar. (Sandbox)
- [Varsayılan gönderici başlığını öğrenme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/read-default-sender.md): Hesabın varsayılan gönderici başlığı, anlık olarak okunur; bu yüzden bir değişiklik hemen görünür. (Sandbox)
- [Zamanlanmış gönderimi iptal etme (Sandbox)](https://api-docs.netgsm.com.tr/sandbox/cancel-job.md): Hesabınızın henüz gönderilmemiş bir görevini geri çeker. (Sandbox)

## Ek kaynaklar

- [Netgsm SMS API — OpenAPI tanımı (YAML)](https://api-docs.netgsm.com.tr/openapi/sms-v3.yaml)
- [SMS API v3 Sandbox — OpenAPI tanımı (YAML)](https://api-docs.netgsm.com.tr/openapi/sandbox-v3.yaml)
- [Netgsm Authorization API — OpenAPI tanımı (YAML)](https://api-docs.netgsm.com.tr/openapi/auth-v3.yaml)
- [Netgsm İYS API — OpenAPI tanımı (YAML)](https://api-docs.netgsm.com.tr/openapi/iys-v1.yaml)
- [llms-full.txt](https://api-docs.netgsm.com.tr/llms-full.txt): Tüm sayfaların (API referansı dahil) tam metni
- [Site haritası](https://api-docs.netgsm.com.tr/sitemap.xml)