Check if an email address exists without sending any email, written in Rust. Comes with a ⚙️ HTTP backend.
Rust emailemail-validationemail-validation-apiemail-verificationemail-verification-apiemail-verifierhacktoberfest
use super::SmtpDetails;
use crate::EmailAddress;
use crate::LOG_TARGET;
use crate::{
smtp::http_api::create_client,
util::{input_output::CheckEmailInput, ser_with_display::ser_with_display},
};
use reqwest::Error as ReqwestError;
use serde::Serialize;
use thiserror::Error;
const GLXU_PAGE: &str = "https://mail.google.com/mail/gxlu";
/// Possible errors when checking Gmail email addresses.
#[derive(Debug, Error, Serialize)]
pub enum GmailError {
/// Error when serializing or deserializing HTTP requests and responses.
#[serde(serialize_with = "ser_with_display")]
#[error("Error serializing or deserializing HTTP requests and responses: {0}")]
ReqwestError(ReqwestError),
}
impl From<ReqwestError> for GmailError {
fn from(error: ReqwestError) -> Self {
GmailError::ReqwestError(error)
}
}
#[allow(dead_code)]
/// Use HTTP request to verify if a Gmail email address exists.
/// See: <https://blog.0day.rocks/abusing-gmail-to-get-previously-unlisted-e-mail-addresses-41544b62b2>
///
/// This method doesn't work anymore, as Google has patched the vulnerability,
/// but it's kept here for historical reasons.
#[deprecated]
pub async fn check_gmail_via_api(
to_email: &EmailAddress,
input: &CheckEmailInput,
) -> Result<SmtpDetails, GmailError> {
let response = create_client(input, "gmail")?
.head(GLXU_PAGE)
.query(&[("email", to_email)])
.send()
.await?;
let email_exists = response.headers().contains_key("Set-Cookie");
tracing::debug!(
target: LOG_TARGET,
email = %to_email,
response = ?response,
"Gmail API response"
);
Ok(SmtpDetails {
can_connect_smtp: true,
is_deliverable: email_exists,
..Default::default()
})
}
#[cfg(test)]
mod tests {
use super::*;
use crate::CheckEmailInputBuilder;
use std::str::FromStr;
#[tokio::test]
#[ignore] // ref: https://github.com/reacherhq/check-if-email-exists/issues/1431
async fn should_return_is_deliverable_true() {
let to_email = EmailAddress::from_str("[email protected]").unwrap();
let input = CheckEmailInputBuilder::default()
.to_email("[email protected]".to_owned())
.build()
.unwrap();
#[allow(deprecated)]
let smtp_details = check_gmail_via_api(&to_email, &input).await;
assert!(smtp_details.is_ok());
assert!(smtp_details.unwrap().is_deliverable);
}
}