Module: TempmailSdk::Providers::Catchmail

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

Overview

Catchmail 渠道 — https://catchmail.io 匿名 REST API：创建邮箱即列表接口，逐封拉取详情

Constant Summary collapse

CHANNEL = 
"catchmail"
API_BASE = 
"https://api.catchmail.io/api/v1"
DEFAULT_DOMAIN = 
"catchmail.io"
DOMAINS = 
%w[catchmail.io mailistry.com zeppost.com].freeze
HEADERS = 
{
  "Accept" => "application/json",
  "Referer" => "https://catchmail.io/",
  "Origin" => "https://catchmail.io",
  "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

.clean_address(value) ⇒ Object

从可能带显示名的地址字段提取纯地址



39
40
41
42
43
44
 
# File 'lib/tempmail_sdk/providers/catchmail.rb', line 39

def clean_address(value)
  value = value.first if value.is_a?(Array)
  text = value.to_s.strip
  m = text.match(/<([^>]+)>/)
  m ? m[1].strip : text
end

.fetch_message(message_id, email) ⇒ Object 



57
58
59
60
61
62
63
64
65
66
 
# File 'lib/tempmail_sdk/providers/catchmail.rb', line 57

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

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

.flatten_detail(raw, recipient) ⇒ Object 



46
47
48
49
50
51
52
53
54
55
 
# File 'lib/tempmail_sdk/providers/catchmail.rb', line 46

def flatten_detail(raw, recipient)
  body = raw["body"].is_a?(Hash) ? raw["body"] : {}
  {
    "id" => raw["id"] || "", "from" => clean_address(raw["from"]),
    "to" => (a = clean_address(raw["to"])).empty? ? recipient : a,
    "subject" => raw["subject"] || "", "text" => body["text"] || "",
    "html" => body["html"] || "", "date" => raw["date"] || "",
    "attachments" => raw["attachments"]
  }
end

.generate_email(domain = nil) ⇒ EmailInfo

Parameters:

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

Returns:



70
71
72
73
74
75
 
# File 'lib/tempmail_sdk/providers/catchmail.rb', line 70

def generate_email(domain = nil)
  email = "#{random_local}@#{pick_domain(domain)}"
  Http.get("#{API_BASE}/mailbox?address=#{URI.encode_www_form_component(email)}",
           headers: HEADERS, timeout: 15).raise_for_status
  EmailInfo.new(channel: CHANNEL, email: email)
end

.get_emails(email) ⇒ Array<Email>

Parameters:

  • email (String)

Returns:



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/tempmail_sdk/providers/catchmail.rb', line 79

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

  resp = Http.get("#{API_BASE}/mailbox?address=#{URI.encode_www_form_component(address)}",
                  headers: HEADERS, timeout: 15)
  resp.raise_for_status
  data = resp.json
  rows = data.is_a?(Hash) ? data["messages"] : 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)
    if detail
      Normalize.normalize_email(flatten_detail(detail, address), address)
    else
      Normalize.normalize_email({
                                  "id" => message_id, "from" => clean_address(item["from"]),
                                  "to" => item["mailbox"] || address,
                                  "subject" => item["subject"] || "", "date" => item["date"] || ""
                                }, address)
    end
  end
end

.pick_domain(preferred) ⇒ Object

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



29
30
31
32
33
34
35
36
 
# File 'lib/tempmail_sdk/providers/catchmail.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/catchmail.rb', line 23

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