Kurumsal e-posta REST API: posta kutusu yönetimini bağlayın
Yeni çalışan işe başladığında birden fazla yönetim ekranını elle dolduruyorsanız, posta kutusu adımını iç sisteminize bağlayabilirsiniz. Önce küçük ve okunabilir bir listeleme isteğiyle başlayın.
TekPosta REST API, şirketinizin domainlerini ve posta kutularını listelemek, posta kutusu oluşturmak veya kaldırmak ve uygulama şifresi üretmek için kullanılabilir. İstekler Bearer token ile yetkilendirilir; bu API genel bir toplu e-posta gönderim servisi değildir.
Bu rehber kimler için? İç araç geliştiren yazılımcılar, ajanslar ve birden fazla şirketin e-posta yönetimini yürüten teknik ekipler.
API kapsamını ekran adlarından tahmin etmeyin
V1 API’de domain ve mail adresi listeleme uçları bulunur. Mail adresi oluşturma, kaldırma ve o kutu için uygulama şifresi üretme işlemleri de desteklenir. Domain eklemenin bu uçlarla yapıldığını varsaymayın; önce panelde domain kurulumunu ve DNS doğrulamasını tamamlayın.
Panel içindeki API dokümanını gerçek alan adları ve parametreler için esas alın. Yeni bir entegrasyonun ilk kontrolü, beklediğiniz şirketin domain listesini döndürdüğünü doğrulamak olmalıdır.
İlk isteği listelemeyle sınayın
Tokenı yetkili panelden alın ve sunucu tarafında saklayın. Tarayıcıya gönderilen JavaScript içine veya herkesin eriştiği depoya koymayın. Aşağıdaki örnekte TOKEN gerçek bir değerin yerini tutar; komutu kendi güvenli ortamınızda uyarlayın.
- GET /api/v1/domains: şirket domainlerini listeleme.
- GET /api/v1/mailboxes: posta kutularını listeleme.
- POST /api/v1/mailboxes: uygun domain altında kutu oluşturma.
- POST /api/v1/mailboxes/{id}/app-passwords: ilgili kutu için uygulama şifresi üretme.
- DELETE /api/v1/mailboxes/{id}: kutu kaldırma; iş akışında ayrıca dikkatli değerlendirin.
GET https://tekposta.com/api/v1/domains Authorization: Bearer TOKEN Accept: application/json
Tokenı bir şifre gibi yönetin
Bearer tokenı elinde tutan sistem yetkili istek yapabilir. Test ile üretim değerlerini ayırın; gereksiz tokenları iptal edin ve erişimini kaybeden entegrasyonların değerlerini yenileyin. Birden fazla müşteri yönetiyorsanız her işin doğru şirket tokenıyla çalıştığını kontrol edin.
Uygulama şifresi üretildiğinde dönen gizli değeri müşteri kaydı veya hata logu içine yazmayın. Gizli bilgi gerektirmeyen işlem kayıtlarında şirket, işlem türü, saat ve sonuç yeterlidir. Tokenları destek ekran görüntülerinde maskeleyin.
Başarısız yanıtı tekrar denemeden sınıflandırın
401 için tokenın doğru ve geçerli olduğunu, 403 için hesap durumunu ve erişim bağlamını kontrol edin. Doğrulama hatasında aynı veriyi tekrar göndererek sonuç beklemeyin; dönen alan hatalarını düzeltin.
Kutu oluşturma isteğinin yanıtı bağlantıda kaybolursa yeniden oluşturmadan önce kutu listesini okuyun. İlk istek tamamlanmış olabilir. Silme işlemini otomatik tekrar kuyruğuna koymadan veri ve arşiv politikanızı netleştirin.
Çalışan açılışını küçük bir kabul listesine bağlayın
Domainin hazır olması, adresin doğru yazılması, kotanın planla uyumu ve cihazın bağlanabilmesi ayrı kontrollerdir. API yanıtının başarılı olması bu dört koşulun tümünü tek başına kanıtlamaz. İlk entegrasyonu deneme kutusuyla sınayın; dış alım ve gönderimi ayrıca test edin.
Sık sorulan sorular
REST API ile domain ekleyebilir miyim?
Mevcut V1 domain ucu listeleme içindir. Domain ekleme ve DNS hazırlığını panelden yürütün; desteklenen işlemler için paneldeki API dokümanını kontrol edin.
API tokenını web sitesinin ön yüzüne koyabilir miyim?
Hayır. Bearer token gizli erişim bilgisidir; sunucu tarafında saklanmalı ve ziyaretçiye gönderilmemelidir.
Kaynaklar ve doğrulama
Teknik adımları uygularken aşağıdaki kaynakları ve kullandığınız sağlayıcının güncel ayarlarını birlikte kontrol edin. Örnek kayıtlar kendi domaininiz için panelde üretilen değerlerin yerine geçmez.
Şirketinizin e-postasını kendi domaininizde yönetin
TekPosta'da domain, DNS doğrulama, mail adresleri, uygulama şifreleri ve taşıma adımlarını aynı panelden takip edebilirsiniz. Ekibinizin ihtiyacına uygun planı inceleyin veya geçiş planınızı bizimle paylaşın.