> For the complete documentation index, see [llms.txt](https://reno.gitbook.io/smtp-py/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://reno.gitbook.io/smtp-py/readme.md).

# Welcome

`smtp-py` là Python client cho smtp.dev API.

Bạn dùng nó để quản lý:

* Domains
* Accounts
* Mailboxes
* Messages (bao gồm source, move, download attachment)
* API Tokens

### Checklist bắt đầu nhanh

* [ ] Cài package: xem [Installing](/smtp-py/getting-started/publish-your-docs.md)
* [ ] Tạo API key tại `https://smtp.dev/tokens/`
* [ ] Set `XAPIKEY` hoặc `X_API_KEY` (hoặc truyền `api_key` trực tiếp)
* [ ] Khởi tạo `SMTPDevClient`
* [ ] Gọi thử `list_domains()` hoặc `list_accounts()`

### Điều hướng nhanh

<table data-view="cards"><thead><tr><th>Chủ đề</th><th data-card-target data-type="content-ref">Mở</th></tr></thead><tbody><tr><td><strong>Installing</strong></td><td><a href="/smtp-py/getting-started/publish-your-docs.md">Installing</a></td></tr><tr><td><strong>Usage</strong></td><td><a href="/smtp-py/getting-started/usage.md">Usage</a></td></tr><tr><td><strong>Client setup</strong></td><td><a href="/smtp-py/getting-started/client-setup.md">Client setup</a></td></tr><tr><td><strong>Domain APIs</strong></td><td><a href="/smtp-py/domain/usage.md">Domain</a></td></tr><tr><td><strong>Account APIs</strong></td><td><a href="/smtp-py/account/usage.md">Account</a></td></tr><tr><td><strong>Mailbox APIs</strong></td><td><a href="/smtp-py/mailboxes/usage.md">Mailboxes</a></td></tr><tr><td><strong>Message APIs</strong></td><td><a href="/smtp-py/messages/usage.md">Messages</a></td></tr><tr><td><strong>Token APIs</strong></td><td><a href="/smtp-py/tokens/list-tokens.md">Tokens</a></td></tr></tbody></table>

{% hint style="info" %}
Tất cả ví dụ bên dưới dùng API kiểu mới: `SMTPDevClient` + method dạng `snake_case`.
{% endhint %}