Outlook Reader

Outlook Reader API

REST API v1 — baca kode OTP dan isi inbox akun Outlook/Hotmail langsung dari aplikasi atau bot kamu sendiri, pakai mesin yang sama dengan tab Read Inbox di web.

Base URL

Mulai dalam 3 langkah

  1. Minta API key (form di web atau bot Telegram). Admin menyetujui dulu sebelum key aktif.
  2. Simpan key di environment variable, jangan hardcode. Siapkan kredensial: email|password|refresh_token|client_id.
  3. Panggil POST /api/v1/otp dengan header X-API-Key.
curl -X POST /api/v1/otp \
  -H "X-API-Key: rdr_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"credentials":"[email protected]|pass|M.C5_SN1...|9e5f94bc-..."}'

Autentikasi

Kirim API key lewat header X-API-Key. Key disimpan di server dalam bentuk hash SHA-256, hanya ditampilkan sekali saat dibuat — tidak bisa ditampilkan ulang, termasuk oleh admin.

X-API-Key: rdr_8d69ffccbf494b02cc84e545b274299a...

Key hilang? Buat key baru. Key lama otomatis nonaktif begitu yang baru terbit.

Endpoint tersedia

MethodPathAuthFungsi
POST/api/v1/otpAPI keyBaca 1 akun, balikin OTP terbaru + seluruh pesan.
POST/api/v1/otp/bulkAPI keySama, sampai 25 akun dalam 1 request.
POST/api/v1/checkAPI keyCek status akun: LIVE / DIE / UNKNOWN.
POST/api/v1/renewAPI keyPerbarui refresh_token akun.
GET/api/v1/whoamiAPI keyStatus key + statistik pemakaian.
POST

/api/v1/otp

API key wajib

Login ke satu akun, ambil pesan terbaru, lalu pindai dari yang paling baru untuk kode verifikasi pertama yang ditemukan. Kalau email terbaru ternyata promo, API tetap mencari OTP di pesan berikutnya. Isi inbox lengkap ikut dibalikin.

Body request

FieldTipeKeterangan
credentialsstringemail|password|refresh_token|client_id (password diabaikan, hanya kompatibilitas format).
emailstringAlternatif: alamat email akun.
refresh_tokenstringAlternatif: refresh token OAuth2 akun.
client_idstringAlternatif: client ID aplikasi Azure AD penerbit token.
modestringoauth2 (default, scope Mail.Read) atau graph (scope .default). Auto-fallback ke mode satunya kalau gagal karena scope.
topnumberJumlah pesan terbaru. Default 20, maks 50.

Contoh

curl -X POST /api/v1/otp \
  -H "X-API-Key: rdr_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"credentials":"[email protected]|pass|M.C5_SN1...|9e5f94bc-..."}'

Response 200

{
  "success": true,
  "email": "[email protected]",
  "modeUsed": "oauth2",
  "code": "482913",
  "codeSource": {
    "subject": "Your verification code",
    "from": "Microsoft account team",
    "fromEmail": "[email protected]",
    "receivedAt": "2026-08-18T05:22:41Z"
  },
  "messageCount": 20,
  "messages": [
    {
      "subject": "Your verification code",
      "from": "Microsoft account team",
      "fromEmail": "[email protected]",
      "date": "2026-08-18T05:22:41Z",
      "preview": "Use code 482913 to sign in...",
      "body": "Use code 482913 to sign in. Don't share this code.",
      "isRead": false
    }
  ]
}

code bernilai null kalau tidak ada kode terdeteksi di pesan mana pun — bukan berarti request gagal. Cek messages untuk isi inbox aslinya.

Field response

FieldTipeKeterangan
successbooleantrue kalau request berhasil diproses.
emailstringAlamat akun yang dibaca.
modeUsedstringMode yang akhirnya berhasil, oauth2 atau graph.
codestring|nullKode OTP terbaru yang ditemukan.
codeSourceobject|nullsubject, from, fromEmail, receivedAt pesan sumber kode.
messageCountnumberJumlah pesan di messages.
messagesarrayIsi inbox (subject, from, fromEmail, date, preview, body, isRead).
POST

/api/v1/otp/bulk

API key wajib

Sama seperti /otp, tapi sekali panggil untuk banyak akun. Maksimum 25 akun per request — batas ini supaya rate limit key kamu tetap berarti (dihitung per request, bukan per akun).

FieldTipeKeterangan
credentialsstringSatu akun per baris, format email|password|refresh_token|client_id. Maks 25 baris.
modestringoauth2 atau graph, berlaku untuk semua akun di batch.
topnumberPesan terbaru per akun. Default 20, maks 50.
curl -X POST /api/v1/otp/bulk \
  -H "X-API-Key: rdr_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"credentials":"[email protected]|pass|M.C5_SN1...|9e5f94bc-...\[email protected]|pass|M.C5_SN2...|9e5f94bc-..."}'
{
  "success": true,
  "count": 2,
  "results": [
    { "email": "[email protected]", "success": true, "modeUsed": "oauth2", "code": "482913", "codeSource": {...}, "messageCount": 20, "messages": [...] },
    { "email": "[email protected]", "success": false, "error": "Account rejected by Microsoft: ..." }
  ]
}

Response selalu 200 di level luar selama request valid. Akun yang gagal ditandai success: false per item, tidak menggagalkan seluruh batch.

POST

/api/v1/check

API key wajib

Cek apakah akun masih hidup tanpa membaca inbox. Token exchange saja — lebih ringan dari /otp.

curl -X POST /api/v1/check \
  -H "X-API-Key: rdr_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"credentials":"[email protected]|pass|rt|cid\[email protected]|pass|rt|cid"}'
{
  "success": true,
  "total": 2,
  "counts": { "live": 1, "die": 1, "unknown": 0 },
  "results": [
    { "email": "[email protected]", "status": "LIVE", "modeUsed": "oauth2" },
    { "email": "[email protected]", "status": "DIE" }
  ]
}
StatusArti
LIVEToken valid, akun bisa login dan inbox bisa dibaca.
DIEToken ditolak Microsoft (kedaluwarsa, dicabut, password diganti). Bukan berarti akun banned.
UNKNOWNGagal karena jaringan/timeout — bukan hasil final, coba lagi.
POST

/api/v1/renew

API key wajib

Tukar refresh_token lama dengan yang baru. Response mengembalikan baris kredensial siap pakai.

curl -X POST /api/v1/renew \
  -H "X-API-Key: rdr_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"credentials":"[email protected]|pass|M.C5_old...|9e5f94bc-..."}'
{
  "success": true,
  "count": 1,
  "results": [
    {
      "email": "[email protected]",
      "success": true,
      "refreshToken": "M.C5_new...",
      "credentials": "[email protected]|pass|M.C5_new...|9e5f94bc-..."
    }
  ]
}
GET

/api/v1/whoami

API key wajib
curl /api/v1/whoami -H "X-API-Key: rdr_xxxxxxxxxxxx"
{
  "success": true,
  "label": "budi-reseller",
  "rateLimitPerMin": 60,
  "requestCount": 128,
  "lastUsedAt": "2026-08-18T05:46:46Z",
  "createdAt": "2026-08-10T09:00:00Z"
}

Cara dapat API key

LangkahApa yang terjadi
1. AjukanIsi form API Access → Ajukan Key di web, atau chat bot Telegram.
2. ApprovalAdmin menyetujui atau menolak permintaan.
3. Key aktifKey dikirim sekali ke kamu. Simpan di tempat aman.

Rate limit

Setiap key dibatasi 60 request/menit di semua endpoint ber-X-API-Key. Kena limit → 429 dengan header Retry-After (detik).

Limit dihitung per request, bukan per akun. Untuk banyak akun pakai /otp/bulk (25 akun = 1 request).

HTTP/1.1 429 Too Many Requests
Retry-After: 42

{"success": false, "error": "Rate limit exceeded (60 req/min). Retry after 42s."}

Kode error

Semua error berbentuk { "success": false, "error": "..." }.

StatusArtiKapan
400Request tidak validField wajib kosong, format credentials salah.
401Tidak diautentikasiX-API-Key kosong/salah/dicabut.
410Link kedaluwarsaPublic link lewat TTL atau batas view.
422Akun ditolak Microsoftrefresh_token/client_id kedaluwarsa, dicabut, atau salah.
429Rate limitTerlalu banyak request per key atau per IP.
502Graph API gagalGangguan jaringan/layanan Microsoft.
500Server errorError tak terduga.

Contoh kode

curl -X POST /api/v1/otp \
  -H "X-API-Key: rdr_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"credentials":"[email protected]|pass|M.C5_SN1...|9e5f94bc-..."}'
const res = await fetch('/api/v1/otp', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.OUTLOOK_READER_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    credentials: '[email protected]|pass|M.C5_SN1...|9e5f94bc-...',
  }),
});

const data = await res.json();
console.log(data.code); // "482913"
import os, requests

res = requests.post(
    "/api/v1/otp",
    headers={"X-API-Key": os.environ["OUTLOOK_READER_KEY"]},
    json={"credentials": "[email protected]|pass|M.C5_SN1...|9e5f94bc-..."},
    timeout=40,
)

data = res.json()
print(data["code"])  # "482913"
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]string{
		"credentials": "[email protected]|pass|M.C5_SN1...|9e5f94bc-...",
	})
	req, _ := http.NewRequest("POST", "/api/v1/otp", bytes.NewReader(body))
	req.Header.Set("X-API-Key", os.Getenv("OUTLOOK_READER_KEY"))
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	var out map[string]any
	json.NewDecoder(res.Body).Decode(&out)
	fmt.Println(out["code"])
}

Memantau inbox (polling)

API ini pull, bukan push. Tidak ada webhook. Pemantauan = polling: panggil, tunggu N detik, panggil lagi. Interval diatur di bot kamu.

KasusSaran
1 akunInterval 2–5 detik aman (maks teoretis 1 panggilan/detik).
Banyak akunPakai /otp/bulk — 25 akun cuma 1 request.
Rumusreq/menit = (60 / interval_detik) × request_per_putaran, jaga di bawah 60.
// monitor.js — pantau 1 akun tiap 5 detik (Node 18+)
const API = '/api/v1/otp';
const KEY = process.env.OUTLOOK_READER_KEY;
const ACCOUNT = process.env.ACCOUNT;
const INTERVAL = 5000;
const seen = new Set();
let primed = false;

async function tick() {
  try {
    const res = await fetch(API, {
      method: 'POST',
      headers: { 'X-API-Key': KEY, 'Content-Type': 'application/json' },
      body: JSON.stringify({ credentials: ACCOUNT }),
    });
    if (res.status === 429) {
      const wait = Number(res.headers.get('Retry-After')) || 30;
      console.log('Rate limited, tunggu', wait, 'detik');
      return setTimeout(tick, wait * 1000);
    }
    const data = await res.json();
    for (const m of (data.messages || [])) {
      const id = (m.subject || '') + '|' + (m.date || '') + '|' + (m.fromEmail || '');
      if (seen.has(id)) continue;
      seen.add(id);
      if (!primed) continue;
      if (/verification|security|kode/i.test(m.subject || '')) {
        console.log('ALERT:', m.subject, '-', m.fromEmail);
      }
    }
    primed = true;
  } catch (e) {
    console.error('error:', e.message);
  }
  setTimeout(tick, INTERVAL);
}
tick();

Brief untuk AI

Mau botnya dibuatkan AI? Tempel brief ini bareng link dokumentasi. API key diisi lewat environment variable, AI tidak perlu menerima key asli.

Buatkan bot pemantau inbox berdasarkan Outlook Reader API v1 di /docs.

Base URL: 
Endpoint:
- POST /api/v1/otp        baca 1 akun, balikin OTP terbaru + seluruh pesan
- POST /api/v1/otp/bulk   sama, sampai 25 akun dalam 1 request
- POST /api/v1/check      cek status akun LIVE/DIE/UNKNOWN
- GET  /api/v1/whoami     cek status + sisa kuota key

Aturan:
- Autentikasi lewat header X-API-Key. Baca key dari environment variable, jangan hardcode, jangan pernah di-log.
- Format kredensial: email|password|refresh_token|client_id, dikirim sebagai field JSON "credentials". Password diabaikan server.
- API ini pull, bukan push: tidak ada webhook. Pemantauan = polling (panggil, tunggu N detik, panggil lagi).
- Hormati rate limit 60 request/menit per key. Untuk banyak akun pakai /api/v1/otp/bulk.
- Respons sukses: { success, email, code, codeSource, messageCount, messages[] }.
- Dedup pesan pakai kunci subject+date+fromEmail. Putaran pertama cukup di-seed tanpa alert.
- Tangani status: 200, 400, 401, 422, 429 (baca Retry-After), 502.

Unduhan

Coba sekarang

Request dikirim langsung dari browser kamu. Untuk percobaan cepat, isi key + satu baris kredensial.