Başla

API Üzerinden E-posta Nasıl Okunur: Geliştiriciler İçin Gelen Kutusu Erişimi Rehberi (2026)

İçindekiler
Bölümlere Göz At
Geliştirici Kılavuzu 2026

E-postaları API Üzerinden Okuma: Geliştiriciler İçin Bir Kılavuz Gelen Kutusu Erişimi

Kapsam: Bu rehber şunları kapsar API'leri senkronize et Kullanıcıların mevcut gelen kutularını okumak için Gmail API, Microsoft Graph, IMAP ve Unipile gibi birleşik katmanlar. Bu, alan adınızdan dışarıya e-posta gönderen işlemsel hizmetlerden (SendGrid, Mailgun) farklıdır.

Tek bir yazılımla kullanıcı e-postalarını programatik olarak okuyan ürünler oluşturun GET /api/v1/e-postalar Gerçek zamanlı webhook çağrıları, bu rehber Node.js, Python ve cURL'de çalışan kodlarla her yaklaşımı kapsar.

Ücretsiz denemeyi başlat E-posta API Kılavuzu
read_inbox.js
// Tek bir birleşik API çağrısıyla e-postaları okuyun const response = bekliyor fetch( 'https://api3.unipile.com:PORT/api/v1/emails', { headers: { 'X-API-ANAHTARI': process.env.UNIPILE_API_ANAHTARI, 'hesap_kimliği': accountId } } ); const { e-postalar } = bekliyor cevap.json(); // Gmail, Outlook ve IMAP için aynı JSON yapısı e-postalar.her biri için(e-posta => { konsol.log(e-posta.konu, e-posta.katılımcıdan); });
200 OK - 47 e-posta döndürüldü (Gmail + Outlook + IMAP)
Şunlarla çalışır: Gmail Görünüm IMAP Gmail, Outlook ve IMAP
Tanım

Okunabilir E-posta API'si Nedir?

E-posta okuma API'si, bir HTTP arayüzüdür ve uygulamanızın kullanıcıların mevcut posta kutularından şifreleri saklamadan veya sağlayıcıya özel entegrasyonlar oluşturmadan e-postalara erişmesini, bunları almasını ve işlemesini sağlar. CRM senkronizasyonu, yapay zeka e-posta yardımcı pilotları, destek otomasyonu veya uyumluluk arşivlemesi gibi gelen kutusu görünürlüğü gerektiren herhangi bir ürünün temelini oluşturur.

Hızlı tanım

A e-posta oku API'si kullanıcının posta kutusunda kimlik doğrulaması yapmak (OAuth 2.0 veya IMAP kimlik bilgileri aracılığıyla), gelen kutusu mesajlarını listelemek, ekleriyle birlikte tam e-posta gövdelerini almak ve gerçek zamanlı teslimat olaylarına abone olmak için uç noktalar sunar. Mevcut Gmail, Outlook veya IMAP hesabı üzerinde çalışır değil sizin kontrolünüzde bir alan. Bu, onu, uygulamanız adına giden e-posta gönderen işlemsel e-posta API'lerinden (SendGrid, Mailgun, Resend) ayırır.

Bu rehber şunları kapsar
E-posta Senkronizasyon / Okuma API'leri

Kullanıcıların mevcut gelen kutularına bağlanır. E-postaları gerçek zamanlı olarak okur, senkronize eder ve yanıtlar. OAuth 2.0 veya IMAP aracılığıyla kimlik doğrulaması yapar. Kullanıcı kendi posta kutusuna erişim izni verir.

Örnekler: Gmail API, Microsoft Graph, IMAP, Unipile
Bu rehber değil
İşlemsel E-posta API'leri

Kontrolünüzdeki bir alan adından giden e-postalar gönderin. Makbuzlar, bildirimler, şifre sıfırlamalar için kullanılır. Gelen kutusu erişimi yok.

Örnekler: SendGrid, Mailgun, Resend, Postmark
Kullanım Örnekleri

E-postaları Programatik Olarak Okumanın Önemi

E-postaları API aracılığıyla okuma yeteneği, yalnızca SMTP ile imkansız olan bir ürün kategorisinin kilidini açar. İşte 2026'da benimsenmeyi sağlayan dört ana kullanım durumu.

CRM ve Satış Etkileşimi Senkronizasyonu

Satış araçlarının, bir temsilci ile potansiyel müşteri arasındaki her e-posta konuşmasını manuel kayıt yapmadan otomatik olarak görmesi gerekir. Okunan e-posta API'si, konuşmaları doğrudan temsilcinin gelen kutusundan çeker ve bunları gerçek zamanlı olarak CRM'inize senkronize eder.

E-posta yazışmalarını otomatik olarak kişi kayıtlarına kaydet
Gelen kutusu iş parçacıklarından anlaşmaya ilişkin sinyalleri yüzeye çıkarın
Yanıt niyetini algıla ve işlem hattı aşamasını güncelle

Yapay Zeka Ajanları ve E-posta Yardımcıları

Büyük dil modelleri bağlama ihtiyaç duyar. Yapay zeka temsilcinize gerçek zamanlı bir gelen kutusu e-postası akışı besleyerek, yanıt taslakları oluşturan, konuşmaları özetleyen, yapılacakları çıkaran ve konuşmaları otomatik olarak önceliklendiren yardımcı pilotlar oluşturabilirsiniz.

Yeni e-postaları bir LLM işleme hattına akıtın
Bağlamı dikkate alan taslak yanıtlar oluşturun
Konu başlıklarından görevleri, tarihleri ve taahhütleri çıkarın

Müşteri Destek Otomasyonu

Destek ekipleri günde binlerce e-posta alır. Okunmuş bir e-posta API'si, bir insanın bile bir destek kaydını açmasından önce platformunuzun gelen istekleri sınıflandırmasına, doğru sıraya yönlendirmesine ve otomatik yanıtları tetiklemesine olanak tanır.

Destek e-postalarını konu ve aciliyet durumuna göre sınıflandırın
E-posta içeriğine göre temsilci kuyruklarına yönlendirme
Sık sorulan istek biçimleri için otomatik yanıtları tetikleyin

Uyumluluk, Arşivleme ve eKeşif

Düzenlenmiş sektörlerin her e-postayı saklaması ve indekslemesi gerekir. Okunmuş e-posta API'si, gelen kutularını sürekli arşivlemek, politika ihlallerini işaretlemek ve yasal inceleme için talep üzerine e-posta kayıtları oluşturmak için gereken programatik erişimi sağlar.

GDPR / FINRA uyumluluğu için sürekli gelen kutusu arşivleme
Çalışan posta kutularında politika ihlali tespiti
İsteğe bağlı eDiscovery ihracatı (yasal saklama için)
Sağlayıcı Derinlemesine İnceleme

E-posta Okumak İçin Yerel API'ler: Gmail, Outlook ve IMAP

Her büyük e-posta sağlayıcısı, farklı uç noktalar, kimlik doğrulama modelleri ve yeteneklere sahip kendi okuma API'sini sunar. İşte uygulamada her biri nasıl görünüyor.

Gmail API

OAuth 2.0

Gmail API, Google'ın altyapısı üzerine kurulu bir REST API'dir. Bunu kullanır kullanıcıların mesaj listesi bir posta kutusunda sayfalama ve kullanıcılar.mesajlar.al tam bir mesaj almak için. Google Pub/Sub üzerinden anlık bildirimleri destekleyerek, yoklama yapmaya gerek kalmadan gerçek zamanlı gelen kutusu izlemeyi mümkün kılar. Hız sınırı: kullanıcı başına saniyede 250 kota birimi.

gmail_oku.sh
# Gelen kutusundaki mesajları listele (Gmail API) kıvrıl -X GET \ "https://gmail.googleapis.com/gmail/v1/users/me/messages?labelIds=INBOX&maxResults=20" \ -H "Yetkilendirme: Bearer ACCESS_TOKEN" # Tek bir e-postayı tam metin olarak getir kıvrıl -X GET \ "https://gmail.googleapis.com/gmail/v1/users/me/messages/MESAJ_ KIMLIĞI?format=full" \ -H "Yetkilendirme: Bearer ACCESS_TOKEN"
Not: Gmail mesajları taban64 kodlu MIME parçaları olarak döndürür. Düz metin gövdesini, HTML gövdesini ve ekleri çıkarmak için her bir parçayı koddan çıkarmanız ve çoklu parça sınırlarını kendiniz ayrıştırmanız gerekir.

Microsoft Graph (Outlook ve Microsoft 365)

OAuth 2.0

Microsoft Graph, Outlook kişisel hesapları, Exchange Online ve Microsoft 365 iş posta kutuları dahil tüm Microsoft 365 hizmetleri için birleşik API'dir. /ben/mesajlar uç nokta, tüm gövde içeriğini tek bir istekte döndürür. Sayfalama kullanılır $ atla ve $üst OData parametreleri. Tamamını gör Microsoft Graph e-posta entegrasyon kılavuzu detaylar için.

graph_oku.sh
# Gelen kutusundaki mesajları listele (Microsoft Graph) kıvrıl -X GET \ ""https://graph.microsoft.com/v1.0/me/messages?\$top=20&\$filter=parentFolderId eq 'inbox'"' \ -H "Yetkilendirme: Bearer ACCESS_TOKEN" \ -H "İçerik-Türü: uygulama/json" # İçeriği olan tek bir mesajı getir kıvrıl -X GET \ ""https://graph.microsoft.com/v1.0/me/messages/MESSAGE_ID?\$select=subject,body,from,receivedDateTime"" \ -H "Yetkilendirme: Bearer ACCESS_TOKEN"
Not: Microsoft Graph, uygulama başına kiracı başına 10 dakikada 10.000 istekte hız sınırı uygular. Gövde içeriği, şuna bağlı olarak HTML veya metin olarak döndürülür: $seçin ve Kabul et başlıklar.

IMAP

Evrensel Protokol

IMAP (İnternet Mesajı Erişim Protokolü), neredeyse her posta sunucusu tarafından desteklenen evrensel bir e-posta protokolüdür. REST API değildir, ancak 993 (TLS) bağlantı noktası üzerinden durum bilgisi tutan bir TCP bağlantısıdır. Komutları şu şekilde verirsiniz: ÇEK, ARAMAve BOŞTA bağlantı üzerinden. Daha derinlemesine bilgi için lütfen şunlara bakınız: IMAP API entegrasyon kılavuzu.

imap_oku.py
İthalat imaplib, e-posta # Bağlan ve kimlik doğrulama yap posta = imaplib.IMAP4_SSL('imap.example.com') posta.Giriş('user@example.com', 'uygulama_parolası') posta.seç('GELEN KUTUSU') # Gizli mesajları ara durum, mesaj_kimlikleri = posta.arama(Hiçbiri, 'GÖRÜLMEMİŞ') için mesaj_kimliği içinde mesaj_kimlikleri[0].bölmek(): _, veri = posta.fetch(mesaj_kimliği, '(RFC822)') mesaj = e-posta.bayttan_mesaj(veri[0][1]) print(mesaj['konu'], mesaj['dan'])
Not: IMAP, uzun ömürlü TCP bağlantılarının sürdürülmesini ve bağlantı havuzlarının kendiniz yönetilmesini gerektirir. Gerçek zamanlı teslimat, BOŞTA birkaç yüz eşzamanlı hesabin ötesinde kolayca ölçeklenmeyen, bir bağlantıyı açık tutan ve sunucu bildirimlerini bekleyen bir komut.
Yahoo ve diğer sağlayıcılar hakkında ne düşünüyorsunuz?

Yahoo Mail, ProtonMail, Zoho ve diğer sağlayıcılar evrensel bir yedek olarak IMAP'ı destekler, bu nedenle yukarıdaki IMAP yaklaşımıyla kapsanırlar. Bazıları (Yahoo gibi) sınırlı tescilli API'ler de sunar, ancak hiçbiri Gmail API'sinin veya Microsoft Graph'ın yetenekleriyle eşleşmez. Çoğu çoklu sağlayıcı ürünü için IMAP, Gmail veya Outlook OAuth tarafından kapsanmayan herhangi bir posta kutusu için evrensel yedektir. birleşik e-posta API'si Bu müzakereyi otomatik olarak yürütür.

Mühendislik Gerçekliği

E-postaları Büyük Ölçekte Okumanın Gizli Karmaşıklığı

Tek bir sağlayıcıya karşı bir e-posta okuma API entegrasyonu oluşturmak bir demo için öğleden sonra sürer. Tüm sağlayıcılarda güvenilir bir şekilde ve üretim ölçeğinde çalışan bir entegrasyon oluşturmak ise tamamen farklı bir zorluktur. Mühendislikte gerçekte olan şey şudur.

01

Sağlayıcı Başına OAuth Akışı

Her sağlayıcının kendi OAuth 2.0 uygulaması, onay ekranı gereksinimleri, kapsamları ve belirteç ömrü vardır. Gmail ve Outlook'u desteklemek, iki ayrı OAuth uygulaması, iki geliştirici konsolu, iki belirteç yenileme stratejisi ve iki uyumluluk setini (Google CASA Seviye 2, Microsoft Publisher Verification) sürdürmek anlamına gelir.

GmailGoogle Cloud Konsolu uygulaması, hassas kapsamlar için CASA Katman 2, 1 saatlik erişim jetonları
Outlook:Azure AD uygulama kaydı, Yayıncı Doğrulaması, yapılandırılabilir belirteç TTL
IMAP:Uygulama şifreleri veya OAuth (Gmail IMAP, aynı Google OAuth akışını kullanır)
02

Sayfalama Farkları

Her sağlayıcı farklı sayfalama kullanır. Gmail opak sayfa belirteçleri kullanır. Microsoft Graph OData kullanır. $ atla ve sonrakiBağlantı İmleçler. IMAP sayısal UID aralıkları kullanır. Üçü arasında tutarlı bir sayfalama soyutlaması uygulamak, önemsiz olmayan bir adaptör kodu gerektirir.

GmailSayfa jetonu imleci, sayfa başına en fazla 500 sonuç
Grafik@odata.nextLink URL'si, $top/$skip parametreleri
IMAP:UID KAPSAMI AL, KONDİSYON DEPOLAMA aşamalı senkronizasyon için
03

MIME Ayrıştırma

E-postalar, iç içe geçmiş çok parçalı sınırlar, base64 veya quoted-printable kodlaması, birden çok karakter kümesi ve satır içi ekler içeren ham MIME belgeleri olarak gelir. Gmail, base64url kodlu parçalar döndürür. IMAP, ham RFC 822 döndürür. İkisi de tam MIME ağacını ayrıştırmadan size temiz bir düz metin gövdesi sağlamaz.

RiskUluslararası karakterler, emojiler ve sağdan sola metinler, gövde içeriğini bozan kodlama uç durumlarını tanıtıyor.
Eklerİçerik-Yönlendirme: ek parçalarını bulmak için MIME ağacında gezinilmelidir
04

Kota Sınırları ve Geri Çekilme

Gmail kullanıcı başına saniyede 250 kota birimi zorlar (listeleme 5 birim, alma 5 birim). Microsoft Graph, kiracı başına uygulama başına 10 dakikada 10.000 istekle sınırlar. Her ikisi de jitter ile üssel geri çekilme gerektiren 429 hataları döndürür. 1.000 bağlı hesapta, hız sınırı yönetimi tam bir mühendislik sorunu haline gelir.

Gmail250 kota birimi/sn/kullanıcı. Günlük üst sınır: 1 milyar birim
Grafik10.000 istek / 10 dakika / uygulama / kiracı. Retry-After başlığı
IMAP:Sağlayıcıya özgü, tipik olarak hesap başına 10-20 eşzamanlı bağlantı
05

Gerçek Zamanlı: Webhook'lar, Sorgulama (Polling) ve IDLE'a Karşı

Yeni bir e-posta geldiğinde bildirim almak, sağlayıcıya göre tamamen farklı mekanizmalar gerektirir. Gmail, her 7 günde bir yenilenmesi gereken Google Pub/Sub anlık bildirim aboneliklerini kullanır. Microsoft Graph, maksimum kullanım ömrü 4.230 dakika olan değişiklik bildirimi aboneliklerini kullanır. IMAP, hesap başına kalıcı bir TCP bağlantısı açık tutan IDLE komutunu kullanır.

GmailPub/Sub gönderme, 7 günlük geçici depolama, yenileme döngüsü gerektirir
GrafikchangeNotifications aboneliği, maks ~3 gün geçerlilik
IMAP:IDLE komutu, hesap başına 1 kalıcı TCP bağlantısı
06

Sağlayıcılar Arasında İplik Tutarsızlıkları

Gmail, iletileri yerel olarak iş parçacıklarına toplar. Microsoft Graph'ın bir conversationId alanı vardır ancak iş parçacıkları Gmail'den farklı davranır. IMAP'te yerel bir iş parçacığı yoktur - Referanslar ve Yanıt-Kime üstbilgilerini manuel olarak eşleştirerek iş parçacıklarını yeniden oluşturursunuz. Sağlayıcılar arası birleşik bir iş parçacığı görünümü oluşturmak önemli normalleştirme mantığı gerektirir.

GmailNative threadId, messages.list?labelIds=INBOX ile gönderilen istekler, ileti gruplarını döndürür.
GrafikconversationId, ancak Gmail konularıyla eşdeğer değil
IMAP:Message-ID / References başlıklarını manuel olarak ayrıştırmalıdır
Mimarlık

E-posta Okuma API Mimarisi: 3 Yaklaşım Karşılaştırması

E-posta okumak için tek bir "doğru" mimari yoktur. Doğru yaklaşım, kaç sağlayıcıyı desteklemeniz gerektiğine, mühendislik kaynaklarınıza ve ölçek gereksinimlerinize bağlıdır. İşte dürüst bir karşılaştırma.

Yaklaşım Artıları Tutmak Ne zaman kullanılacağını
Doğrudan sağlayıcı API'leri
Gmail API, Microsoft Graph		 Ücretsiz katman, tam özellik erişimi, aracısız gecikme Sağlayıcı başına OAuth kurulumu, MIME ayrıştırma, ayrı hız sınırı yönetimi, çapraz sağlayıcı normalizasyonu yok Yalnızca tek sağlayıcı
Kendi kendine barındırılan IMAP
imaplib, node-imap		 Evrensel protokol, tüm posta kutularıyla çalışır, OAuth uygulaması gerekmez Durum bilgisi olan TCP bağlantıları, anlık bildirim yok (sorgulama veya IDLE), bağlantı havuzu yönetimi, ölçekte yavaş Sadece legacy / şirket içi
Birleşik e-posta okuma API'si
Unipile		 Tüm sağlayıcılar için tek bir uç nokta, normalleştirilmiş JSON yanıtı, yönetilen OAuth, birleştirilmiş webhook'lar, yerleşik yeniden deneme mantığı Bağlı hesap başına ek API çağrısı maliyeti, harici bağımlılık Çoklu sağlayıcı ürünleri
Doğrudan sağlayıcı API'leri
Gmail API, Microsoft Graph
Artıları Ücretsiz katman, tam özellik erişimi, aracısız gecikme
Tutmak Sağlayıcı başına OAuth kurulumu, MIME ayrıştırma, ayrı hız sınırı yönetimi, çapraz sağlayıcı normalizasyonu yok
Ne zaman kullanılacağını Yalnızca tek sağlayıcı
Kendi kendine barındırılan IMAP
imaplib, node-imap
Artıları Evrensel protokol, tüm posta kutularıyla çalışır, OAuth uygulaması gerekmez
Tutmak Durum bilgisi olan TCP bağlantıları, anlık bildirim yok (sorgulama veya IDLE), bağlantı havuzu yönetimi, ölçekte yavaş
Ne zaman kullanılacağını Sadece legacy / şirket içi
Birleşik e-posta okuma API'si
Unipile
Artıları Tüm sağlayıcılar için tek bir uç nokta, normalleştirilmiş JSON yanıtı, yönetilen OAuth, birleştirilmiş webhook'lar, yerleşik yeniden deneme mantığı
Tutmak Bağlı hesap başına ek API çağrısı maliyeti, harici bağımlılık
Ne zaman kullanılacağını Çoklu sağlayıcı ürünleri
Tek sağlayıcı için en iyisi
Doğrudan Sağlayıcı API'si

Ürününüzdeki her kullanıcı Gmail kullanıyorsa, doğrudan Gmail API'sine karşı oluşturun. Tam özellik denkliği, ek bir maliyet olmaması ve etiketler, iş parçacıkları ve Pub/Sub anlık bildirimleri gibi Gmail'e özgü özelliklere erişim elde edersiniz.

Eski sistemler için en iyisi
Kendi kendine barındırılan IMAP

Şirket içi posta sunucuları, Graph API erişimi olmayan kurumsal Exchange dağıtımları veya OAuth'un mümkün olmadığı tüm senaryolar. Yeni ürünler için birincil strateji değil, yedek olarak IMAP kullanın.

SaaS ürünleri için en iyisi
Birleşik E-posta Okuma API'si

Kullanıcılarınızın Gmail, Outlook ve IMAP posta kutuları olduğunda ve bunların tümü için tutarlı bir okuma e-postası API'sine ihtiyaç duyduğunuzda, Unipile gibi birleşik bir katman, N-sağlayıcı entegrasyon sorununu tamamen ortadan kaldırır.

5 Dakikada Kurulum

Unipile'ın Birleştirilmiş E-posta Okuma API'si ile E-postaları Okuma

Unipile, Gmail API, Microsoft Graph ve IMAP'ı tek bir e-posta okuma API'si arkasında soyutlar. Kullanıcınızın posta kutusunun hangi sağlayıcıda olduğuna bakılmaksızın tek bir OAuth akışı, tek bir uç nokta, tek bir normalleştirilmiş JSON biçimi. İşte ilk gelen kutunuzu 5 dakikadan kısa sürede nasıl okuyabileceğiniz.

1
Barındırılan kimlik doğrulama bağlantısıyla bir kullanıcıyı kimlik doğrula

Unipile kontrol panelinizden barındırılan bir kimlik doğrulama URL'si oluşturun. Bu bağlantıyı kullanıcınıza gönderin - onlar Unipile'ın barındırılan sayfasında sağlayıcıları (Gmail, Outlook veya IMAP kimlik bilgileri) için OAuth izin akışını tamamlarlar. Sizin tarafınızda hiçbir OAuth uygulama kurulumu, yönlendirme URI yapılandırması gerekmez. Ayrıntıları görmek için Birleşik e-posta API kılavuzu tam kimlik doğrulama akışı için.

auth_link.sh
# Kullanıcınız için barındırılan bir kimlik doğrulama bağlantısı oluşturun kıvrıl -X POST \ "https://api3.unipile.com:PORT/api/v1/hosted/accounts/link" \ -H "X-API-ANAHTARI: SENIN_API_ANAHTARIN" \ -H "İçerik-Türü: uygulama/json" \ -d '{"type":"EMAIL","name":"user@example.com","success_redirect_url":"https://yourapp.com/connected"}' # Yanıtı: { "url": "https://auth.unipile.com/..." } # Bu URL'yi kullanıcınıza gönderin; kullanıcı, kendi sağlayıcısında OAuth işlemini tamamlar
2
Gelen kutusu e-postalarını listele - GET /api/v1/emails

Kullanıcı hesabını bağladıktan sonra, e-postalar uç noktasına onların bilgileriyle birlikte çağrı yapın. account_id. Yanıt, altta yatan posta kutusu Gmail, Outlook veya IMAP olsa da aynıdır.

list_emails.sh
# Gelen kutusundaki e-postaları listele (Gmail, Outlook ve IMAP ile uyumludur) kıvrıl -X GET \ "https://api3.unipile.com:PORT/api/v1/emails?account_id=ACCOUNT_ID&limit=50" \ -H "X-API-ANAHTARI: SENIN_API_ANAHTARIN" # Klasöre göre filtrele kıvrıl "...?account_id=ACCOUNT_ID&folder=INBOX&limit=50" -H "X-API-ANAHTARI: SENIN_API_ANAHTARIN" # Yalnızca okunmamışları filtrele kıvrıl "...?account_id=HESAP_ID&unread=true" -H "X-API-ANAHTARI: SENIN_API_ANAHTARIN"
200 OK - normalleştirilmiş JSON, tüm sağlayıcılar için aynı şekil
3
Tek bir e-posta al, gövde ve ekleri dahil

ID'ye göre tam bir e-posta alın. Unipile, düz metin gövdesi, HTML gövdesi ve ek meta verileri ile çözülmüş, normalize edilmiş bir nesne döndürür - sizin tarafınızdan herhangi bir MIME ayrıştırma gerektirmez.

e_posta_al.sh
# Tek bir e-postayı tam metin ve ekleriyle birlikte getir kıvrıl -X GET \ "https://api3.unipile.com:PORT/api/v1/emails/EMAIL_ID" \ -H "X-API-ANAHTARI: SENIN_API_ANAHTARIN" # Yanıt alanları (her zaman normalleştirilmiş): # { "id", "konu", "tarih", "gönderen_katılımcı", "alıcı_katılımcılar", # "gövde", "gövde_düz", "ekler": [{ "id", "dosya_adı", "boyut" }] }
4
Web kancaları aracılığıyla gerçek zamanlı yeni e-postalar alın

Unipile kontrol panelinizde bir webhook uç noktası kaydedin. Unipile, Gmail Pub/Sub, Microsoft Graph değişiklik bildirimleri ve IMAP IDLE'ı tek bir email.received etkinlik. Abonelik yenileme yok, yönetilecek HAZIRDA bekleyen bağlantı havuzu yok.

webhook_handler.js
// Unipile, yeni bir e-posta geldiğinde uç noktanızı çağırır // Gmail, Outlook ve IMAP kullanıcıları için aynı olay uygulama.POST('/webhooks/email', (req, res) => { const { olay, hesap_kimliği, eposta_kimliği } = req.body; eğer (olay === 'e-posta.alındı') { // Tüm e-posta ayrıntılarını getir YeniE-postaİşle(hesap_id, eposta_id); } res.DurumGönder(200); });
Bir webhook olayı, Gmail Pub/Sub + Graph abonelikleri + IMAP IDLE'ın yerini alır
Tam entegrasyon referansını mı istiyorsunuz?

Tam E-posta API Kılavuzu, kimlik doğrulama, tüm uç noktalar, sayfalama, ek indirme, güvenlik ve uyumluluk konularını ayrıntılı olarak ele almaktadır.

E-posta API Kılavuzu'nu Oku
Kod Örnekleri

E-posta Okuma: Dilde Kod Örnekleri

Unipile'ın birleşik e-posta okuma API'si ile e-posta okumak için üretime hazır örnek kodlar. Tüm örnekler, aynı kodla Gmail, Outlook ve IMAP hesaplarından okuma yapar.

Node.js / TypeScript
Python
Git
readEmails.ts
İthalat fetch itibaren 'node-fetch'; const TABAN = 'https://api3.unipile.com:PORT/api/v1'; const API_ANAHTARI = process.env.UNIPILE_API_KEY!; arayüz E-posta { kimlik: dizi; Konu: dizi; tarih: dizi; katılımcıdan: { görünen_ad: dizi; tanımlayıcı: dizi }; body: dizi; gövde_düz dizi; ekler: { id: dizi; dosya adı: dizi; boyut Sayı }[]; } // Gelen kutusu e-postalarını listele - Gmail, Outlook ve IMAP için çalışır async function E-postaları listele(hesapId: dizi, sınır = 50) { const Res = bekliyor fetch( `${BASE}/emails?account_id=${accountId}&limit;=${limit}&folder;=INBOX`, { başlıklar: { 'X-API-ANAHTARI'API_ANAHTARI } } ); const veri = bekliyor res.json(); return data.öğeler olarak E-posta[]; } // Tam gövde + eklerle tek bir e-posta alın async function E-postayıAlemail kimliği: dizi) { const Res = bekliyor fetch(`${BASE}/emails/${emailId}`, { başlıklar: { 'X-API-ANAHTARI'API_ANAHTARI } } ); return bekliyor res.json() arası E-posta; } // Kullanım const e-postalar = bekliyor E-postaları listele('acc_01abc...'); e-postalar.her biri için(e => konsol.log(e.konu, e.katilan.kimlik));
JavaScript için Tam E-posta API Kılavuzu
read_emails.py
İthalat işletim sistemi İthalat istekleri TABAN = "https://api3.unipile.com:PORT/api/v1" ÜST BILGILER = {"X-API-ANAHTAR"os.environ["UNIPILE_API_ANAHTARI"]} fonksiyon e-postaları_listele(hesap_kimliği: str, sınır: int = 50) -> liste: "Kutudaki e-postaları listele - Gmail, Outlook ve IMAP için çalışır." cevap = istemler.olsun( {TEMEL}/e-postalar", headers=HEADERS, parametresi={ "hesap_kimliği": hesap_kimliği, "sınır"sınır, "klasör": "GELEN KUTUSU", }, ) yanıt olarak.raisen_for_status() return yanıt olarak.json()["eşyalar"] fonksiyon e-postayı_al(email_id: str) -> dict: "Bir e-postayı gövdesi ve ekleriyle birlikte çekin." cevap = istemler.olsun({TEMEL}/e-postalar/{e-posta_kimliği}", üstbilgiler=ÜSTBILGILER) yanıt olarak.raisen_for_status() return yanıt olarak.json() # Kullanım e-postalar = e-postaları_listele("acc_01abc...") için e-posta içinde e-postalar print(e-posta"konu"], e-posta["katılımcıdan"]["tanımlayıcı"]) # İlk e-posta için tam metni getir tam = e-postayı_al(e-postalar[0]["kimlik"]) printTam"gövde_düz"])
Python için E-posta API'si Kılavuzu
read_emails.go
paket ana İthalat ( "kodlama/json" "format" "net/http" "os" ) tip E-posta yapı { KIMLIK dizi `json:"id"` Konu dizi `json:"konu"` VücutDüz dizi `json:"gövde_düz"` } tip ListeCevabı yapı { Nesneler []E-posta `json:"öğeler"` } fonksiyon E-postaları listele(accountID string) ([]E-posta, hata) { url := "https://api3.unipile.com:PORT/api/v1/emails?account_id=" + hesapID istek, _ := http.YeniTalep("AL", url, nil) req.Header.Küme("X-API-ANAHTAR", işletim sistemi.Ortam değişkenini al("UNIPILE_API_ANAHTARI")) cevap, hata := http.DefaultClient.Yapmak(talep) eğer hata != nil { return nil, hata } ertelemek resp.Body.Kapat() var sonuç ListeCevabı json.Yeni kodlayıcı(resp.Gövde).Çöz(&result) return sonuç.Öğeler, nil } fonksiyon ana() { e-postalar, := E-postaları listele("acc_01abc...") için _, e := menzil e-postalar { fmt.Yazdır(e.Konu) } }
Gerçek Zamanlı

Gerçek Zamanlı E-posta Okuma: Webhook'lar ve Sorgulama

Yeni bir e-postanın ne zaman geldiğini bilmek, onu okuyabilmek kadar önemlidir. Ölçekte çok farklı operasyonel özelliklere sahip üç mekanizma mevcuttur.

Ölçekte önle

Oylama

Uygulamanız zaman zaman (her 30 saniyede bir, her 5 dakikada bir) e-postaları listeleyen uç noktayı çağırır. Uygulaması basittir ancak kotayı tüketir, gecikme ekler ve birkaç hesaptan fazlası için ölçeklenmez.

Basit - sunucu tarafı kurulumu yok
Mevcut hesap sayısına ve sıklığa göre orantılı olarak API kotasını yakma
5 dakikalık anket = 5 dakikalık bildirim gecikmesi
~100 aktif hesaptan ötesine ölçeklenmez
Sağlayıcıya özel

Yerel Sağlayıcı Webhook'ları

Gmail Pub/Sub ve Microsoft Graph değişiklik bildirimleri, olayları anında sunucunuza gönderir. Hızlı ve kota açısından verimli olmalarına rağmen, her biri ayrı kurulum, ayrı yenileme mantığı ve farklı olay şemaları gerektirir.

Saniyeler içinde teslimat (çok hızlı teslimat)
Kota verimli - yalnızca yeni e-postalarda tetiklenir
Gmail: Pub/Sub aboneliği her 7 günde bir sona eriyor
Grafik: abonelik maks ~3 gün, yenilenmeli
IMAP IDLE: Hesap başına 1 TCP bağlantısı
Tavsiye edilir

Unipile Birleşik Webhooklar

Unipile, tüm sağlayıcı anlık iletim mekanizmalarını tek bir arayüzde soyutlar email.received etkinlik. Bir uç nokta, Gmail, Outlook ve IMAP hesaplarından gelen bildirimleri alır; otomatik abonelik yenileme ise dahili olarak halledilir.

Tüm sağlayıcılar için tek webhook URL'si
Otomatik Yayınla/Abone Ol ve Grafik Yenileme
Her hesap için IMAP IDLE dahili olarak yönetiliyor
Normalleştirilmiş yük - her zaman aynı alanlar
Unipile'ın gerçek zamanlı e-posta gönderimini nasıl soyutladığı

Unipile arka planda, Gmail Pub/Sub aboneliklerini, Microsoft Graph değişiklik bildirimi aboneliklerini ve IMAP IDLE bağlantılarını - bağlı hesap başına, otomatik olarak yenilenen bir şekilde yönetir. Uygulamanız bir webhook URL'si kaydeder ve temel sağlayıcıdan bağımsız olarak tek bir normalleştirilmiş olay alır.

Gmail Pub/Sub
+
Grafik Abonelikleri
+
IMAP BOŞTA
->
e-posta.alındı olayı
Güvenlik ve Uyumluluk

Kullanıcı E-postalarını Okurken Güvenlik ve Uyumluluk

Kullanıcı e-postalarına erişim, önemli güvenlik ve yasal sorumluluklar taşır. E-posta okuma API entegrasyonunu üretime almadan önce ele almanız gereken dört alan şunlardır:.

OAuth Kapsam En Azlatılması

Her zaman gerekli minimum OAuth kapsamını isteyin. E-postaları okumak için, salt okunur kapsamlar Uygulamanız yalnızca gelen kutusu erişimine ihtiyaç duyuyorsa asla gönder veya oluştur izinleri istemeyin. Gmail salt okunur kapsamı gmail.yalnızcaoku. Microsoft Graph'ın eşdeğeri Mail.Read. Geniş kapsamlar istemek, Google ve Microsoft'un daha katı inceleme süreçlerini tetikler ve izin ekranında kullanıcı güvenini azaltır.

Token Saklama En İyi Uygulamalar

OAuth erişim belirteçleri ve yenileme belirteçleri kimlik bilgileridir. Bunları saklayın beklemede şifrelenmiş AES-256 veya eşdeğerini kullanarak, veritabanınızda asla düz metin kullanmayın. Şifreleme anahtarlarını programlı olarak değiştirin. Token'ları asla uygulama günlüklerine kaydetmeyin. Bir kullanıcı hesabını kapattığında token'ları iptal edin - veritabanı kaydını basitçe silmek yerine sağlayıcının iptal uç noktasını çağırın.

GDPR ve Veri Yerleşimi

E-posta gövdeleri genellikle GDPR kapsamına giren kişisel veriler içerir. Gizlilik politikanızda hangi e-posta verilerini topladığınızı, sakladığınızı, işlediğinizi ve ne kadar süreyle sakladığınızı tam olarak belgelendirmelisiniz. Bir kullanıcının silme talebinde bulunması üzerine e-posta içeriğini kaldıran bir veri silme akışı uygulayın. E-posta içeriğini kendi altyapınızda saklıyorsanız, AB müşterileri için veri ikamet gereksinimlerini göz önünde bulundurun.

Google CASA ve Microsoft Publisher Doğrulaması

Hassas Gmail kapsamlarını isteyen uygulamalar ( gmail.yalnızcaokuGoogle'ı tamamlamanız gerekir CASA Seviye 2 Microsoft, belirli Graph kapsamlarını isteyen uygulamalar için Yayıncı Doğrulaması gerektirir. Her iki süreç de haftalar sürer - bu nedenle lansman tarihinizi dikkate alarak planlama yapın. Unipile kullanmak, bu sertifikaları platform katmanından miras alır.

Unipile uyumluluk sertifikaları

Unipile, platform düzeyinde Gmail CASA Seviye 2 sertifikasını, Microsoft Publisher Doğrulamasını, SOC 2 Tip II denetimini ve GDPR veri işleme sözleşmelerini yönetir. Unipile üzerine inşa edilen ürünler, bunları bağımsız olarak tamamlamak yerine bu sertifikaları miras alır.

SOC 2 Tip II
Google CASA Seviye 2
GDPR Uyumlu
OAuth 2.0 Salt Okunur Kapsamları
Fiyatlandırma

E-posta Okuma API Fiyatlandırması: Ücretsiz Katmanlar ve Maliyet Modelleri

Yerel sağlayıcı API'lerinin ücretsiz katmanları düşük ölçekte cömerttir, ancak birden fazla sağlayıcıyı desteklemeniz, büyük hacimlerde jeton yenilemesini yönetmeniz veya hız sınırı tavanlarına ulaşmanız gerektiğinde gizli maliyetler ortaya çıkar. İşte dürüst bir dökümü.

Sağlayıcı Ücretsiz katman Maliyet modeli İstek sınırı Gizli maliyetler
Gmail API Kontenjanla birlikte ücretsiz İstek başına kota birimleri. Hesap başına faturalandırma yok 250 birim/sn/kullanıcı, 1 Milyar birim/gün CASA Seviye 2 incelemesi, MIME ayrıştırma, Pub/Sub yenileme mantığı
Microsoft Graph Kısıtlamalı ücretsiz Microsoft 365 kiracısı ile birlikte gelir. Çağrı başına ücret yoktur 10.000 istek/10 dakika/uygulama/kiracı Yayıncı Doğrulama süreci, abonelik yenileme, kiracı başına OAuth uygulamaları
IMAP (kendi barındırdığınız) Ücretsiz Protokol API maliyeti yok. Bağlantı havuzları için altyapı maliyeti Sağlayıcıya özel, hesap başına yaklaşık 10-20 bağlantı Sunucu altyapısı, IDLE bağlantı yönetimi, itme desteği yok
Unipile 7 günlük ücretsiz deneme Aylık bağlantılı hesap başına. Gör ücretsiz e-posta API katmanı Dahili olarak yönetilen, yerleşik yeniden deneme mantığı Her hesap başına API çağrı maliyeti - ortadan kaldırılan OAuth/MIME mühendisliği ile dengelenmiş
Gmail API
Kontenjanla birlikte ücretsiz
Maliyet modeli İstek başına kota birimleri. Hesap başına faturalandırma yok
İstek sınırı 250 birim/sn/kullanıcı, 1 Milyar birim/gün
Gizli maliyetler CASA Seviye 2 incelemesi, MIME ayrıştırma, Pub/Sub yenileme mantığı
Microsoft Graph
Kısıtlamalı ücretsiz
Maliyet modeli Microsoft 365 kiracısı ile birlikte gelir. Çağrı başına ücret yoktur
İstek sınırı 10.000 istek/10 dakika/uygulama/kiracı
Gizli maliyetler Yayıncı Doğrulama süreci, abonelik yenileme, kiracı başına OAuth uygulamaları
IMAP (kendi barındırdığınız)
Ücretsiz Protokol
Maliyet modeli API maliyeti yok. Bağlantı havuzları için altyapı maliyeti
İstek sınırı Sağlayıcıya özel, hesap başına yaklaşık 10-20 bağlantı
Gizli maliyetler Sunucu altyapısı, IDLE bağlantı yönetimi, itme desteği yok
Unipile
7 günlük ücretsiz deneme
Maliyet modeli Aylık bağlantılı hesap başına. Gör ücretsiz e-posta API katmanı
İstek sınırı Dahili olarak yönetilen, yerleşik yeniden deneme mantığı
Gizli maliyetler Her hesap başına API çağrı maliyeti - ortadan kaldırılan OAuth/MIME mühendisliği ile dengelenmiş

Ücretsiz okuma e-posta API'si ile mi başlıyorsunuz? Gmail API ve Microsoft Graph, her ikisi de kota sınırları dahilinde ücretsiz erişim sunar. Unipile, Gmail, Outlook ve IMAP ile bağlı hesapları kapsayan, kredi kartı gerektirmeyen 7 günlük bir deneme sürümü sunar.

Ücretsiz denemeyi başlat
Yaygın Tuzaklar

Okunmuş E-posta Entegrasyonu Oluştururken Sık Yapılan Hatalar

İlk okunan e-posta API entegrasyonunu yayınlayan ekiplerin üretimde sürekli aksamalara yol açan hataları bunlardır. Bunlara çarpmadan önce öğrenin.

01
Gmail'de ölçekte kota aşımı

Gmail'in hesap başına saniyede 250 kota birimi, 500 hesabınız olduğunda ve ilk gelen kutusu senkronizasyonunu yapmanız gerektiğinde cömert gelse de, aslında durum böyle değildir. 500 mesaj listelemek 2.500 birim, her bir tam mesajı almak ise 2.500 birim daha gerektirir. Büyük posta kutuları için ilk senkronizasyonlar saatler içinde günlük kotayı tüketebilir.

Düzelt: 429 yanıtlarında üssel geri çekilme uygulayın, ilk senkronizasyon için son mesajları önceliklendirin ve çağrı başına ek yükü azaltmak için mevcut olduklarında toplu istekleri kullanın.
02
Sessiz token yenileme hataları

OAuth yenileme belirteçleri sessizce süresi dolar - Google bunları 6 aylık hareketsizlikten, şifre değişikliğinden sonra veya kullanıcı Google Hesabı ayarlarından erişimi iptal ettiğinde geçersiz kılar. Belirteç yenileme mantığınız bir 401 hatası algılamaz ve bunu kullanıcıya sunmazsa, uygulamanız görünür bir hata olmadan e-postaları okumayı durduracaktır.

Düzelt: 401 yanıtlarını hesap bağlantısı kesilme olayları olarak ele alın. Kullanıcıyı bilgilendirin ve yeniden kimlik doğrulama isteyin. Bir son_senkronizasyon_zamanı zaman damgası ve beklediğiniz senkronizasyon aralığını aştığında uyarı ver.
03
Yanlış klasör filtreleri nedeniyle eksik e-postalar

Gmail etiketleri ve IMAP klasörleri eşdeğer kavramlar değildir. Gmail'in KUTU İÇİ Bu etiket, arşivlenmiş (Gelen Kutusu'ndan kaldırılmış ancak silinmemiş) mesajları içermez. Microsoft Graph'ın Gelen Kutusu klasörü, her ikisini de sorgulamadığınız sürece, odaklanmış gelen kutusu ile diğer bölme düzenlerini hariç tutar. Teams kullanıcıları, klasör varsayımlarındaki uyuşmazlıklar nedeniyle genellikle 20-40% mesajının eksik olduğunu fark ederler.

Düzelt: Arşivlenmiş, filtrelenmiş ve kategorize edilmiş mesajlar dahil gerçek hesaplarla klasör sorgularınızı test edin. Kapsamlı senkronizasyon için, sorgulamayı düşünün HEPSİ Sizin tarafınızdan gelen mesajları (sadece GELEN KUTUSU değil) ve tarihe göre filtreleme.
04
Uluslararası e-postalarda kodlama hataları

E-posta gövdeleri çok çeşitli karakter kodlamalarında gelir: UTF-8, ISO-8859-1, Windows-1252, Shift-JIS. Gmail base64url kodlu parçalar döndürür. IMAP quoted-printable kodlu parçalar döndürür. Bir kodlamayı başka bir kodlama olarak çözmek, yerel test ortamınızda (muhtemelen yalnızca ASCII e-postaları gönderen) görünmez bozuk gövde metnine neden olur.

Düzelt: Her zaman MIME bölümlerini kendi İçerik-Aktarım-Kodlaması ve UTF-8 olarak yeniden kodlayın. Özellikle Japonca, Arapça ve emoji yoğunluklu e-posta içerikleriyle test edin.
05
Sağlayıcılar arasında iş parçacığı tutarsızlıkları

Gmail, Outlook ve IMAP hesaplarında birleşik bir ileti görünümü oluşturmak, tamamen farklı üç iş parçacığı modelini normalleştirmeyi gerektirir. Gmail'in yerel ileti kimlikleri vardır. Outlook'un farklı çalışan konuşma kimlikleri vardır. IMAP'in yerel bir iş parçacığı yoktur - ileti dizilerini yeniden oluşturursunuz Mesaj Kimliği, Referanslarve Yanıt-Kime her zaman mevcut veya doğru olmayan üstbilgiler.

Düzelt: Unipile gibi birleşik bir e-posta okuma API'si, sağlayıcıya özel iş parçacığı yeniden oluşturma mantığını uygulama ihtiyacını ortadan kaldırarak, iş parçacıklarını tüm sağlayıcılarda tutarlı bir modele dönüştürür.
SSS

E-posta Oku API - Sıkça Sorulan Sorular

İlk okuma e-postası API entegrasyonunu oluşturan geliştiricilerin en sık sorduğu sorular.

01
E-posta okuma API'si nedir?
A e-posta oku API'si Uygulamanızın bir kullanıcının mevcut posta kutusuna (OAuth 2.0 veya IMAP kimlik bilgileri aracılığıyla) kimlik doğrulaması yapmasını ve e-posta iletilerini programlı olarak almasını sağlayan bir HTTP arayüzüdür. Kontrol ettiğiniz bir alan adından gelen giden e-postaları gönderen SendGrid veya Mailgun gibi işlemsel e-posta API'lerinden farklıdır. E-posta okuma API'leri kullanıcının kendi Gmail, Outlook veya IMAP hesabı üzerinde çalışır. Bkz. E-posta API Sağlayıcılarının Tam Karşılaştırması daha geniş ekosistem hakkında bağlam.
02
Bir API aracılığıyla başkasının e-postasını okuyabilir miyim?
E-postaları yalnızca posta kutusu sahibinin OAuth 2.0 onayı yoluyla uygulamanıza erişim izni verdiği hesaplardan okuyabilirsiniz. Kullanıcı, Google veya Microsoft'un onay ekranında uygulamanızı yetkilendirmelidir. Hesap sahibinin izni olmadan e-postalara erişemezsiniz - bunu denemek çoğu yargı alanında sağlayıcı hizmet şartlarını ve geçerli yasaları ihlal eder.
03
Gmail API'yi kullanarak e-postaları nasıl okuyabilirim?
Gmail API'yi kullanarak e-postaları okumak için: bir Google Cloud projesi oluşturun, Gmail API'sini etkinleştirin, bir OAuth 2.0 istemcisi yapılandırın, gmail.yalnızcaoku kapsam, OAuth onayı aracılığıyla bir erişim belirteci al, sonra çağır GET /gmail/v1/kullanıcılar/ben/mesajlar mesajları listelemek ve GET /users/me/messages/{id}?format=tam tek tek e-postaları almak için. Mesajlar, çözmeniz gereken base64url kodlu MIME parçaları olarak döndürülür.
04
IMAP ve Gmail API arasındaki fark nedir?
Gmail API, OAuth 2.0, Google Pub/Sub aracılığıyla anlık bildirimler ve JSON yanıtları ile modern bir REST API'dir. IMAP, durum bilgisel bağlantıları ve metin komutlarını kullanan ve her e-posta sağlayıcısı tarafından desteklenen evrensel bir TCP protokolüdür. Gmail API, yalnızca Gmail kullanım durumları için (gerçek zamanlı anlık iletim, iş parçacığı erişimi, etiket yönetimi) daha yeteneklidir. IMAP, tüm sağlayıcılarda evrensel kapsama alanı sağlar ancak yoklama veya IDLE bağlantıları gerektirir ve yerel bir REST arayüzü yoktur. Bizi okuyun IMAP API entegrasyon kılavuzu daha derin bir karşılaştırma için.
05
Ücretsiz e-posta okuma API'si var mı?
Evet. Gmail API, Google'ın kota sınırları dahilinde (250 birim/sn/kullanıcı, 1 milyar birim/gün) ücretsizdir. Outlook için Microsoft Graph, sınırlamalarla birlikte ücretsizdir. IMAP ücretsiz bir açık protokoldür. Çoklu sağlayıcı desteği için Unipile, Gmail, Outlook ve IMAP bağlantılı hesapları kapsayan 7 günlük ücretsiz deneme sürümü sunar. Bizim şunları görün Ücretsiz e-posta API kılavuzu Ücretsiz katmanların ve bunların gerçek dünya limitlerinin tam bir karşılaştırması için.
06
Birden fazla sağlayıcıdan e-postaları tek bir API ile nasıl okuyabilirim?
Unipile gibi birleşik bir e-posta okuma API'si kullanın. Unipile, tek bir uç nokta sunar (GET /api/v1/e-postalar) aynı Gmail, Outlook ve IMAP hesapları için normalize edilmiş JSON döndüren. Barındırılan bir OAuth bağlantısı aracılığıyla kullanıcıları bir kez kimliklersiniz ve Unipile, tek, tutarlı bir arayüzün arkasında sağlayıcıya özel OAuth akışlarını, MIME ayrıştırmayı ve gerçek zamanlı webhook soyutlamasını yönetir. Bizimkini görün E-posta API Kılavuzu tam inceleme için.
07
E-posta eklerini API aracılığıyla okuyabilir miyim?
Evet. Gmail API, ek meta verilerini ileti yükünde döndürür ve ek verilerini kimliğe göre indirmek için ayrı bir uç nokta sağlar. Microsoft Graph, ekleri şu yolla döndürür /messages/{id}/attachments. IMAP, ek dosya bölümlerini belirlemek için MIME ağacını ayrıştırmayı gerektirir. Unipile ile ek dosya meta bilgileri (dosya adı, boyut, MIME türü) e-posta yanıtına dahil edilir ve ek dosya içeriği özel bir uç nokta aracılığıyla kullanılabilir - MIME ayrıştırma gerekmez.
08
Yeni bir e-posta geldiğinde nasıl bildirim alırım?
Her sağlayıcının farklı bir mekanizması vardır: Gmail, Google Pub/Sub gönderim aboneliklerini kullanır (7 günde bir sona erer, yenileme gerektirir). Microsoft Graph, değişiklik bildirim aboneliklerini kullanır (yaklaşık 3 gün sonra sona erer). IMAP, kalıcı bir TCP bağlantısı üzerinden IDLE komutunu kullanır. Alternatif olarak Unipile, üçünü tek bir... email.received Gmail, Outlook ve IMAP hesapları için webhook olayı, otomatik abonelik yönetimi dahili olarak halledilir.
09
Gmail ve Outlook'ta e-posta okuma limitleri nelerdir?
Gmail API: Kullanıcı başına saniyede 250 kota birimi. Mesajları listelemek 5 birim, tam bir mesaj getirmek 5 birimdir. Günlük limit 1 milyar kota birimidir. Microsoft Graph: Uygulama başına kiracı başına 10 dakikada 10.000 istek. Her ikisi de aşırı yüklendiğinde HTTP 429 döndürür, ilave olarak Yeniden Dene Sonra Üretim güvenilirliği için titreşimli üssel geri çekilme uygulayın. IMAP limitleri sağlayıcıya özgüdür, genellikle hesap başına 10-20 eşzamanlı bağlantı.
10
Bir API aracılığıyla kullanıcı e-postalarını okumak GDPR uyumlu mudur?
API aracılığıyla kullanıcı e-postalarını okumak, doğru şekilde uygulandığında KVKK uyumlu olabilir. Gereklilikler şunları içerir: OAuth aracılığıyla açık kullanıcı rızası (rıza ekranı yasal dayanak gereksinimini karşılar), topladığınız ve sakladığınız e-posta verilerini belgeleyen bir gizlilik politikası, silme talepleri için bir veri silme mekanizması ve kullandığınız üçüncü taraf API katmanıyla bir veri işleme sözleşmesi. Unipile, SOC 2 Tip II sertifikalı ve GDPR uyumludur, platform üzerinde oluşturulan ürünler için uyumluluk belgelerini basitleştirerek.

Hala sorularınız mı var? Gmail, Outlook ve IMAP'te büyük ölçekte okuma e-postası API entegrasyonları yapmış bir geliştiriciyle konuşun.

Bir uzmanla konuşun
tr_TRTR
en_USEN fr_FRFR es_ESES de_DEDE it_ITIT pt_BRBR nl_NLNL pl_PLPL tr_TRTR