mila API'si için tipli bir istemci
@vennyx/mila, mila'nın tüm REST API'sini tipli metodlarla sarar -- artık istek elle kurmaya, durum kodu ayrıştırmaya veya ek dosyaları kendiniz base64'e çevirmeye gerek yok.
Kurulum
npm install @vennyx/mila
Tek paket, sıfır yapılandırma
Hızlı kullanım
import { MilaClient } from '@vennyx/mila';
const client = new MilaClient({ apiKey });
await client.emails.send({ from, to, subject, text });İlk satırdan itibaren tipli
Düz fetch()'e göre kazandıklarınız
Her istek ve yanıt uçtan uca tipli -- domainlerden tek bir mailbox alanına kadar. Her 2xx-olmayan yanıt, durum kodlarını ve hata gövdelerini elle ayrıştırmak zorunda bırakmadan tek bir MilaApiError fırlatır. Ek dosya göndermek de sadece bir Buffer -- SDK, mila API'sinin tel üzerinde gerçekten beklediği base64 kodlamayı sizin için hallediyor.
Her kaynak, tek bir istemci
REST API'nin sunduğu sekiz kaynağın hepsi için client.<kaynak>.<method>().
domains
Domainlerinizi listeleyin, inceleyin ve ekleyin -- create, dnsRecords, diagnostics ve activate, alan adı ekleme yaşam döngüsünün tamamını kapsar.
mailboxes
Bir domainde mailbox oluşturun, güncelleyin, listeleyin ve silin.
aliases
Bir veya birden fazla hedefe yönlendiren ek adresler.
catchall
Domain genelinde bir catch-all hedefi ayarlayın veya kaldırın.
rewrites
Desene dayalı local-part yeniden yazma kuralları.
identities
Bir mailbox üzerinde gönderen-olarak-görün/yanıtla kimlikleri.
forwardings
Alıcı tarafından onaylanan harici yönlendirme kuralları.
emails
Ek dosyalarla mail gönderin -- bir Buffer geçirin, gerisini SDK halleder.
Kurun ve başlayın
Kurulum ve kimlik doğrulama
Paketi kurun, ardından panelde Hesap > API Anahtarları'ndan aldığınız bir API anahtarıyla tek bir istemci oluşturun. Varsayılan olarak https://api.mila.cx'e konuşur -- geçersiz kılmak için baseUrl geçin.
Hata yönetimi
Her 2xx-olmayan yanıt, gerçek HTTP durum kodunu ve yanıt gövdesini taşıyan bir MilaApiError fırlatır, böylece kendiniz bir şey ayrıştırmak yerine err.status üzerinden dallanabilirsiniz.
Gereksinimler
Yalnızca Node.js -- ek dosya kodlaması Buffer'a dayanır, bu yüzden paket olduğu haliyle bir tarayıcıda veya edge runtime'da çalışmaz.
Gerçek HTML e-posta mı gönderiyorsunuz? @vennyx/mila-react-template ile eşleştirin
Outlook, Gmail ve Apple Mail'de gerçekten bozulmadan görünen e-posta üretmek için ayrı, bulletproof bir React component kütüphanesi -- Outlook-güvenli butonlar, doğru dark-mode davranışı ve sizin için otomatik üretilen eşleşen bir düz-metin sürümü. Kutudan çıktığı gibi iki dilli (Türkçe/İngilizce).
Kurulum
npm install @vennyx/mila-react-template
Bu SDK'nın emails.send()'iyle birlikte çalışır
Hemen başlayın
Bir mila hesabı oluşturun veya REST öncelikli bir anlatım için tam API ve MCP kılavuzunu okuyun.