API don Imel na Wucin Gadi

REST API haɗaɗɗen don masu haɓakawa: ƙirƙiri adiresoshin temp mail, karɓi ainihin imel.

Mail.td shine kayan aikin imel ga masu haɓakawa, tare da REST API haɗaɗɗen don ƙirƙirar adiresoshin temporary email, karɓar ainihin imel, da isar da sabbin saƙonni cikin ainihin lokaci ta WebSocket ko Webhook da aka sanya hannu. API kyauta ce don farawa — tana aiki da kowane HTTP client. Kira ta kai tsaye daga gwaje-gwajen Selenium, Cypress, Playwright, Puppeteer, pipeline na CI/CD, ko backend ɗinka.

Tafiyar Aiki

Ƙirƙiri akwatin saƙo, karɓi imel na hakika ta SMTP, kuma karanta saƙonni ta REST API. Akwatunan saƙo suna ƙare ta atomatik bayan kwanaki 7.

# 1. Create a mailbox
$ curl -X POST https://api.mail.td/api/accounts \
    -H "Authorization: Bearer td_xxx" \
    -d '{"address":"user@mail.td","password":"secret"}'
→ { "id": "a1b2c3d4-...", "address": "user@mail.td" }

# 2. List incoming messages
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages \
    -H "Authorization: Bearer td_xxx"
→ { "messages": [ { "id": "f5e6d7c8-...", "from": "...", "subject": "...", "created_at": "..." } ] }

# 3. Read a message
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages/f5e6d7c8-... \
    -H "Authorization: Bearer td_xxx"
→ { "from": "...", "subject": "...", "text_body": "...", "html_body": "...", "attachments": [...] }

SDK da Ɗakunan Karatun Client

Mail.td yana ba da SDKs na hukuma a cikin harsuna uku. Kowane client yana rufe REST API gaba ɗaya tare da martani masu nau'i da sarrafa kuskure — girka, tabbatar da Pro API Token, kuma fara amfani da shi.

Node.js / TypeScript

npm install mailtd

Client mara dogaro da ke amfani da fetch na asali, tare da cikakkun ma'anar nau'in TypeScript.

Python

pip install mailtd

Client dangane da HTTP tare da nau'ikan dataclass da tallafin async context manager.

Go

go get github.com/mailtd/mailtd-go

stdlib kawai, zagayowar rayuwar buƙatun da aka kafa ta context, tare da struct masu cikakken nau'i.

Muhimman Bayanai Imel na tsarin Pro ana ajiye su har kwanaki 7, sannan a goge su ta atomatik (don lokacin ajiya na tsarin kyauta duba shafin farashi). An ƙirƙira Mail.td don gwajin imel, sarrafa QA, da amfani na ɗan lokaci na masu haɓakawa — ba a matsayin akwatin saƙo na dogon lokaci ba.