adding in email api

Author: Adam Valverde

FullContactDotNet/Entities/DisposableEmailResponse.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace FullContactDotNet.Entities
+{
+    public class DisposableEmailResponse : FullContactResponse
+    {
+        /// <summary>
+        /// Gets or sets the username sub addressing.
+        /// </summary>
+        /// <value>
+        /// The username sub addressing.
+        /// </value>
+        public string UsernameSubAddressing { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether [disposable email domain].
+        /// </summary>
+        /// <value>
+        /// <c>true</c> if [disposable email domain]; otherwise, <c>false</c>.
+        /// </value>
+        public bool DisposableEmailDomain { get; set; }
+    }
+}

FullContactDotNet/Entities/FullContactResponse.cs

@@ -12,14 +12,6 @@ public class FullContactResponse
         /// </value>
         public HttpStatusCode Status { get; set; }
 
-        /// <summary>
-        /// Gets or sets the request identifier.
-        /// </summary>
-        /// <value>
-        /// The request identifier.
-        /// </value>
-        public string RequestId { get; set; }
-
         /// <summary>
         /// Gets or sets the message.
         /// </summary>

FullContactDotNet/Entities/Person.cs renamed to FullContactDotNet/Entities/PersonResponse.cs

@@ -2,8 +2,16 @@
 
 namespace FullContactDotNet.Entities
 {
-    public class Person : FullContactResponse
+    public class PersonResponse : FullContactResponse
     {
+        /// <summary>
+        /// Gets or sets the request identifier.
+        /// </summary>
+        /// <value>
+        /// The request identifier.
+        /// </value>
+        public string RequestId { get; set; }
+
         /// <summary>
         /// Gets or sets the likelihood that the person provided matches the person requested.
         /// </summary>

FullContactDotNet/FullContactDotNet.csproj

@@ -54,6 +54,7 @@
     <Compile Include="Entities\County.cs" />
     <Compile Include="Entities\Demographics.cs" />
     <Compile Include="Entities\DigitalFootprint.cs" />
+    <Compile Include="Entities\DisposableEmailResponse.cs" />
     <Compile Include="Entities\FullContactResponse.cs" />
     <Compile Include="Entities\LocationDeduced.cs" />
     <Compile Include="Entities\Organization.cs" />
@@ -64,11 +65,13 @@
     <Compile Include="Entities\Topic.cs" />
     <Compile Include="Entities\Website.cs" />
     <Compile Include="FullContactApi.cs" />
+    <Compile Include="FullContactEmailApi.cs" />
     <Compile Include="FullContactPersonApi.cs" />
     <Compile Include="FullContactApiException.cs" />
     <Compile Include="FullContactConfiguration.cs" />
+    <Compile Include="IFullContactEmailApi.cs" />
     <Compile Include="IFullContactPersonApi.cs" />
-    <Compile Include="Entities\Person.cs" />
+    <Compile Include="Entities\PersonResponse.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
   </ItemGroup>
   <ItemGroup>

FullContactDotNet/FullContactEmailApi.cs

@@ -0,0 +1,35 @@
+using FullContactDotNet.Entities;
+using RestSharp;
+using System;
+
+namespace FullContactDotNet
+{
+    public class FullContactEmailApi : FullContactApi, IFullContactEmailApi
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="FullContactEmailApi"/> class.
+        /// </summary>
+        public FullContactEmailApi() : base(FullContactConfiguration.ApiKey) { }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="FullContactEmailApi"/> class.
+        /// </summary>
+        /// <param name="apiKey">The API key.</param>
+        public FullContactEmailApi(string apiKey) : base(apiKey) { }
+
+        /// <summary>
+        /// Detects the disposable email.
+        /// </summary>
+        /// <param name="emailAddress">The email address.</param>
+        /// <returns></returns>
+        /// <exception cref="System.ArgumentNullException">A email address is required to lookup a person by email.</exception>
+        public DisposableEmailResponse DetectDisposableEmail(string emailAddress)
+        {
+            if (string.IsNullOrEmpty(emailAddress)) throw new ArgumentNullException("A email address is required to lookup a person by email.");
+
+            var request = new RestRequest("/email.json", Method.GET);
+            request.AddParameter("email", emailAddress);
+            return Execute<DisposableEmailResponse>(request);
+        }
+    }
+}

FullContactDotNet/FullContactPersonApi.cs

@@ -25,13 +25,13 @@ public FullContactPersonApi(string apiKey) : base(apiKey) { }
         /// <param name="webhookUrl">The webhook url.</param>
         /// <returns></returns>
         /// <exception cref="System.ArgumentNullException">A email address is required to lookup a person by email.</exception>
-        public Person LookupPersonByEmail(string emailAddress, int? queue = null, string webhookUrl = null)
+        public PersonResponse LookupPersonByEmail(string emailAddress, int? queue = null, string webhookUrl = null)
         {
             if (string.IsNullOrEmpty(emailAddress)) throw new ArgumentNullException("A email address is required to lookup a person by email.");
 
             var request = GetPersonRequest(queue, webhookUrl);
             request.AddParameter("email", emailAddress);
-            return Execute<Person>(request);
+            return Execute<PersonResponse>(request);
         }
 
         /// <summary>
@@ -43,7 +43,7 @@ public Person LookupPersonByEmail(string emailAddress, int? queue = null, string
         /// <param name="webhookUrl">The webhook url.</param>
         /// <returns></returns>
         /// <exception cref="System.ArgumentNullException">A phone number is required to lookup a person by twitter.</exception>
-        public Person LookupPersonByPhone(string phoneNumber, string countryCode = null, int? queue = null, string webhookUrl = null)
+        public PersonResponse LookupPersonByPhone(string phoneNumber, string countryCode = null, int? queue = null, string webhookUrl = null)
         {
             if (string.IsNullOrEmpty(phoneNumber)) throw new ArgumentNullException("A phone number is required to lookup a person by twitter.");
 
@@ -57,7 +57,7 @@ public Person LookupPersonByPhone(string phoneNumber, string countryCode = null,
                 request.AddParameter("countryCode", countryCode);
             }
 
-            return Execute<Person>(request);
+            return Execute<PersonResponse>(request);
         }
 
         /// <summary>
@@ -68,13 +68,13 @@ public Person LookupPersonByPhone(string phoneNumber, string countryCode = null,
         /// <param name="webhookUrl">The webhook url.</param>
         /// <returns></returns>
         /// <exception cref="System.ArgumentNullException">A twitter username is required to lookup a person by twitter.</exception>
-        public Person LookupPersonByTwitter(string twitterUsername, int? queue = null, string webhookUrl = null)
+        public PersonResponse LookupPersonByTwitter(string twitterUsername, int? queue = null, string webhookUrl = null)
         {
             if (string.IsNullOrEmpty(twitterUsername)) throw new ArgumentNullException("A twitter username is required to lookup a person by twitter.");
 
             var request = GetPersonRequest(queue, webhookUrl);
             request.AddParameter("twitter", twitterUsername);
-            return Execute<Person>(request);
+            return Execute<PersonResponse>(request);
         }
 
         /// <summary>
@@ -85,13 +85,13 @@ public Person LookupPersonByTwitter(string twitterUsername, int? queue = null, s
         /// <param name="webhookUrl">The webhook url.</param>
         /// <returns></returns>
         /// <exception cref="System.ArgumentNullException">A facebook username is required to lookup a person by facebook.</exception>
-        public Person LookupPersonByFacebook(string facebookUsername, int? queue = null, string webhookUrl = null)
+        public PersonResponse LookupPersonByFacebook(string facebookUsername, int? queue = null, string webhookUrl = null)
         {
             if (string.IsNullOrEmpty(facebookUsername)) throw new ArgumentNullException("A facebook username is required to lookup a person by facebook.");
 
             var request = GetPersonRequest(queue, webhookUrl);
             request.AddParameter("facebookUsername", facebookUsername);
-            return Execute<Person>(request);
+            return Execute<PersonResponse>(request);
         }
 
         /// <summary>

FullContactDotNet/IFullContactEmailApi.cs

@@ -0,0 +1,14 @@
+using FullContactDotNet.Entities;
+
+namespace FullContactDotNet
+{
+    public interface IFullContactEmailApi
+    {
+        /// <summary>
+        /// Detects the disposable email.
+        /// </summary>
+        /// <param name="emailAddress">The email address.</param>
+        /// <returns></returns>
+        DisposableEmailResponse DetectDisposableEmail(string emailAddress);
+    }
+}

FullContactDotNet/IFullContactPersonApi.cs

@@ -11,7 +11,7 @@ public interface IFullContactPersonApi
         /// <param name="queue">The queue.</param>
         /// <param name="webhookUrl">The webhook url.</param>
         /// <returns></returns>
-        Person LookupPersonByEmail(string emailAddress, int? queue = null, string webhookUrl = null);
+        PersonResponse LookupPersonByEmail(string emailAddress, int? queue = null, string webhookUrl = null);
 
         /// <summary>
         /// Lookup Person by phone number.
@@ -21,7 +21,7 @@ public interface IFullContactPersonApi
         /// <param name="queue">The queue.</param>
         /// <param name="webhookUrl">The webhook url.</param>
         /// <returns></returns>
-        Person LookupPersonByPhone(string phoneNumber, string countryCode = null, int? queue = null, string webhookUrl = null);
+        PersonResponse LookupPersonByPhone(string phoneNumber, string countryCode = null, int? queue = null, string webhookUrl = null);
 
         /// <summary>
         /// Lookup Person by twitter username.
@@ -30,7 +30,7 @@ public interface IFullContactPersonApi
         /// <param name="queue">The queue.</param>
         /// <param name="webhookUrl">The webhook url.</param>
         /// <returns></returns>
-        Person LookupPersonByTwitter(string twitterUsername, int? queue = null, string webhookUrl = null);
+        PersonResponse LookupPersonByTwitter(string twitterUsername, int? queue = null, string webhookUrl = null);
 
         /// <summary>
         /// Lookup Person by facebook username.
@@ -39,6 +39,6 @@ public interface IFullContactPersonApi
         /// <param name="queue">The queue.</param>
         /// <param name="webhookUrl">The webhook url.</param>
         /// <returns></returns>
-        Person LookupPersonByFacebook(string facebookUsername, int? queue = null, string webhookUrl = null);
+        PersonResponse LookupPersonByFacebook(string facebookUsername, int? queue = null, string webhookUrl = null);
     }
 }