Güçlü RESTful API ile SMS entegrasyonu. Kapsamlı dokümantasyon, örnekler ve gerçek sistem entegrasyonu.
5 dakikada SMS API'nizi entegre edin
cURL, PHP, Python veya JavaScript ile REST API'yi test edin
Webhook'ları kurun, raporları takip edin ve gerçek SMS gönderimlerini başlatın
Tüm SMS API endpoint'leri ve kullanım örnekleri
Tek veya çoklu numara SMS gönderimi
https://anadolusms.com/api/v1/sms/send
{
"to": "+905551234567",
"message": "Merhaba! Bu bir test mesajıdır.",
"originator": "BASLIK",
"schedule_at": null
}
Not: to parametresi tek numara veya array olabilir. Maksimum 1000 alıcı desteklenir.
SMS gönderim durumunu ve detaylarını kontrol edin
https://anadolusms.com/api/v1/reports?send_id=123
{
"summary": {
"id": 123,
"status": "completed",
"total_sent": 100,
"success_count": 98,
"failed_count": 2,
"parts": 1
},
"details": [...]
}
Çoklu numaraya aynı mesaj gönderimi
https://anadolusms.com/api/v1/sms/send
{
"to": [
"+905551234567",
"+905559876543",
"+905551111111"
],
"message": "Toplu mesaj",
"originator": "BASLIK"
}
Not: Aynı endpoint kullanılır. to parametresi array olarak gönderilir. Maksimum 1000 numara.
Hesap bakiyenizi sorgulayın
https://anadolusms.com/api/v1/account/balance
{
"balance": 1250.50,
"currency": "TRY"
}
Kullanılabilir gönderici başlıklarınızı alın
https://anadolusms.com/api/v1/originators
{
"originators": [
"BASLIK1",
"BASLIK2",
"KCDSMS"
]
}
Favori programlama dilinizde hızlı entegrasyon
<?php
$apiKey = 'your-api-key';
$apiUrl = 'https://anadolusms.com/api/v1';
// SMS gönder
$ch = curl_init($apiUrl . '/sms/send');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $apiKey,
'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'to' => '+905551234567',
'message' => 'Merhaba!',
'originator' => 'BASLIK'
]));
$response = curl_exec($ch);
$result = json_decode($response, true);
echo $result['send_id']; // 123
?>
import requests
api_key = 'your-api-key'
api_url = 'https://anadolusms.com/api/v1'
response = requests.post(
f'{api_url}/sms/send',
json={
'to': '+905551234567',
'message': 'Merhaba!',
'originator': 'BASLIK'
},
headers={
'Authorization': f'Bearer {api_key}',
'Content-Type': 'application/json'
}
)
result = response.json()
print(result['send_id']) # 123
const axios = require('axios');
const apiKey = 'your-api-key';
const apiUrl = 'https://anadolusms.com/api/v1';
axios.post(`${apiUrl}/sms/send`, {
to: '+905551234567',
message: 'Merhaba!',
originator: 'BASLIK'
}, {
headers: {
'Authorization': `Bearer ${apiKey}`,
'Content-Type': 'application/json'
}
}).then(response => {
console.log(response.data.send_id); // 123
});
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
String apiKey = "your-api-key";
String apiUrl = "https://anadolusms.com/api/v1";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(apiUrl + "/sms/send"))
.header("Authorization", "Bearer " + apiKey)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(
"{\"to\":\"+905551234567\",\"message\":\"Merhaba!\",\"originator\":\"BASLIK\"}"
))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
Gerçek zamanlı bildirimler ve olay takibi
Kullanıcı panelinden webhook URL'inizi yapılandırın. API Bilgisi sayfasından webhook ayarlarınızı yapabilirsiniz. HTTPS zorunludur.
https://yourdomain.com/webhook/sms
sms.queued - SMS kuyruğa alındı (zamanlanmış gönderim)sms.sent - SMS başarıyla gönderildisms.failed - SMS gönderim hatasıX-Timestamp ve X-Signature
Gelen webhook verisi örneği
POST https://yourdomain.com/webhook/sms
X-Timestamp: 1730284500
X-Signature: sha256=f1a9...
Content-Type: application/json
{
"event": "sms.sent",
"send_id": 123,
"parts": 1,
"count": 3,
"failed": 0,
"originator": "BASLIK"
}
Kapsamlı hata kodları ve çözüm önerileri
API kullanım limitleri ve güvenlik önlemleri
Authorization: Bearer YOUR_API_KEYContent-Type: application/jsonIdempotency-Key: UUID (opsiyonel)
Authorization: Bearer ile gönderinAuthorization: Bearer your-api-keyContent-Type: application/jsonIdempotency-Key: 550e8400-e29b-41d4-a716-446655440000
Developer'ların en çok merak ettiği konular
Kullanıcı paneline giriş yapın, "API Bilgisi" bölümünden yeni bir key oluşturun. Key'i güvenli bir yerde saklayın. API ayarları sayfasına buradan erişebilirsiniz.
429 hata kodu döner. Varsayılan limit 300 istek/dakikadır. Exponential backoff kullanarak tekrar deneme yapın.
Evet, webhook'lar HMAC-SHA256 ile imzalanır. Header'lar: X-Timestamp ve X-Signature. Signature'ı doğrulayarak güvenliği sağlayın. HTTPS zorunludur.
schedule_at parametresi ile ISO8601 formatında (örn: 2025-12-31T23:59:00+03:00) tarih gönderin.
SMS belirtilen zamanda otomatik gönderilir. Önemli:
+03:00)Tek seferde maksimum 1000 numaraya SMS gönderebilirsiniz. Daha fazlası için istekleri bölerek gönderin. Sunucu tarafında otomatik olarak 1000'lik parçalara bölünerek işlenir.
Maksimum 8 SMS bölümü (parts) gönderebilirsiniz. API'deki hesaplama user-panel ile tamamen aynıdır. Her zaman Türkçe karakter seti (tr2) olarak hesaplanır:
parts × recipient_count