TempMail

API-dokumentation

TempMail API v1 Reference

Basis-URL

https://mail.taohuaxin.top

Godkendelse

Alle endpoints undtagen /config kræver godkendelse.

Tilføj følgende header til alle anmodninger:

x-api-key: tm_your_token_here

Få din token: Dashboard → Indstillinger → API-nøgler

Endpoints

MetodeStiBeskrivelse
GET/api/v1/configServerkonfiguration (offentlig — ingen godkendelse påkrævet)
GET/api/v1/meHent e-mails på tværs af alle dine postkasser (lang polling)
GET/api/v1/inbox/:addressHent e-mails for en enkelt postkasse (lang polling)
DELETE/api/v1/inbox/:addressRyd alle e-mails i en postkasse
GET/api/v1/email/:idHent fuld parset e-mail (tekst + html + vedhæftede filer)
GET/api/v1/email/:id/renderedHent renderet e-mail-tekst
GET/api/v1/email/:id/attachments/:attachmentIdDownload én vedhæftet fil efter ID
DELETE/api/v1/email/:idSlet en enkelt e-mail
GET/api/v1/domainsVis dine brugerdefinerede domæner
POST/api/v1/domainsTilføj et brugerdefineret domæne
DELETE/api/v1/domains/:idFjern et brugerdefineret domæne

docs.examples

GET/api/v1/config

Serverkonfiguration (offentlig — ingen godkendelse påkrævet)

curl https://mail.taohuaxin.top/api/v1/config

docs.response

{
  "domains": ["taohuaxin.top"],
  "smtpPort": 25,
  "smtpsPort": 465,
  "mxPort": 25,
  "version": "1.0.0"
}
GET/api/v1/me

Hent e-mails på tværs af alle dine postkasser (lang polling)

curl -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/me?count=1&limit=20"

docs.response

{
  "emails": [
    {
      "id": "cmcg2a1b40001xyz",
      "fromAddress": "[email protected]",
      "subject": "Your verification code",
      "isRead": false,
      "receivedAt": "2026-07-10T08:30:00.000Z",
      "mailbox": { "address": "alice", "domain": "taohuaxin.top" }
    }
  ],
  "nextSince": "cmcg2a1b40001xyz"
}
GET/api/v1/inbox/:address

Hent e-mails for en enkelt postkasse (lang polling)

curl -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/inbox/[email protected]?since=cmcg2a1b40001xyz&count=1"

docs.response

{
  "emails": [
    {
      "id": "cmcg9f2c80002abc",
      "fromAddress": "[email protected]",
      "subject": "Welcome!",
      "isRead": false,
      "receivedAt": "2026-07-10T09:00:00.000Z"
    }
  ],
  "nextSince": "cmcg9f2c80002abc"
}
DELETE/api/v1/inbox/:address

Ryd alle e-mails i en postkasse

curl -X DELETE -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/inbox/[email protected]"

docs.response

{ "success": true }
GET/api/v1/email/:id

Hent fuld parset e-mail (tekst + html + vedhæftede filer)

curl -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/email/cmcg2a1b40001xyz"

docs.response

{
  "id": "cmcg2a1b40001xyz",
  "fromAddress": "[email protected]",
  "toAddress": "[email protected]",
  "subject": "Your verification code",
  "bodyHtml": "<p>Your code is <b>123456</b></p>",
  "bodyText": "Your code is 123456",
  "isRead": true,
  "receivedAt": "2026-07-10T08:30:00.000Z",
  "attachments": [
    { "id": "att_01", "filename": "invoice.pdf", "mimeType": "application/pdf", "size": 24580 }
  ]
}
GET/api/v1/email/:id/rendered

Hent renderet e-mail-tekst

curl -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/email/cmcg2a1b40001xyz/rendered"

docs.response

From: [email protected]
To: [email protected]
Subject: Your verification code
Date: Fri, 10 Jul 2026 08:30:00 GMT

<p>Your code is <b>123456</b></p>
GET/api/v1/email/:id/attachments/:attachmentId

Download én vedhæftet fil efter ID

curl -OJ -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/email/cmcg2a1b40001xyz/attachments/att_01"

docs.response

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="invoice.pdf"
Content-Length: 24580

<binary file stream>
DELETE/api/v1/email/:id

Slet en enkelt e-mail

curl -X DELETE -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/email/cmcg2a1b40001xyz"

docs.response

{ "success": true }
GET/api/v1/domains

Vis dine brugerdefinerede domæner

curl -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/domains"

docs.response

[
  {
    "id": "dom_01",
    "domain": "mail.example.com",
    "verified": true,
    "receiveMode": "inherit",
    "createdAt": "2026-07-01T00:00:00.000Z"
  }
]
POST/api/v1/domains

Tilføj et brugerdefineret domæne

curl -X POST -H "x-api-key: tm_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"domain":"mail.example.com","receiveMode":"inherit"}' \
  "https://mail.taohuaxin.top/api/v1/domains"

docs.response

{
  "id": "dom_02",
  "domain": "mail.example.com",
  "verified": false,
  "receiveMode": "inherit",
  "createdAt": "2026-07-10T10:00:00.000Z"
}
DELETE/api/v1/domains/:id

Fjern et brugerdefineret domæne

curl -X DELETE -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/domains/dom_02"

docs.response

{ "success": true }

Lang polling

Indbakke-endpoints understøtter lang polling. Kald én gang, og serveren blokerer indtil mail ankommer (op til 25 s). Returnerer 204, hvis ingen mail ankommer før timeout.

Forespørgselsparametre

ParameterBeskrivelse
sinceMarkør fra forrige svar; kun mail efter dette returneres
countReturnér når N nye e-mails er ankommet (standard 1, maks 50)
limitMaksimalt antal e-mails pr. svar (standard 20, maks 50)
fromFilter — returnér kun mail hvor Fra indeholder denne delstreng
subjectFilter — returnér kun mail hvor Emne indeholder denne delstreng

Sletteadfærd

Alle DELETE-operationer er bløde sletninger: slettede elementer er skjult for brugere, men forbliver tilgængelige for administratorer til revisionsformål.