Memulai
Buat API key
Mengirim dan mengelola memakai satu key. Membaca email memakai key lain yang dibuat di tempat berbeda. Pilih yang sesuai dengan yang Anda bangun.
Key mana yang Anda perlukan?
Mail & Graph
Kirim dan kelola
Untuk mengirim email dan semua hal lain di API: domain, kontak, pelacakan, pengirim, dan log.
Dibuat di
Dashboard, halaman Developer
Buka halaman DeveloperBaca email
Baca kotak surat
Untuk membaca, mencari, dan mengatur email dari satu akun email.
Dibuat di
Webmail, Pengaturan tiap akun email
Buka WebmailMail & Graph
Kirim dan kelola
Satu key dari halaman Developer berfungsi di mail.sendcorex.com dan graph.sendcorex.com.
- 1
Buka halaman Developer
Masuk di app.sendcorex.com lalu buka halaman Developer di dashboard.
Buka halaman Developer - 2
- 3
Kirim di setiap request
Kirim di header Authorization pada mail.sendcorex.com dan graph.sendcorex.com.
Authorization: Bearer YOUR_API_KEYBaca email
Baca kotak surat
Key ini dibuat di dalam Webmail, satu untuk setiap akun email, dan dipakai di g.sendcorex.com.
- 1
Buka Webmail
Buka webmail.sendcorex.com dan masuk dengan akun email yang ingin Anda baca.
Buka Webmail - 2
Buka Pengaturan
Buka bagian Pengaturan untuk akun email tersebut.
- 3
Buat key
Buat API key di sana lalu salin. Setiap akun email punya key sendiri.
curl -s https://g.sendcorex.com/v1 \
-H "Authorization: $TOKEN" \
-H "Content-Type: application/json" \
-d '{"commands":[{"command":"list_folders"}]}'curl -s https://g.sendcorex.com/v1/token/refresh \
-H "Content-Type: application/json" \
-d "{\"refresh_token\":\"$REFRESH\"}" Kirim token sebagai Authorization: <token> atau Authorization: Bearer <token>. Token diawali dengan S.C.G. dan refresh token dengan R.S.C.G.
Satu kotak surat per key
Key menentukan email milik siapa yang Anda baca. Tidak ada argumen di request yang bisa memilih pemilik lain.
Token kedaluwarsa
Token yang kedaluwarsa mengembalikan TOKEN_EXPIRED. Ganti pasangannya dengan Refresh Token. Refresh token yang Anda pakai langsung berhenti berfungsi.
Key yang dicabut
Token disimpan di cache hingga 1 jam, jadi token yang dicabut bisa tetap berfungsi sampai cache itu habis.
Rate limit
15 request per detik dan 15 sekaligus, per IP dan kotak surat. Di atas itu Anda mendapat 429 RATE_LIMITED dengan header Retry-After.
Error autentikasi
Yang dikembalikan API baca email saat masalahnya ada di key.
| Kode | HTTP | Kapan |
|---|---|---|
MISSING_AUTH_HEADER | 401 | Request tidak memiliki header Authorization. |
INVALID_TOKEN | 401 | Format salah, token tidak dikenal, atau sudah dicabut. |
TOKEN_EXPIRED | 401 | Token sudah lewat masa berlaku. Gunakan refresh token. |
RATE_LIMITED | 429 | Lebih dari 15 request per detik atau 15 yang sedang berjalan. |
AUTH_UNAVAILABLE | 503 | Autentikasi sementara tidak tersedia. |