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
- Minta API key (form di web atau bot Telegram). Admin menyetujui dulu sebelum key aktif.
- Simpan key di environment variable, jangan hardcode. Siapkan kredensial:
email|password|refresh_token|client_id. - Panggil
POST /api/v1/otpdengan headerX-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
| Method | Path | Auth | Fungsi |
|---|---|---|---|
| POST | /api/v1/otp | API key | Baca 1 akun, balikin OTP terbaru + seluruh pesan. |
| POST | /api/v1/otp/bulk | API key | Sama, sampai 25 akun dalam 1 request. |
| POST | /api/v1/check | API key | Cek status akun: LIVE / DIE / UNKNOWN. |
| POST | /api/v1/renew | API key | Perbarui refresh_token akun. |
| GET | /api/v1/whoami | API key | Status key + statistik pemakaian. |
/api/v1/otp
API key wajibLogin 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
| Field | Tipe | Keterangan |
|---|---|---|
credentials | string | email|password|refresh_token|client_id (password diabaikan, hanya kompatibilitas format). |
email | string | Alternatif: alamat email akun. |
refresh_token | string | Alternatif: refresh token OAuth2 akun. |
client_id | string | Alternatif: client ID aplikasi Azure AD penerbit token. |
mode | string | oauth2 (default, scope Mail.Read) atau graph (scope .default). Auto-fallback ke mode satunya kalau gagal karena scope. |
top | number | Jumlah 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
| Field | Tipe | Keterangan |
|---|---|---|
success | boolean | true kalau request berhasil diproses. |
email | string | Alamat akun yang dibaca. |
modeUsed | string | Mode yang akhirnya berhasil, oauth2 atau graph. |
code | string|null | Kode OTP terbaru yang ditemukan. |
codeSource | object|null | subject, from, fromEmail, receivedAt pesan sumber kode. |
messageCount | number | Jumlah pesan di messages. |
messages | array | Isi inbox (subject, from, fromEmail, date, preview, body, isRead). |
/api/v1/otp/bulk
API key wajibSama 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).
| Field | Tipe | Keterangan |
|---|---|---|
credentials | string | Satu akun per baris, format email|password|refresh_token|client_id. Maks 25 baris. |
mode | string | oauth2 atau graph, berlaku untuk semua akun di batch. |
top | number | Pesan 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.
/api/v1/check
API key wajibCek 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" }
]
}
| Status | Arti |
|---|---|
LIVE | Token valid, akun bisa login dan inbox bisa dibaca. |
DIE | Token ditolak Microsoft (kedaluwarsa, dicabut, password diganti). Bukan berarti akun banned. |
UNKNOWN | Gagal karena jaringan/timeout — bukan hasil final, coba lagi. |
/api/v1/renew
API key wajibTukar 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-..."
}
]
}
/api/v1/whoami
API key wajibcurl /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
| Langkah | Apa yang terjadi |
|---|---|
| 1. Ajukan | Isi form API Access → Ajukan Key di web, atau chat bot Telegram. |
| 2. Approval | Admin menyetujui atau menolak permintaan. |
| 3. Key aktif | Key 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": "..." }.
| Status | Arti | Kapan |
|---|---|---|
| 400 | Request tidak valid | Field wajib kosong, format credentials salah. |
| 401 | Tidak diautentikasi | X-API-Key kosong/salah/dicabut. |
| 410 | Link kedaluwarsa | Public link lewat TTL atau batas view. |
| 422 | Akun ditolak Microsoft | refresh_token/client_id kedaluwarsa, dicabut, atau salah. |
| 429 | Rate limit | Terlalu banyak request per key atau per IP. |
| 502 | Graph API gagal | Gangguan jaringan/layanan Microsoft. |
| 500 | Server error | Error 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.
| Kasus | Saran |
|---|---|
| 1 akun | Interval 2–5 detik aman (maks teoretis 1 panggilan/detik). |
| Banyak akun | Pakai /otp/bulk — 25 akun cuma 1 request. |
| Rumus | req/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.