ryuzakih / temp-mail-api

Unofficial API Client Library for temp-mail.org in .NET Standard

Temp-Mail-API

Unofficial API Client Library for TempMail in .NET Standard

Disposable email - is a service that allows to receive email at a temporary address that self-destructed after a certain time elapses. It is also known by names like : tempmail, 10minutemail, throwaway email, fake-mail or trash-mail. Many forums, Wi-Fi owners, websites and blogs ask visitors to register before they can view content, post comments or download something. Temp-Mail - is most advanced throwaway email service that helps you avoid spam and stay safe.

Installation

PM> Install-Package TempMail.API

Usage

• Initialize Client

Creates and initializes a new temp-mail client with a temporary email

var client = TempMailClient.Create();

var client = await TempMailClient.CreateAsync();

• Current Email

Gets current temporary email

var email = client.Email;

• Available Domains

Gets available domains

var availableDomains = client.AvailableDomains;

• Change Email

Changes the temporary email to a specific email (ex: login@domain)

client.ChangeEmail("loginexample", availableDomains[0]);

await client.ChangeEmailAsync("loginexample", availableDomains[0]);

• Delete

Deletes the temporary email and gets a new one

client.Delete();

await client.DeleteAsync();

• Refresh

Gets all mails in mailbox

var mails = client.Inbox.Refresh();

var mails = await client.Inbox.RefreshAsync();

• Mailbox

Gets all mails in mailbox (doesn't update from temp-mail)

var mails = client.Inbox.Mails;

• Inbox Auto Check

Checks for incoming mails every period of time

client.StartAutoCheck(delay: 10000); // default delay is 10s

client.StopAutoCheck();

• Events

Occurs when the temporary email changes

client.EmailChanged += (o, e) => Console.WriteLine($"Email changed: {e.Email}");

Occurs when a new mail is received by client

client.Inbox.NewMailReceived += (o, e) => Console.WriteLine($"\tSender: {e.Mail.SenderName}\n\tSubject: {e.Mail.Subject}\n\tBody: {e.Mail.TextBody}");

Additional Features

• Cloudflare Protection

Website sometimes uses Cloudflare protection, so we use CloudflareSolverRe to bypass it.

Sometimes Cloudflare forces captcha challenges or Js challenge cannot be solved, so we need to use CloudflareSolverRe.Captcha package to bypass it using (2captcha or AntiCaptcha)

var client = TempMailClient.Create(
    captchaProvider: new AntiCaptchaProvider("YOUR_API_KEY"));

var client = TempMailClient.Create(
    captchaProvider: new TwoCaptchaProvider("YOUR_API_KEY"));

for more information read the documentation here CloudflareSolverRe

• Proxy

var client = TempMailClient.Create(
    proxy: new WebProxy("163.172.220.221", 8888));

Full Examples Here

Supported Platforms

.NET Standard 1.3

Dependencies

• CloudflareSolverRe
• MimeKitLite

temp-mail-api's Issues

TempMail Ban my ip

Temp mail will ban any ip if u send much requests :(
Can u add Proxy Option Please <3
Thank You.

Response status code: 503

HttpRequestException: Response status code does not indicate success: 503 (Service Temporarily Unavailable).

any help ?

작동하지 않습니다.

작동하지 않습니다.

Enquery about installation

I was trying to install with Install-Package TempMail.API cmd in powershell (normal as well as admin), it didn't work.
Actually, I'm quite new to C#.

This is the attachment.

How to get past this?
Any help..
(PS: I haven't cloned or downloaded the repo files)

Error

Hello!
I use this:

     var client = TempMailClient.Create();
            Console.WriteLine(client.Email);

And I Get error:

Необработанное исключение: System.AggregateException: Произошла одна или несколько ошибок. ---> System.FormatException: Формат значения "<null>" недопустим.
   в System.Net.Http.Headers.HttpHeaderParser.ParseValue(String value, Object storeValue, Int32& index)
   в System.Net.Http.Headers.HttpHeaders.ParseAndAddValue(String name, HeaderStoreItemInfo info, String value)
   в System.Net.Http.Headers.HttpHeaders.Add(String name, String value)
   в CloudflareSolverRe.CloudflareSolver.<>c__DisplayClass30_0.<<Solve>b__0>d.MoveNext()
--- Конец трассировка стека из предыдущего расположения, где возникло исключение ---
   в System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
   в System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
   в CloudflareSolverRe.Utilities.SemaphoreLocker.<LockAsync>d__1`1.MoveNext()
--- Конец трассировка стека из предыдущего расположения, где возникло исключение ---
   в System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
   в System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
   в CloudflareSolverRe.CloudflareSolver.<Solve>d__30.MoveNext()
--- Конец трассировка стека из предыдущего расположения, где возникло исключение ---
   в System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
   в System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
   в CloudflareSolverRe.ClearanceHandler.<GetClearance>d__24.MoveNext()
--- Конец трассировка стека из предыдущего расположения, где возникло исключение ---
   в System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
   в System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
   в CloudflareSolverRe.ClearanceHandler.<SendAsync>d__20.MoveNext()
   --- Конец трассировки внутреннего стека исключений ---
   в System.Threading.Tasks.Task.ThrowIfExceptional(Boolean includeTaskCanceledExceptions)
   в System.Threading.Tasks.Task`1.GetResultCore(Boolean waitCompletionNotification)
   в System.Threading.Tasks.Task`1.get_Result()
   в TempMail.API.Extensions.HttpClientExtensions.GetString(HttpClient client, String requestUri)
   в TempMail.API.TempMailClient.StartSession()
   в TempMail.API.TempMailClient.Create(ICaptchaProvider captchaProvider, IWebProxy proxy)
   в ConsoleApp22.Program.GetEmail() в C:\Users\Антон\source\repos\ConsoleApp22\ConsoleApp22\Program.cs:строка 42
   в ConsoleApp22.Program.Main(String[] args) в C:\Users\Антон\source\repos\ConsoleApp22\ConsoleApp22\Program.cs:строка 19

.