Geliştirici Dokümantasyonu

API Referansı

Uygulamalarınızı Ankara Yazılım hizmetleriyle entegre edin.

Base URL:api.ankarayazilim.org/v1

Auth:Bearer Token

Format:JSON

Toplu SMS API

Programatik SMS gönderimi için RESTful API.

POST/send

Tek veya toplu SMS gönderimi

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`to`	string \| string[]	Evet	Alıcı telefon numaraları (+90 ile başlamalı)
`message`	string	Evet	Mesaj içeriği (160 karakter/SMS)
`sender`	string	Hayır	Gönderici başlığı (BTK onaylı)
`scheduledAt`	ISO 8601	Hayır	Zamanlı gönderim tarihi

Kod Örnekleri

curl

curl -X POST https://api.ankarayazilim.org/v1/sms/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["+905551234567"],
    "message": "Sipari\u015Finiz kargoya verildi.",
    "sender": "ANKARA_YZL"
  }'

GET/reports/{messageId}

Gönderim raporu sorgulama

Parametreler

Parametre	Tip	Zorunlu	Açıklama
`messageId`	string	Evet	Mesaj ID (send yanıtından döner)

Kod Örnekleri

curl

curl https://api.ankarayazilim.org/v1/sms/reports/msg_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/balance

Kalan SMS kredisi sorgulama

Kod Örnekleri

curl

curl https://api.ankarayazilim.org/v1/sms/balance \
  -H "Authorization: Bearer YOUR_API_KEY"