#Empat langkah
- Buat akun di halaman Get started. Anda langsung di paket Free: tanpa kartu, sampai 100 email per hari (sekitar satu menit).
- Di dashboard, tambahkan domain pengirim lalu pasang tiga catatan DNS CNAME yang tampil. Statusnya menjadi Verified setelah DNS ditemukan, dari beberapa menit sampai sehari. Di Cloudflare, awannya harus abu-abu (DNS only).
- Buat API key di dashboard. Key hanya tampil sekali: simpan di variabel lingkungan NEXDELIV_KEY di server Anda, jangan di aplikasi seluler atau halaman web.
- Kirim email dengan permintaan di bawah.
Sebelum mulai, halaman Cek domain di situs ini bisa memeriksa apakah domain Anda siap.
#Kirim email pertama
POST/v1/email
curl -X POST https://api.nexdeliv.com/v1/email \
-H "Authorization: Bearer $NEXDELIV_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "Toko Anda <[email protected]>",
"to": "[email protected]",
"subject": "Kode verifikasi Anda",
"text": "Kode verifikasi Anda 482913. Berlaku 10 menit."
}'Alamat di from harus berada di domain yang sudah Verified. Jawaban 202 berarti email diterima untuk dikirim, dan isinya memuat id pesan. Hasil akhirnya, terkirim atau bounce, dilaporkan lewat webhook.
#Error yang akan Anda temui
| Status | error | Artinya dan yang dilakukan |
|---|---|---|
| 401 | unauthorized | Key hilang, salah, atau dimatikan. Periksa NEXDELIV_KEY. |
| 403 | from_not_allowed | Alamat from tidak berada di domain akun Anda yang sudah Verified. |
| 422 | recipient_suppressed | Alamat itu pernah bounce permanen atau mengeluh, jadi tidak dikirimi lagi. Hapus dari daftar tujuan. |
| 429 | rate_limited, daily_limit, monthly_limit | Terlalu cepat, atau jatah hari atau bulan ini habis. Tunggu sesuai header Retry-After, atau tambah paket. |
| 502 | send_failed | Penyedia email gagal, atau domain belum Verified. Coba lagi sebentar. |
| 504 | send_unconfirmed | Pesan mungkin sudah diterima tetapi jawabannya hilang. Jangan kirim ulang tanpa memeriksa. |
Kirim ulang hanya 429 (setelah batas direset), 500, dan 502. Kesalahan 4xx lainnya akan gagal dengan cara yang sama sampai permintaannya diperbaiki. Untuk percobaan ulang yang aman, kirim header Idempotency-Key yang sama: pesan tidak akan terkirim dua kali. Daftar lengkap error ada di Dokumentasi.
#Batas kecepatan per paket
| Paket | Permintaan per detik | Email per bulan |
|---|---|---|
| Free | 1 | 100 per hari |
| Starter | 2 | 10.000 |
| Basic | 5 | 50.000 |
| Pro | 10 | 130.000 |
Lonjakan sampai 5 kali angka itu diperbolehkan sekaligus. Untuk mengirim banyak email, pakai antrean yang mengirim sesuai batas paket Anda.
#Langkah berikutnya
- Template email: simpan subjek dan isi dengan variabel, lalu panggil dengan nama template.
- Lampiran, di paket berbayar: sampai 5 file per email.
- Webhook: terima kabar terkirim, bounce, dan keluhan, lalu berhenti mengirim ke alamat yang bermasalah.
- Dokumentasi memuat semua kolom, error, dan contoh. Berkasnya juga tersedia sebagai OpenAPI (openapi.json) dan llms.txt, untuk alat dan asisten AI.