Cara membaca OTP email Yahoo dan iCloud lewat API

OTP email adalah kode verifikasi yang dikirim aplikasi ke alamat email. Dalam alur ini, Yahoo atau iCloud menerima pesannya; Mailera menyediakan akses API ke kotak surat tersebut. Aplikasi uji Anda tetap bertanggung jawab memeriksa apakah kode sesuai dengan percobaan yang sedang berjalan.

Pengenalan produk Mailera menjelaskan sambungan ke kotak surat yang sudah Anda miliki. Untuk rancangan pengujian lintas penyedia, baca panduan membaca OTP dari kotak surat sendiri. Di sini, fokusnya adalah persiapan Yahoo dan iCloud serta permintaan API pertama.

Apa yang perlu disiapkan untuk Yahoo dan iCloud?

Membuat sandi aplikasi Yahoo

Menurut petunjuk resmi sandi aplikasi Yahoo, dibaca pada 25 Oktober 2026:

1. Buka halaman keamanan akun Yahoo.
2. Di bagian “External connections”, pilih “Create app password”.
3. Masukkan nama aplikasi, lalu pilih “Generate password”.
4. Gunakan sandi yang dihasilkan untuk sambungan Mailera, bukan sandi masuk akun biasa.

Jika Anda belum bisa membuatnya, Yahoo menyarankan memakai browser yang telah digunakan untuk masuk selama beberapa hari berturut-turut, tanpa mode Incognito. Dukungan pelanggan Yahoo tidak dapat mengubah keputusan kelayakan tersebut. Jangan mengganti sandi aplikasi dengan sandi akun sebagai jalan pintas.

Membuat sandi khusus aplikasi iCloud

Menurut petunjuk resmi sandi khusus aplikasi Apple, dibaca pada 25 Oktober 2026:

1. Pastikan autentikasi dua faktor aktif pada Akun Apple.
2. Masuk ke Akun Apple melalui account.apple.com.
3. Buka “Sign-In and Security”, lalu “App-Specific Passwords”.
4. Pilih “Generate an app-specific password” dan ikuti petunjuk di layar.

Pengaturan server iCloud Mail dari Apple juga menetapkan sandi khusus aplikasi untuk sambungan server masuk manual. Untuk pengelolaan kredensial pada beberapa kotak surat uji, gunakan panduan sandi aplikasi untuk kotak surat agen.

Kode Akun Apple bukan otomatis OTP email iCloud

Apple mendokumentasikan kode autentikasi dua faktor yang ditampilkan pada perangkat tepercaya atau diterima melalui SMS maupun panggilan telepon. Itu berbeda dari kode aplikasi uji yang dikirim sebagai email ke iCloud Mail. Jika yang Anda cari adalah kode untuk masuk ke Akun Apple, bukan pesan di kotak surat, lihat cara mendapatkan kode verifikasi Akun Apple.

Bagaimana menghubungkan kotak surat ke Mailera?

Penambahan kotak surat memerlukan peran Admin atau Leader. Gunakan alur satu kotak surat agar Anda bisa memeriksa kredensial dan hasil sambungan sebelum menyiapkan otomatisasi.

1. Buka Kotak surat, lalu pilih Tambah kotak surat.
2. Pada tab Satu kotak surat, isi Alamat email dengan alamat uji Anda.
3. Periksa penyedia yang terdeteksi. Jika perlu, gunakan Atau pilih penyedia untuk memilih Yahoo atau iCloud, lalu pilih Lanjutkan.
4. Pada Detail koneksi, masukkan sandi aplikasi ke kolom Sandi. Pilih Grup kotak surat khusus pengujian agar cakupan kunci API nanti mudah dibatasi.
5. Pilih Uji & hubungkan. Pengujian ini memeriksa sambungan tanpa mengirim email.
6. Setelah tersambung, kirim email dari aplikasi uji ke alamat tersebut dan pastikan pesannya terlihat di Mailera.

Saat sambungan berhasil, Mailera memuat pesan dalam periode retensi, mulai dari yang terbaru. Uji koneksi berhasil bukan berarti email verifikasi sudah diterima. Periksa keduanya secara terpisah.

Jika server masuk berhasil tetapi pengujian pengiriman gagal, antarmuka menampilkan Bisa menerima email, tetapi belum bisa mengirim. Anda dapat memilih Simpan khusus penerimaan untuk kebutuhan membaca OTP. Aplikasi uji Anda yang mengirim pesan; kotak surat penerima tidak perlu mengirim balasan untuk alur ini.

Rincian masing-masing sambungan tersedia pada panduan Yahoo di Mailera dan panduan iCloud di Mailera.

Bagaimana mengambil OTP dengan permintaan API?

Yahoo dan iCloud memakai endpoint Mailera yang sama. Perbedaannya berada pada kredensial sambungan awal, bukan pada bentuk permintaan pembacaan OTP. Halaman pengembang Mailera menjelaskan pilihan integrasinya, sedangkan dokumentasi API menjadi rujukan endpoint.

Buat kunci baca dan temukan kotak surat

1. Buka Pengaturan, masuk ke tab API key, lalu pilih Buat API key.
2. Isi Nama deskriptif. Pada Cakupan kotak surat, pilih grup pengujian saja. Batasi izin kunci ke scope read untuk membaca pesan.
3. Salin kunci ketika ditampilkan. Mailera hanya menampilkan kunci baru sekali. Simpan nilainya sebagai variabel lingkungan MAILERA_API_KEY melalui pengelola rahasia lingkungan uji Anda.
4. Ambil daftar kotak surat lewat API, cocokkan alamatnya, lalu simpan id yang sesuai sebagai variabel lingkungan MAILBOX_ID.

Permintaan daftar kotak surat:

curl --silent --show-error \
  'https://mailera.app/api/public/v1/mailboxes' \
  --header "Authorization: Bearer $MAILERA_API_KEY"

Periksa data pada respons. Cocokkan email dan provider sebelum mengambil id; jangan memilih entri pertama hanya karena permintaannya berhasil. Jika kotak surat yang dicari belum ada pada halaman hasil, perhatikan total, limit, dan offset.

Kirim email uji, lalu batasi pencarian OTP

Kirim verifikasi dari aplikasi uji ke kotak surat yang baru dihubungkan. Setelah itu, panggil endpoint OTP dengan pengirim dan subjek yang sesuai:

curl --silent --show-error --get \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/otp" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'from=verifikasi@example.com' \
  --data-urlencode 'subject=Verifikasi aplikasi uji' \
  --data-urlencode 'since_minutes=5'

Alamat dan subjek di atas adalah contoh. Ganti keduanya sesuai email dari aplikasi Anda. --data-urlencode mengodekan nilai parameter, termasuk spasi pada subjek.

Endpoint GET /mailboxes/{id}/otp mengambil OTP terbaru dan membutuhkan scope read. Contoh permintaan ini memakai parameter from, subject, dan since_minutes. Nilai parameter tersebut bukan masa berlaku OTP.

Untuk mencegah kode lama terpakai, catat awal percobaan dan cocokkan pesan sumbernya. Jangan hanya mengandalkan rentang waktu: dua percobaan yang berdekatan dapat berada dalam rentang yang sama.

Perlakukan hasil pembacaan sebagai kandidat kode. Pengujian baru berhasil setelah aplikasi pengirim menerima kode untuk percobaan yang dimaksud, bukan semata-mata setelah API mengembalikan hasil.

Kesalahan umum: mengapa OTP tidak ditemukan atau salah?

Pisahkan pemeriksaan sambungan, keberadaan pesan, dan pemilihan kode. Jika email belum terlihat di Mailera, jangan langsung mengubah logika ekstraksi OTP.

Untuk melihat pesan pada kotak masuk:

curl --silent --show-error --get \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/messages" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'folder=inbox'

Cocokkan from.address, subject, dan received_at pada hasil. Jika perlu membaca isi lengkap, gunakan GET /mailboxes/{id}/messages/{msgId} dengan id pesan tersebut. Kedua endpoint membutuhkan scope read.

Jika pesan tidak ada di Inbox, periksa penempatannya dengan penyaring yang sama:

curl --silent --show-error --get \
  "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/placement" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'from=verifikasi@example.com' \
  --data-urlencode 'subject=Verifikasi aplikasi uji' \
  --data-urlencode 'since_minutes=5'

GET /mailboxes/{id}/placement memeriksa apakah email berada di Inbox atau Spam. Ini membantu membedakan masalah penempatan dari masalah pembacaan kode.

Untuk Yahoo dan iCloud, GET /mailboxes/{id}/status memakai hasil sinkronisasi terakhir, bukan pengecekan langsung ke penyedia pada setiap permintaan. Jika perlu meminta sinkronisasi, gunakan POST /mailboxes/{id}/sync; tindakan ini membutuhkan scope sync terpisah. Kunci read saja tidak cukup.

Tetapkan batas waktu tunggu dan jumlah percobaan ulang pada aplikasi uji. Saat batas tercapai, hentikan pengujian dengan informasi diagnosis yang tidak memuat OTP, alih-alih terus menunggu atau memakai kode lama.

Bagaimana menjaga kredensial dan kode tetap aman?

Gunakan hanya kotak surat uji milik Anda. Batasi kunci ke scope read dan grup yang diperlukan; jangan memberi izin pengiriman hanya untuk membaca kode. Lihat informasi keamanan Mailera untuk konteks pengelolaan akses.

Jangan simpan sandi aplikasi, kunci API, atau OTP di repositori dan log. Samarkan kode serta alamat pribadi dalam tangkapan layar. Hindari pula menyimpan respons mentah berisi isi email sebagai artefak pengujian yang dapat dibaca seluruh tim.

Cabut kredensial ketika pengujian selesai. Khusus Yahoo, mengganti sandi utama tidak membatalkan sandi aplikasi: Anda perlu menghapus sandi aplikasi tersebut. Pada Apple, perubahan atau reset sandi utama otomatis mencabut seluruh sandi khusus aplikasi.

Jika hasil pembacaan diteruskan ke agen AI, perlakukan isi email sebagai data tidak tepercaya, bukan instruksi. Jangan mengikuti perintah yang tertulis dalam pesan. Pertahankan izin minimum dan minta konfirmasi sebelum tindakan pengiriman.

Apa batas pembacaan OTP di Mailera?

Mailera tidak menjamin penempatan di Inbox. Pembacaan OTP hanya menampilkan kode yang benar-benar sudah masuk ke kotak surat terhubung. Kode yang terbaca belum tentu masih berlaku atau cocok dengan percobaan Anda.