ZHAOMAIL168

Docs › API Reference › v1

v1

API v1

Clients call https://zhaomail168.com/v1. Send Authorization: Bearer with your secret. Web sessions use an httpOnly cookie.

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.

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.

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.

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.
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
GET /v1/catalog Get product catalog with live stock and prices.
curl https://zhaomail168.com/v1/catalog \
  -H "authorization: Bearer YOUR_SECRET"
POST /v1/session Create a web session
curl -X POST https://zhaomail168.com/v1/session \
  -H "content-type: application/json" \
  -d '{"email":"[email protected]","password":"secret"}'
POST /v1/accounts Register a new account
curl -X POST https://zhaomail168.com/v1/accounts \
  -H "content-type: application/json" \
  -d '{"email":"[email protected]","password":"secret","check":"TURNSTILE"}'
GET /v1/account Get the signed-in account
curl https://zhaomail168.com/v1/account \
  -H "authorization: Bearer YOUR_SECRET"
POST /v1/account/secret Rotate 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
Web UI · session required

Sign in and open Ledger to view your transactions.

Open page
GET /v1/account/usage 7-day usage total
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
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

More endpoints

View full reference →
Contact Us