🔌 API Erişimi ve Entegrasyonlar
REST API ile posta kutusu açma, takma ad ekleme gibi tüm panel işlemleri programatik olarak yapılabilir — müşteri paneli entegrasyonu veya otomasyon betikleri için idealdir.
Bu sayfada
1. API anahtarı oluşturma
-
API bölümüne gidin
Sistem › Yapılandırma › Erişim sekmesinde aşağı inin; API bölümünde iki ayrı anahtar alanı vardır:
- Sadece okuma (RO): verileri listeleyebilir, değişiklik yapamaz.
- Okuma yazma (RW): tüm işlemleri yapabilir.
- IP kısıtlaması girin "Bu IP'lerden API erişimine izin ver" alanına, API'yi kullanacak sunucunun IP adresini veya CIDR bloğunu yazın. Zorunludur; her yerden erişim için API için IP kontrolünü atla işaretlenebilir ancak önerilmez.
- "API etkinleştir" kutusunu işaretleyip kaydedin Sistem bir API anahtarı üretir. API anahtarını yeniden oluştur düğmesi eski anahtarı geçersiz kılıp yenisini üretir.
RW anahtarı, panelin tamamına eşdeğer yetkidir. Kimseyle paylaşmayın, kod depolarına koymayın; sızdığından şüphelenirseniz hemen yeniden oluşturun.
2. API'yi kullanma
- Etkileşimli dokümantasyon (Swagger):
https://mail.mesutguner.com.tr/api - Anahtar, isteklerde
X-API-Keybaşlığıyla gönderilir.
Örnek: posta kutularını listeleme
curl -s -H "X-API-Key: ANAHTARINIZ" \
https://mail.mesutguner.com.tr/api/v1/get/mailbox/allÖrnek: yeni posta kutusu oluşturma
curl -s -X POST -H "X-API-Key: ANAHTARINIZ" \
-H "Content-Type: application/json" \
-d '{"local_part":"ahmet","domain":"ornek.com","name":"Ahmet Yılmaz",
"password":"Gizli123!","password2":"Gizli123!","quota":"3072","active":"1"}' \
https://mail.mesutguner.com.tr/api/v1/add/mailboxCORS ayarları (Access-Control-Allow-Origin) aynı bölümdedir; tarayıcı tabanlı bir uygulamadan doğrudan API çağrısı yapacaksanız kendi alan adınızı ekleyin.