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.sendcorex.comgraph.sendcorex.com

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 Developer
g.sendcorex.comSatu per akun

Baca email

Baca kotak surat

Untuk membaca, mencari, dan mengatur email dari satu akun email.

Dibuat di

Webmail, Pengaturan tiap akun email

Buka Webmail

Mail & Graph

Kirim dan kelola

Satu key dari halaman Developer berfungsi di mail.sendcorex.com dan graph.sendcorex.com.

  1. 1

    Buka halaman Developer

    Masuk di app.sendcorex.com lalu buka halaman Developer di dashboard.

    Buka halaman Developer
  2. 2

    Buat key

    Buat key baru di sana lalu salin. Simpan di tempat yang aman.

    Buat API key
  3. 3

    Kirim di setiap request

    Kirim di header Authorization pada mail.sendcorex.com dan graph.sendcorex.com.

Header request
Authorization: Bearer YOUR_API_KEY

Baca email

Baca kotak surat

Key ini dibuat di dalam Webmail, satu untuk setiap akun email, dan dipakai di g.sendcorex.com.

  1. 1

    Buka Webmail

    Buka webmail.sendcorex.com dan masuk dengan akun email yang ingin Anda baca.

    Buka Webmail
  2. 2

    Buka Pengaturan

    Buka bagian Pengaturan untuk akun email tersebut.

  3. 3

    Buat key

    Buat API key di sana lalu salin. Setiap akun email punya key sendiri.

Request pertama
curl -s https://g.sendcorex.com/v1 \
  -H "Authorization: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"commands":[{"command":"list_folders"}]}'
Perbarui token
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.

KodeHTTPKapan
MISSING_AUTH_HEADER401Request tidak memiliki header Authorization.
INVALID_TOKEN401Format salah, token tidak dikenal, atau sudah dicabut.
TOKEN_EXPIRED401Token sudah lewat masa berlaku. Gunakan refresh token.
RATE_LIMITED429Lebih dari 15 request per detik atau 15 yang sedang berjalan.
AUTH_UNAVAILABLE503Autentikasi sementara tidak tersedia.