Module: TempmailSdk::Providers::Mailforspam

Defined in:
lib/tempmail_sdk/providers/mailforspam.rb

Overview

MailForSpam 渠道 — https://mailforspam.com 匿名 REST API：邮箱列表接口 + 逐封详情

Constant Summary collapse

CHANNEL = 
"mailforspam"
API_BASE = 
"https://api.mailforspam.com/api"
DEFAULT_DOMAIN = 
"mailforspam.com"
DOMAINS = 
%w[mailforspam.com tempmail.io disposable.email].freeze
HEADERS = 
{
  "Accept" => "application/json",
  "Referer" => "https://mailforspam.com/",
  "Origin" => "https://mailforspam.com",
  "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36 Edg/146.0.0.0"
}.freeze

Class Method Summary collapse

Class Method Details

.fetch_message(message_id, email) ⇒ Object 



53
54
55
56
57
58
59
60
61
62
 
# File 'lib/tempmail_sdk/providers/mailforspam.rb', line 53

def fetch_message(message_id, email)
  resp = Http.get(
    "#{API_BASE}/mailboxes/#{URI.encode_www_form_component(email)}/emails/#{URI.encode_www_form_component(message_id)}",
    headers: HEADERS, timeout: 15
  )
  return nil unless resp.ok?

  data = resp.json
  data.is_a?(Hash) ? data : nil
end

.flatten(raw, recipient) ⇒ Object 



43
44
45
46
47
48
49
50
51
 
# File 'lib/tempmail_sdk/providers/mailforspam.rb', line 43

def flatten(raw, recipient)
  {
    "id" => raw["id"] || "", "from" => raw["sender"] || "",
    "to" => raw["receiver"] || recipient, "subject" => raw["subject"] || "",
    "text" => raw["body_text"] || "", "html" => raw["body_html"] || "",
    "date" => raw["date"] || "", "isRead" => !raw["readAt"].nil?,
    "attachments" => raw["attachments"]
  }
end

.generate_email(domain = nil) ⇒ EmailInfo

Parameters:

  • domain (String, nil) (defaults to: nil)

Returns:



66
67
68
69
70
 
# File 'lib/tempmail_sdk/providers/mailforspam.rb', line 66

def generate_email(domain = nil)
  email = "#{random_local}@#{pick_domain(domain)}"
  Http.get(mailbox_emails_url(email, 1), headers: HEADERS, timeout: 15).raise_for_status
  EmailInfo.new(channel: CHANNEL, email: email)
end

.get_emails(email) ⇒ Array<Email>

Parameters:

  • email (String)

Returns:



74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
 
# File 'lib/tempmail_sdk/providers/mailforspam.rb', line 74

def get_emails(email)
  address = email.to_s.strip
  raise "mailforspam: empty email" if address.empty?

  resp = Http.get(mailbox_emails_url(address, 100), headers: HEADERS, timeout: 15)
  resp.raise_for_status
  data = resp.json
  rows = data.is_a?(Hash) ? data["emails"] : nil
  return [] unless rows.is_a?(Array)

  rows.filter_map do |item|
    next unless item.is_a?(Hash)

    message_id = item["id"].to_s.strip
    next if message_id.empty?

    detail = fetch_message(message_id, address)
    Normalize.normalize_email(flatten(detail || item, address), address)
  end
end

.mailbox_emails_url(email, page_size = 100) ⇒ Object 



38
39
40
41
 
# File 'lib/tempmail_sdk/providers/mailforspam.rb', line 38

def mailbox_emails_url(email, page_size = 100)
  "#{API_BASE}/mailboxes/#{URI.encode_www_form_component(email)}/emails" \
    "?page=1&page_size=#{page_size}&sort_by=date&sort_order=desc"
end

.pick_domain(preferred) ⇒ Object

选择域名：命中别名域名则用之，否则默认域名



29
30
31
32
33
34
35
36
 
# File 'lib/tempmail_sdk/providers/mailforspam.rb', line 29

def pick_domain(preferred)
  p = preferred.to_s.strip.sub(/\A@/, "").downcase
  unless p.empty?
    found = DOMAINS.find { |d| d.downcase == p }
    return found if found
  end
  DEFAULT_DOMAIN
end

.random_local ⇒ Object 



23
24
25
26
 
# File 'lib/tempmail_sdk/providers/mailforspam.rb', line 23

def random_local
  chars = ("a".."z").to_a + ("0".."9").to_a
  "sdk#{Array.new(16) { chars.sample }.join}"
end