Docs › API Reference › v1
Overview Clients call https://zhaomail168.com/v1. Send Authorization: Bearer with your secret. Web sessions use an httpOnly cookie.
Same Nest stock underneath. Public paths and field names stay Zhao-only.
Quick Start From zero to a delivered Hotmail/Outlook order in five steps. Base URL is always https://zhaomail168.com/v1.
1. Create an account Register with email + password. Browser flows may require a Turnstile token in check.
Copy curl -X POST https://zhaomail168.com/v1/accounts \
-H "content-type: application/json" \
-d '{"email":"[email protected] ","password":"StrongPass1"}' 2. Sign in (web) or keep the secret (API) Sign in through the web UI. Your browser manages the session cookie automatically. API clients use the account secret as Bearer.
Sign in 3. View or rotate your API secret Use GET /v1/account with your API secret to view it. To rotate it, sign in and use the control on this page; then update any API clients using the old secret.
Open secret settings 4. Check catalog + credit GET /v1/catalog returns hotmail and outlook with unitPrice, bulkUnitPrice (≥10k), and stock. To add credit, use the Wallet page in the web UI.
Copy curl https://zhaomail168.com/v1/catalog \
-H "authorization: Bearer YOUR_SECRET" 5. Place an order POST /v1/orders with sku hotmail|outlook, line steady, and count. Response seats are email:password lines. Bulk ≥10k uses $0.25/1k.
Copy curl -X POST https://zhaomail168.com/v1/orders \
-H "authorization: Bearer YOUR_SECRET" \
-H "content-type: application/json" \
-d '{"sku":"hotmail","line":"steady","count":1}' Tip: start with count:1 to verify auth and stock, then scale. Rank discounts still apply on top of Zhao unit price.
Authentication Clients call https://zhaomail168.com/v1. Send Authorization: Bearer with your secret. Web sessions use an httpOnly cookie.
API clients: use Authorization: Bearer YOUR_SECRET where supported. For session-only actions, use the signed-in web UI; the browser manages its httpOnly cookie. POST /v1/orders Create a new order. Request Response Examples
Copy curl -X POST https://zhaomail168.com/v1/orders \
-H "authorization: Bearer YOUR_SECRET" \
-H "content-type: application/json" \
-d '{"sku":"hotmail","line":"steady","count":1}' Field Type Required Description sku string Yes Product sku: hotmail or outlook line string Yes steady for trusted mail count number Yes How many accounts to buy
200 Response
Copy {
"ok": true,
"result": {
"id": "ord_01",
"sku": "hotmail",
"count": 1,
"seats": ["[email protected] :pass"]
}
} Copy curl -X POST https://zhaomail168.com/v1/orders \
-H "authorization: Bearer YOUR_SECRET" \
-H "content-type: application/json" \
-d '{"sku":"outlook","line":"steady","count":10000}' GET /v1/catalog Get product catalog with live stock and prices. Request Response Examples
Copy curl https://zhaomail168.com/v1/catalog \
-H "authorization: Bearer YOUR_SECRET" 200 Response
Copy {
"ok": true,
"result": [
{ "sku": "hotmail", "line": "steady", "unitPrice": 0.0005, "bulkUnitPrice": 0.00025, "stock": 12 },
{ "sku": "outlook", "line": "steady", "unitPrice": 0.0005, "bulkUnitPrice": 0.00025, "stock": 8 }
]
} Copy curl https://zhaomail168.com/v1/catalog -H "authorization: Bearer YOUR_SECRET" POST /v1/session Create a web session Request Response Examples
Copy curl -X POST https://zhaomail168.com/v1/session \
-H "content-type: application/json" \
-d '{"email":"[email protected] ","password":"secret"}' 200 Response
Copy {
"ok": true,
"result": { "email": "[email protected] ", "credit": 10 }
} Web UI · session required To end your session, select Sign out in the top-right navigation.
The browser clears the session cookie automatically.
POST /v1/accounts Register a new account Request Response Examples
Copy curl -X POST https://zhaomail168.com/v1/accounts \
-H "content-type: application/json" \
-d '{"email":"[email protected] ","password":"secret","check":"TURNSTILE"}' Copy curl -X POST https://zhaomail168.com/v1/accounts \
-H "content-type: application/json" \
-d '{"email":"[email protected] ","password":"StrongPass1"}' GET /v1/account Get the signed-in account Request Response Examples
Copy curl https://zhaomail168.com/v1/account \
-H "authorization: Bearer YOUR_SECRET" 200 Response
Copy {
"ok": true,
"result": { "email": "[email protected] ", "credit": 10, "secret": "••••" }
} Copy curl https://zhaomail168.com/v1/account -H "authorization: Bearer YOUR_SECRET" POST /v1/account/secret Rotate API secret Request Response Examples
Web UI · session required Sign in, then rotate your API secret here. This replaces the current secret, so update any API clients that use it.
200 Response
Copy {
"ok": true,
"result": { "secret": "new_api_secret" }
} Web UI · session required Sign in, then rotate your API secret here. This replaces the current secret, so update any API clients that use it.
GET /v1/account/ledger List ledger entries Request Response Examples
Web UI · session required Sign in and open Ledger to view your transactions.
Open page 200 Response
Copy {
"ok": true,
"result": { "docs": [{ "action": "buy", "amount": -0.0005 }] }
} Web UI · session required Sign in and open Ledger to view your transactions.
Open page GET /v1/account/usage 7-day usage total Request Response Examples
Web UI · session required Sign in and open Rank to view your 7-day usage and current tier.
Open page 200 Response
Copy {
"ok": true,
"result": { "usage": 42 }
} Web UI · session required Sign in and open Rank to view your 7-day usage and current tier.
Open page POST /v1/wallet/deposits Create a crypto deposit Request Response Examples
Web UI · session required Sign in, open Wallet, choose Add credit, then select Contact Us to arrange your deposit on Telegram.
Open page 200 Response
Copy {
"ok": true,
"result": { "payTo": { "address": "0x…", "amount": 10 }, "currency": "USDT" }
} Web UI · session required Sign in, open Wallet, choose Add credit, then select Contact Us to arrange your deposit on Telegram.
Open page Error Codes Code Description INVALID_SESSION401 — missing or bad auth NOT_ENOUGH_MONEY403 — balance too low OUT_OF_STOCK409 — not enough stock PRICE_UNAVAILABLE503 — Zhao price row missing
Changelog v1 — hotmail / outlook skus, bulk ≥10k at $0.25/1k v1 — Bearer secret + zm_session cookie