A mail.tm / mail.gw API wrapper for .NET. These services currently have identical APIs, but this may change in the future.
Available as a NuGet.
PM> Install-Package SmorcIRL.TempMail
mail.tm is a great temporary/disposable mail service, and recently a new 10 minute mail service called mail.gw was also launched. As I said, these two services have identical API's, so everything said about mail.tm will also apply to mail.gw (at least it was the last time I compared Swagger configs). Basically all API calls require authorisation, but some do not (e.g. getting domain info). If you have an authorised MailClient instance, you can get its authorisation token via the BearerToken property, which can be useful for manual debugging using Swagger.
Interaction with account API is performed through a MailClient instance. You can simply register like this
MailClient client = new MailClient();
await client.Register("pepethefrog@sad.me", "*password*");You can also specify the base api url. The default refers to mail.tm, but if you want to use mail.gw, create a client like this
MailClient client = new MailClient(new Uri("https://api.mail.gw/"));Make sure you specify the domain correctly - the list of domains is limited by the service. You can get an up-to-date list using
DomainInfo[] domains = await client.GetAvailableDomains();If you just need to get any valid domain name for your account
string domain = await client.GetFirstAvailableDomainName();There is also an option to generate a new account. Note that it won't be possible to recover the password if you omit it.
await client.GenerateAccount("*optional_password*");If you already have an account, you can log in using your creds
await client.Login("pepethefrog@sad.me", "*password*");If you have an auth token, you can use it instead
await client.LoginWithToken("*token*");If you need to get info about the account you are using, such as creation date or message quota, call
AccountInfo info = await client.GetAccountInfo();Once you are finished with the account, you can delete it
await client.DeleteAccount();After that you can reuse the client instance with a new authorisation via Login()/Register() if needed.
- Get info about all messages
MessageInfo[] messages = await client.GetAllMessages();- Get info about all messages from the page
MessageInfo[] messages = await client.GetMessages(*page*);- Get message info by id
MessageInfo message = await client.GetMessage("*id*");- Get message source
MessageSource source = await client.GetMessageSource("*id*");
string rawMessage = source.Data;- Mark as seen
await client.MarkMessageAsSeen("*id*", true);- Delete
await client.DeleteMessage("*id*");