Membangun melawan Run2Mail

Developer API Documentation

Learn how to create API keys, authenticate requests, create inboxes, fetch messages, and handle common Run2Mail API responses.

Kunci API Otentikasi Titik Akhir Inti Kode kesalahan

Kunci API

Hasilkan kunci API pengembang dari dasbor Anda. Setiap kunci ditampilkan secara lengkap hanya sekali, kemudian disimpan sebagai hash aman untuk verifikasi di masa mendatang.

Buat kunci dari dasbor login Anda.
Jaga kerahasiaan kunci dan simpan di manajer rahasia Anda sendiri.
Cabut kunci lama setiap kali perangkat, skrip, atau rekan satu tim tidak lagi memerlukan akses.

Otentikasi

Gunakan token Pembawa di header Otorisasi untuk setiap permintaan yang dilindungi.

Authorization: Bearer YOUR_API_KEY

Jika kunci tidak valid, dicabut, atau hilang, API akan merespons dengan kesalahan autentikasi.

Titik Akhir Inti

Alur kerja yang paling umum adalah: memeriksa pengguna yang diautentikasi, membuat kotak masuk, lalu mengambil pesan dari kotak masuk tersebut.

Periksa akun saat ini

curl -X GET "https://run2mail.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Buat kotak masuk

curl -X POST "https://run2mail.com/api/v1/emails/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "random"
  }'

Ambil pesan kotak masuk

curl -X GET "https://run2mail.com/api/v1/emails/example@2mail.lol/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Contoh respons JSON

{
  "success": true,
  "data": {
    "email": "example@2mail.lol",
    "messages": []
  }
}

Pembatasan tarif

Run2Mail menerapkan batas permintaan berbasis rencana dan batas pembuatan kotak masuk harian untuk melindungi layanan dan menjaga akses API tetap stabil.

Batas tarif per menit bergantung pada paket aktif Anda.
Batas pembuatan email dilacak secara terpisah dari panggilan baca dasar.
Penggunaan dicatat untuk visibilitas di dalam dasbor analitik admin.

Kode kesalahan

401: Kredensial API tidak ada atau tidak valid.
403: Akses diblokir, dibatasi, atau tidak diizinkan untuk permintaan tersebut.
429: Volume permintaan melebihi batas saat ini.
503: API Pengembang dinonaktifkan sementara oleh platform.

Tangkapan layar Dashboard API segera hadir

Area ini dicadangkan untuk tangkapan layar manajer kunci API dan dasbor penggunaan di masa mendatang.