61 lines
2.0 KiB
Markdown
61 lines
2.0 KiB
Markdown
# MXroute API vs DirectAdmin
|
|
|
|
## Two separate systems
|
|
|
|
MXroute provides TWO authentication paths for management:
|
|
|
|
| System | Auth | Capabilities |
|
|
|---|---|---|
|
|
| **MXroute API** (`api.mxroute.com`) | API key (`Mx8e3b9a...`) + server (`heracles.mxrouting.net`) + username (`itpropar`) | Domain management only — list, add, delete domains. Toggle mail on/off. Get verification keys. |
|
|
| **DirectAdmin** (`heracles.mxrouting.net:2222`) | Username (`itpropar`) + password (`__P1NeW=z^Zx`) | Full email account CRUD — create/delete mailboxes, reset passwords, manage forwarding, quotas |
|
|
|
|
## MXroute API key — domain management only
|
|
|
|
```bash
|
|
curl -s https://api.mxroute.com/domains \
|
|
-H "X-Server: heracles.mxrouting.net" \
|
|
-H "X-Username: itpropar" \
|
|
-H "X-API-Key: Mx8e3b9a108a2188d958741ffd1311K1"
|
|
```
|
|
|
|
Available endpoints (from api.mxroute.com/docs):
|
|
- GET `/domains` — list domains
|
|
- POST `/domains` — add domain
|
|
- GET `/domains/{domain}` — domain details
|
|
- DELETE `/domains/{domain}` — remove domain
|
|
- PATCH `/domains/{domain}/mail-status` — enable/disable mail
|
|
- GET `/verification-key` — domain verification key
|
|
|
|
**Not available through API key:** email account listing, creation, deletion, password resets, quota checks.
|
|
|
|
## DirectAdmin — email account CRUD
|
|
|
|
```bash
|
|
curl -sku "itpropar:__P1NeW=z^Zx" \
|
|
"https://heracles.mxrouting.net:2222/CMD_API_POP?domain=germainebrown.com&action=list"
|
|
```
|
|
|
|
Rate limits from docs: 100 read requests/min, 20 write requests/min.
|
|
|
|
## 9 domains on the account
|
|
|
|
```
|
|
germainebrown.com → g@, shonuff@
|
|
iamgmb.com → garrison@, greyson@
|
|
itpropartner.com → (not on MXroute — SiteGround MX)
|
|
debtrecoveryexperts.com → collections@, dre@, hello@
|
|
boxpilotlogistics.com
|
|
fleettrack360.com
|
|
vigilanttac.com
|
|
voipsimplicity.com
|
|
theunlearningcircle.com
|
|
```
|
|
|
|
## SMTP relay
|
|
|
|
MXroute blocks direct SMTP from our IP. Relay through:
|
|
```text
|
|
mail.germainebrown.com:2525 STARTTLS
|
|
```
|
|
Use per-account email passwords (set via DirectAdmin), NOT the API key or DirectAdmin credentials.
|