Menerima Email
Baca email dengan API
Baca email yang masuk ke domain Anda dari kode Anda sendiri. Tampilkan percakapan, buka pesan, cari, beri label, atur, kirim, dan balas, semuanya melalui satu endpoint.
- REST
- JSON
- Thread dan pencarian
- Label dan folder
- Kirim dan balas
https://g.sendcorex.comCara kerjanya
Satu token, satu kotak surat
Token Anda milik sebuah pengirim, dan pengirim adalah sebuah kotak surat. Tidak ada argumen yang memilih email siapa yang Anda baca: token yang menentukan.
Satu endpoint untuk semuanya
Menampilkan daftar, membaca, mencari, menandai, memindahkan, mengirim, dan membalas adalah perintah yang dikirim ke POST /v1. Kirim hingga 20 per request.
Token berumur pendek
Access token berlaku 1 jam dan refresh token 15 hari. Refresh token berganti setiap kali Anda memakainya.
Siapkan kotak surat Anda
Lakukan sekali saja. Setelah itu, setiap request hanya memerlukan token Anda.
- 1
Tambahkan domain, atau gunakan domain bersama
Verifikasi domain Anda sendiri, atau lewati pengaturan DNS dan gunakan domain bersama.
- 2
Buat pengirim
Pengirim adalah kotak surat. Buat pengirim di domain terverifikasi Anda atau di domain bersama: di domain bersama, membuat pengirim sekaligus membuat kotak suratnya.
Jika Anda sudah mendaftarkan domain sendiri dan pernah mengirim email, pengirim sudah dibuat otomatis untuk Anda.
- 3
Arahkan record MX Anda
Hanya diperlukan jika Anda ingin menerima email di domain sendiri. Arahkan record MX ke host inbound Sendcorex.
- 4
Buat token Anda
Buka webmail, masuk ke Pengaturan, lalu buat access token dan refresh token untuk pengirim tersebut.
- 5
Panggil API
Kirim token Anda di header Authorization dan perintah pertama Anda ke POST /v1.
Record MX
Untuk menerima email di domain sendiri, record MX domain itu harus mengarah ke host inbound Sendcorex. Tambahkan record ini di penyedia DNS Anda.
- Tipe
MX - Mengarah ke
bounce.emailsbit.com
Record MX hanya untuk menerima email di domain sendiri. Tanpa record ini, Anda tetap bisa mengirim, serta membaca bounce dan komplain yang kembali ke kotak surat Anda.
Apa yang masuk ke kotak surat
Email biasa
Semua yang dikirim ke alamat pengirim Anda, seperti di kotak surat mana pun.
Pesan return path
Bounce dan pesan lain yang kembali ke return path juga disimpan di kotak surat, jadi Anda bisa membacanya melalui API.
Komplain
Komplain spam juga disimpan di kotak surat. Komplain ini hanya datang dari Microsoft 365 dan layanan Microsoft secara umum.
Request pertama Anda
Tampilkan percakapan yang belum dibaca di INBOX Anda. Ganti SENDCOREX_TOKEN dengan access token dari pengaturan webmail.
curl -X POST 'https://g.sendcorex.com/v1' \
-H "Authorization: $SENDCOREX_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "list_threads", "args": { "folder": "INBOX", "is_read": false, "limit": 10 } }
]
}'Setiap thread memiliki last_message_uid. Teruskan ke Ambil pesan untuk membaca email, atau ke Balas untuk membalasnya.
Referensi lengkap
Semua yang bertanda CMD adalah perintah yang dikirim melalui POST /v1, hingga 20 per request. Rute memakai path-nya sendiri.
Rute
4Identitas
1Folder & penghitung
5Membaca
5Flag & label
8- CMDAtur flagDibaca, berbintang, penting
- CMDTambah labelLabel tidak peka huruf besar/kecil
- CMDHapus labelLabel tidak peka huruf besar/kecil
- CMDTandai gambar sudah dimuatHapus flag gambar eksternal
- CMDDaftar labelNama dan warna
- CMDBuat labelLabel baru
- CMDAtur warna labelUbah warna
- CMDHapus labelDari setiap pesan
Mengatur
4Kirim & kepercayaan
9- CMDKirim emailPesan baru, disimpan di Terkirim
- CMDBalasPercakapan yang sama, label dipertahankan
- CMDAmbil kepercayaanStatus kepercayaan pengirim
- CMDAtur kepercayaanDefault, tepercaya, atau tidak tepercaya
- CMDDaftar kepercayaanPengirim yang sudah diputuskan
- CMDTeruskanLampiran asli disertakan
- CMDAmbil pelacakanPembukaan dan klik email terkirim
- CMDDaftar aktivitasSiapa yang membuka, mengklik, atau berhenti berlangganan
- CMDJumlah aktivitasLencana folder Aktivitas
Lampiran
4Jadwal
3Draf
5Aturan
10- CMDDaftar aturanDalam urutan eksekusi, dengan hit
- CMDAmbil aturanSatu aturan
- CMDBuat aturanFilter untuk setiap email baru
- CMDPerbarui aturanGanti aturan
- CMDHapus aturanHapus aturan
- CMDAktifkan aturanAktif atau nonaktif
- CMDUrutkan ulang aturanUrutan eksekusi
- CMDOpsi aturanField, operator, tindakan
- CMDUji aturanUji coba pada email terbaru
- CMDTerapkan aturanJalankan pada email yang sudah ada
Template
6Kontak & tindak lanjut
5Kontak dan audiens
12- CMDDaftar kontakOrang yang berkomunikasi dengan kotak ini
- CMDHitung kontakBerapa orang yang cocok dengan filter
- CMDLihat kontak kotakSatu kontak dengan jumlah dan kepercayaan
- CMDPerbarui nama kontakUbah nama kontak
- CMDBeri tag kontakTambah atau hapus tag
- CMDLihat riwayat kontakPembukaan, klik, dan email kontak
- CMDDaftar segmenSegmen tersimpan di kotak
- CMDSimpan segmenBuat atau edit segmen
- CMDHapus segmenHapus segmen
- CMDLihat audiensUkuran audiens sebelum mengirim
- CMDPeriksa penerimaSiapa yang berhenti berlangganan, sebelum mengirim
- CMDLihat status pengirimanPengiriman per penerima dari email terkirim