Kirim email pertama
Siapkan domain dan alamat pengirim, lalu kirim serta periksa email uji pertama Anda.
Kirim email uji pertama dengan Produk Email: siapkan API Key dan identitas pengirim, kirim permintaan tunggal, lalu cari hasil akhir berdasarkan Message ID. Alur ini memakai Bearer API Key. Dialog uji di browser tidak memerlukan API Secret. Permintaan uji benar-benar mengirim email.
Penerimaan bukan pengiriman
code=000000 berarti platform menerima permintaan. Periksa catatan pengiriman untuk hasilnya. “Terkirim” berarti server penerima menerima pesan, bukan jaminan masuk kotak masuk atau dibaca.Sebelum memulai
- Produk Email aktif untuk akun Anda dan API Key aktif tersedia di Console > Developers.
- IP keluar memenuhi daftar izin API Key.
- Anda mengelola domain pengirim dan telah menyelesaikan verifikasi domain serta penyiapan alamat pengirim di konsol email.
- Anda memiliki penerima uji yang diotorisasi. Jangan menaruh API Key, API Secret, atau data penerima asli di dokumen publik, tangkapan layar, atau log.
Kirim email pertama
Periksa identitas pengirim
Pastikan domain dan alamat pengirim siap. Jika belum, gunakan panduan domain pengirim untuk menambahkan domain, memasang record DNS yang ditampilkan konsol, dan menyelesaikan peninjauan yang diperlukan.Pilih cara mengirim
Buka Referensi API · Kirim satu email dan pilih pengujian interaktif dengan Bearer API Key. Anda juga dapat memanggil endpoint yang sama dari server terkendali. Pengujian interaktif saat ini hanya mendukung pengiriman tunggal Bearer.Isi permintaan uji
IsiX-Idempotency-Key unik, pengirim yang diotorisasi, penerima uji, subjek, dan isi. Ganti alamat contoh di bawah dengan alamat uji Anda.Periksa penerimaan dan pengiriman
Pastikan HTTP 202 dengancode=000000. Simpan data.messageId dan header respons X-Request-Id, lalu cari Message ID lengkap di catatan pengiriman.Contoh body permintaan:
{
"from": {"email": "notify@example.com"},
"to": [{"email": "recipient@example.net"}],
"subject": "Email uji pertama",
"text": "Ini adalah pesan uji.",
"messageType": "TRANSACTIONAL"
}Untuk pemanggilan langsung dari server, dapatkan host API HTTPS dari platform dan kirim JSON ke POST /innomail/v2/messages/send dengan Authorization: Bearer <API_KEY>, Content-Type: application/json; charset=utf-8, dan X-Idempotency-Key. Alamat contoh hanyalah placeholder, bukan alamat sandbox platform atau penerima dengan hasil terkirim yang dijamin.
Penelusuran masalah
| Gejala | Periksa dahulu |
|---|---|
| 401 atau 403 | Status API Key, nilai Bearer, dan daftar IP keluar yang diizinkan. |
| 400 | Pengirim, penerima, subjek, isi, dan kunci idempotensi. |
| 202 tetapi email belum diterima | Cari catatan dengan Message ID; periksa otorisasi pengirim, supresi, kegagalan kanal, dan kebijakan penerima. |
| Timeout atau 5xx | Cocokkan tugas awal. Pertahankan body dan kunci idempotensi saat mencoba ulang. |
Langkah berikutnya
Terakhir diperbarui pada