Geliştiriciler

E-posta için temiz bir JSON API.

Posta kutularını listeleyin, iletileri okuyun, e-posta gönderin ve kota sorgulayın. Her anahtar yalnızca sahibinin posta kutularına erişir; yetkiler, süre ve istek sınırı sizin elinizde.

Ücretsiz başla Anahtar oluştur

Hızlı başlangıç

İlk isteğiniz bir dakika sürer.

Panelde API anahtarları sayfasından yeni bir anahtar oluşturun.
Gerekli yetkileri seçin: örneğin yalnızca messages:read.
Anahtarı Authorization: Bearer başlığıyla gönderin.

terminal

# Gelen kutusundaki son 5 ileti
curl https://alanadiniz.com/api/v1/mailboxes/1/messages?per_page=5 \
  -H "Authorization: Bearer $COREMAIL_KEY"

{
  "ok": true,
  "data": {
    "total": 42,
    "items": [
      { "uid": 318, "subject": "Teklif talebi", "seen": false }
    ]
  }
}

Referans

Uç noktalar

Tüm yollar /api/v1 ile başlar. Yanıtlar her zaman {"ok": true, "data": …} veya {"ok": false, "error": {…}} biçimindedir.

API uç noktaları
Yöntem ve yol	Yetki	Açıklama
GET `/me`	mailboxes:read	Hesap, limitler ve kullanılabilir alan adları
GET `/mailboxes`	mailboxes:read	Posta kutularınızı listeler
POST `/mailboxes`	mailboxes:write	Yeni posta kutusu oluşturur
GET `/mailboxes/{id}/quota`	mailboxes:read	Kota kullanımı
GET `/mailboxes/{id}/folders`	messages:read	Klasörler ve okunmamış sayıları
GET `/mailboxes/{id}/messages`	messages:read	İleti listesi, sayfalama ve arama
GET `/mailboxes/{id}/messages/{uid}`	messages:read	İletiyi okur
GET `/mailboxes/{id}/messages/{uid}/attachments/{n}`	messages:read	Eki indirir
PATCH `/mailboxes/{id}/messages/{uid}`	messages:write	Okundu işareti veya klasöre taşıma
DELETE `/mailboxes/{id}/messages/{uid}`	messages:write	Çöpe taşır veya kalıcı siler
POST `/mailboxes/{id}/send`	messages:send	E-posta gönderir (ekli)
POST `/mailboxes/{id}/drafts`	messages:write	Taslak kaydeder

Kontrol

Anahtarlar üzerinde tam kontrol.

Yetki kapsamları

mailboxes:read, mailboxes:write, messages:read, messages:write ve messages:send; yalnızca gerekenleri verin.

İstek sınırı

Anahtar başına dakikalık sınır; yanıt başlıklarında kalan hak, aşımda 429 ve Retry-After.

Süre ve iptal

Son kullanma tarihi belirleyin, anahtarı istediğiniz an iptal edin. Yöneticiler de tüm anahtarları görebilir ve iptal edebilir.

Sahiplik izolasyonu

Başka bir kullanıcının posta kutusu kimliği her zaman 404 döner; varlığı bile sızdırılmaz.

Hash'li saklama

Anahtarın tamamı yalnızca oluşturulurken gösterilir; sistemde yalnızca SHA-256 özeti tutulur.

Denetim kaydı

API ile yapılan işlemler hangi anahtarla, ne zaman ve hangi IP'den yapıldığıyla kaydedilir.

Hata yönetimi

Öngörülebilir hata kodları.

Her hata, makinenin okuyabileceği bir kod ve insanın anlayabileceği Türkçe bir mesaj içerir.

403 Forbidden

{
  "ok": false,
  "error": {
    "code": "insufficient_scope",
    "message": "Bu işlem için API anahtarında
      \"messages:send\" yetkisi yok."
  }
}

Rehberler

Konuyla ilgili yazılar

Geliştirici2 dk okuma

API ile e-posta otomasyonu: CRM, form ve bildirim senaryoları

COREMAIL JSON API ile web formu bildirimleri, CRM entegrasyonu ve destek kutusu otomasyonu için örnek akışlar ve güvenli anahtar kullanımı.

Rehberi oku

Teslim edilebilirlik2 dk okuma

E-postam neden gitmiyor? Sık görülen SMTP hata kodları ve çözümleri

550, 554, 535, 452 ve 421 gibi geri dönen e-posta (bounce) hata kodlarının anlamı ve her biri için atmanız gereken adımlar.

Rehberi oku

Rehber2 dk okuma

IMAP, POP3 ve SMTP nedir? Doğru e-posta ayarları ve port numaraları

E-posta uygulamanızı kurarken karşınıza çıkan IMAP, POP3 ve SMTP kavramlarını, hangi portun ne işe yaradığını ve neden IMAP'i tercih etmeniz gerektiğini anlatıyoruz.

Rehberi oku

Tüm rehberler ve blog yazıları

Hemen başlayın

Hukuk pratiğiniz için güvenli iletişim.

14 günlük ücretsiz deneme ile COREMAIL'i keşfedin. Avukatlar, noterler ve hukuk büroları için e-posta hizmeti; kredi kartı gerekmez.

Ücretsiz deneyin Satış ekibiyle görüşün