1. Produk
  2.   E-mel
  3.   Ruby
  4.   Postal
 
  

API Ruby Sumber Terbuka untuk Semak Penjejakan E-mel & Status Penghantaran

Postal adalah API Mel dan Platform Penghantaran Berfitur Penuh yang Direka untuk Mengendalikan E-mel Masuk dan Keluar bagi Laman Web, Aplikasi serta Semak Penjejakan E-mel & Status Penghantaran.

Apakah Perpustakaan Postal?

Dalam landskap digital masa kini, komunikasi e-mel yang berkesan menjadi lebih penting daripada sebelumnya. Sama ada anda menghantar e-mel transaksi, kempen pemasaran, atau notifikasi rutin, platform penghantaran e-mel yang boleh dipercayai dan boleh diskala adalah penting. Walaupun perkhidmatan proprietari seperti SendGrid dan Mailgun menguasai pasaran, alternatif sumber terbuka yang berkuasa sedang menonjol: Postal. Gem Ruby Postal adalah perpustakaan klien Ruby yang diselenggara oleh komuniti yang menyediakan antara muka untuk menggunakan platform penghantaran e-mel Postal. Ia membolehkan aplikasi Ruby (dan Rails) berintegrasi dengan Postal melalui API HTTPnya. Ia direka khas untuk pemaju Ruby. Ia tidak hanya membungkus titik akhir API; ia menyediakan antara muka berorientasikan objek yang terasa semula jadi dalam konteks Ruby.

Postal adalah platform penghantaran mel lengkap, berfitur penuh, sumber terbuka untuk laman web dan pelayan web. Anggap ia sebagai SendGrid atau Mailgun peribadi anda, yang berjalan pada pelayan anda sendiri. Ini memberi anda kawalan penuh ke atas penghantaran e-mel, data, dan reputasi anda. Dibangunkan dengan Ruby dan disokong oleh set teknologi yang kukuh, Postal direka untuk prestasi, kebolehskalaan, dan kemudahan penggunaan. Ia menyediakan antara muka web komprehensif untuk mengurus pelayan mel anda, melihat log, dan menjejaki prestasi, sambil menawarkan API yang kuat untuk integrasi lancar dengan aplikasi anda.

Previous Next

Mula Menggunakan Postal

Cara paling mudah untuk memasang perpustakaan Postal ialah melalui RubyGems. Sila gunakan perintah berikut untuk pemasangan yang mudah.

Pasang Postal melalui Rubygems

 gem install 'postal-ruby'

Menghantar E-mel Asas melalui API Ruby

API Postal sumber terbuka telah menyertakan sokongan lengkap untuk menghantar mesej e-mel dalam pelbagai cara. Pemaju Ruby boleh menghantar e-mel dalam pelbagai cara, menyesuaikan dengan tahap kerumitan yang berbeza. Simple Hash adalah sempurna untuk penghantaran cepat dengan parameter asas. Teks biasa dan HTML boleh digunakan untuk menghantar e-mel berbilang bahagian. Ia juga menyokong lampiran fail dengan mudah ke dalam mesej e-mel anda dan sebagainya. Contoh berikut menunjukkan cara paling mudah untuk menghantar e-mel.

Bagaimana untuk Menghantar E-mel Ringkas menggunakan API Ruby?

# Create a client instance
client = Postal::Client.new

# Send a message using a hash of parameters
message = client.send_message(
  from: 'noreply@yourdomain.com',
  to: 'customer@example.com',
  subject: 'Welcome to Our Service!',
  body: 'Thank you for signing up. We are excited to have you on board.'
)

# The response contains the message ID, which you can use for tracking
puts "Message sent! ID: #{message.message_id}"

Semak Penjejakan E-mel & Status Penghantaran

Pantau pembukaan e-mel dan klik untuk menilai keberkesanan kempen anda. API Postal menyediakan fungsi lengkap untuk menjejak mesej e-mel anda dalam aplikasi Ruby. Selepas menghantar e-mel, anda boleh menggunakan message_id yang dikembalikan untuk memeriksa status semasanya. Pantau pembukaan e-mel dan klik untuk menilai keberkesanan kempen anda. Contoh berikut menunjukkan cara memeriksa Status Penghantaran Mesej E-mel menggunakan arahan Ruby.

Bagaimana untuk Memeriksa Status Penghantaran Mesej E-mel melalui API Ruby?

# Assume you've stored the message_id from the send operation
stored_message_id = '01G5XYZABCDEF1234567890'

# Get the message details from Postal
message_details = client.get_message(stored_message_id)

# Check the delivery status
puts "Message Status: #{message_details.status}"

# Inspect the raw message (as received by the destination server)
puts "Raw Message: #{message_details.raw_message}"

# Check if the email has been opened
if message_details.opens.any?
  puts "The email was opened #{message_details.opens.count} time(s)."
end

Menghantar E-mel HTML Kaya dengan Lampiran

E-mel moden selalunya memerlukan pemformatan HTML dan lampiran. API e-mel Postal sumber terbuka memudahkan pembangun perisian untuk mencipta dan menghantar mesej E-mel HTML Kaya daripada aplikasi Ruby mereka. Amalan terbaik ialah sentiasa menyertakan versi teks biasa untuk klien e-mel yang tidak menyokong HTML. Anda boleh menghantar satu tatasusunan objek File untuk melampirkan dokumen, imej, dll. Berikut ialah contoh kod yang sangat berguna yang menunjukkan bagaimana pembangun perisian dapat mencipta dan menghantar mesej e-mel HTML dengan lampiran menggunakan API Ruby.

Bagaimana untuk Menghantar E-mel HTML Kaya dengan Lampiran melalui API Ruby?

client = Postal::Client.new

message = client.send_message(
  from: 'orders@yourdomain.com',
  to: 'customer@example.com',
  subject: 'Your Order Confirmation #12345',
  html_body: File.read('path/to/order_confirmation.html'), # Load HTML from a file
  plain_body: 'Thank you for your order. Your order number is #12345.', # Fallback text
  attachments: [
    File.open('/path/to/invoice_12345.pdf') # Attach a file
  ]
)

puts "Rich email sent with attachment! ID: #{message.message_id}"
 Melayu