API Documentation
Geliştiriciler için REST API referansı
Başlangıç
Post+ API, RESTful mimaride tasarlanmış, JSON formatında veri alışverişi yapan bir API'dir. API kullanımı için bir API anahtarına ihtiyacınız vardır.
Base URL
https://api.postplus.net/v1
Kimlik Doğrulama
Tüm API istekleri Authorization header ile gönderilmelidir:
Authorization: Bearer YOUR_API_KEY
API Anahtarı Alma
- Dashboard'a giriş yapın
- Ayarlar > API bölümüne gidin
- "API Anahtarı Oluştur" butonuna tıklayın
- Anahtarınızı güvenli bir yerde saklayın
WhatsApp API
POST /whatsapp/send
Tek bir alıcıya WhatsApp mesajı gönderir.
Request Parameters
| Parametre | Tip | Gerekli | Açıklama |
|---|---|---|---|
| phone | string | ZORUNLU | Alıcı telefon numarası (+90...) |
| message | string | ZORUNLU | Gönderilecek mesaj içeriği |
| sender_id | string | Opsiyonel | Gönderici hesap ID (varsayılan: ilk hesap) |
| media_url | string | Opsiyonel | Medya dosyası URL'i |
Örnek İstek
curl -X POST https://api.postplus.net/v1/whatsapp/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone": "+905551234567",
"message": "Merhaba! Bu bir test mesajıdır.",
"sender_id": "wa_123456"
}'
Örnek Yanıt
{
"success": true,
"message_id": "msg_987654",
"status": "sent",
"timestamp": "2025-01-19T10:30:00Z"
}
POST /whatsapp/send-bulk
Birden fazla alıcıya toplu WhatsApp mesajı gönderir.
Request Parameters
| Parametre | Tip | Gerekli | Açıklama |
|---|---|---|---|
| recipients | array | ZORUNLU | Alıcı listesi [{phone, name}, ...] |
| message | string | ZORUNLU | Mesaj şablonu ({name} gibi değişkenler kullanılabilir) |
| sender_id | string | Opsiyonel | Gönderici hesap ID |
| schedule_time | datetime | Opsiyonel | Zamanlanmış gönderim (ISO 8601) |
Örnek İstek
curl -X POST https://api.postplus.net/v1/whatsapp/send-bulk \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"recipients": [
{"phone": "+905551234567", "name": "Ahmet"},
{"phone": "+905559876543", "name": "Ayşe"}
],
"message": "Merhaba {name}! Özel kampanyamızı kaçırmayın.",
"sender_id": "wa_123456"
}'
GET /whatsapp/status/{message_id}
Gönderilen mesajın durumunu sorgular.
Örnek Yanıt
{
"message_id": "msg_987654",
"status": "delivered",
"sent_at": "2025-01-19T10:30:00Z",
"delivered_at": "2025-01-19T10:30:05Z",
"read_at": "2025-01-19T10:31:20Z"
}
Email API
POST /email/send
E-posta gönderir.
Request Parameters
| Parametre | Tip | Gerekli | Açıklama |
|---|---|---|---|
| to | string | ZORUNLU | Alıcı e-posta adresi |
| subject | string | ZORUNLU | E-posta konusu |
| html | string | ZORUNLU | HTML içerik |
| from_name | string | Opsiyonel | Gönderen adı |
Hata Kodları
| Kod | Açıklama |
|---|---|
| 200 | Başarılı istek |
| 400 | Geçersiz istek parametreleri |
| 401 | Geçersiz veya eksik API anahtarı |
| 403 | Yeterli kredi yok |
| 429 | Rate limit aşıldı |
| 500 | Sunucu hatası |
Rate Limits
API kullanımında aşağıdaki limitler geçerlidir:
- Starter: 60 istek/dakika
- Pro: 300 istek/dakika
- Enterprise: 1000 istek/dakika