Module: TempmailSdk::Providers::Freecustom

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

Overview

freecustom.email 渠道实现 免注册临时邮箱，任意 local part @ 可用域名即时可收信

Constant Summary collapse

CHANNEL = 
"freecustom"
SITE_URL = 
"https://www.freecustom.email"
DOMAINS_URL = 
"https://api2.freecustom.email/domains"
REFERER = 
"https://www.freecustom.email/en"
DEFAULT_UA = 
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " \
"(KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36"

Class Method Summary collapse

Class Method Details

.fetch_auth_token ⇒ Object

获取匿名访问令牌



56
57
58
59
60
61
62
63
64
65
66
67
68
69
 
# File 'lib/tempmail_sdk/providers/freecustom.rb', line 56

def fetch_auth_token
  resp = Http.post(
    "#{SITE_URL}/api/auth",
    headers: {
      "User-Agent" => get_ua, "Accept" => "application/json",
      "Content-Type" => "application/json", "Referer" => REFERER
    }
  )
  resp.raise_for_status
  data = resp.json
  raise "freecustom: invalid token response" unless data.is_a?(Hash) && !data["token"].to_s.empty?

  data["token"].to_s
end

.first_val(msg, *keys) ⇒ Object 



27
28
29
30
31
32
33
 
# File 'lib/tempmail_sdk/providers/freecustom.rb', line 27

def first_val(msg, *keys)
  keys.each do |key|
    val = msg[key]
    return val.to_s if !val.nil? && val != ""
  end
  ""
end

.generate_email ⇒ EmailInfo

Returns:



72
73
74
75
76
 
# File 'lib/tempmail_sdk/providers/freecustom.rb', line 72

def generate_email
  domain = pick_domain
  email = "#{random_local}@#{domain}"
  EmailInfo.new(channel: CHANNEL, email: email, token: email)
end

.get_emails(email) ⇒ Array<Email>

Parameters:

  • email (String)

Returns:



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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
 
# File 'lib/tempmail_sdk/providers/freecustom.rb', line 80

def get_emails(email)
  addr = email.to_s.strip
  raise "freecustom: missing email" if addr.empty?

  jwt = fetch_auth_token
  auth_headers = {
    "User-Agent" => get_ua, "Accept" => "application/json",
    "Referer" => REFERER, "Authorization" => "Bearer #{jwt}",
    "x-fce-client" => "web-client"
  }

  list_resp = Http.get(
    "#{SITE_URL}/api/public-mailbox?fullMailboxId=#{URI.encode_www_form_component(addr)}",
    headers: auth_headers
  )
  list_resp.raise_for_status
  list_data = list_resp.json
  return [] unless list_data.is_a?(Hash) && list_data["success"]

  items = list_data["data"]
  return [] unless items.is_a?(Array)

  items.select { |i| i.is_a?(Hash) && i["id"] }.map do |item|
    msg_id = item["id"].to_s
    full = item
    begin
      msg_resp = Http.get(
        "#{SITE_URL}/api/public-mailbox?fullMailboxId=#{URI.encode_www_form_component(addr)}" \
        "&messageId=#{URI.encode_www_form_component(msg_id)}",
        headers: auth_headers
      )
      if msg_resp.ok?
        msg_data = msg_resp.json
        if msg_data.is_a?(Hash) && msg_data["success"] && msg_data["data"].is_a?(Hash)
          full = msg_data["data"]
        end
      end
    rescue StandardError
      # 正文补全失败时退回列表元数据
    end

    row = {
      "id" => first_val(full, "id"),
      "from" => first_val(full, "from"),
      "to" => first_val(full, "to").empty? ? addr : first_val(full, "to"),
      "subject" => first_val(full, "subject"),
      "text" => first_val(full, "text"),
      "html" => first_val(full, "html"),
      "date" => first_val(full, "date")
    }
    Normalize.normalize_email(row, addr)
  end
end

.get_ua ⇒ Object 



17
18
19
20
 
# File 'lib/tempmail_sdk/providers/freecustom.rb', line 17

def get_ua
  cfg = Config.get_config
  (cfg.headers || {})["User-Agent"] || DEFAULT_UA
end

.pick_domain ⇒ Object

挑选一个可收信域名



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
 
# File 'lib/tempmail_sdk/providers/freecustom.rb', line 36

def pick_domain
  resp = Http.get(
    DOMAINS_URL,
    headers: { "User-Agent" => get_ua, "Accept" => "application/json", "Referer" => REFERER }
  )
  resp.raise_for_status
  data = resp.json
  lst = data.is_a?(Hash) ? data["data"] : nil
  raise "freecustom: domain list empty" unless lst.is_a?(Array) && !lst.empty?

  usable = lst.select do |d|
    d.is_a?(Hash) && d["tier"] == "free" && d["expiring_soon"] != true && !d["domain"].to_s.empty?
  end
  pool = usable.empty? ? lst.select { |d| d.is_a?(Hash) && !d["domain"].to_s.empty? } : usable
  raise "freecustom: no usable domain" if pool.empty?

  pool.sample["domain"].to_s
end

.random_local(n = 10) ⇒ Object 



22
23
24
25
 
# File 'lib/tempmail_sdk/providers/freecustom.rb', line 22

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