tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/ockito.rb

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # ockito 渠道实现
+    # API: https://ockito.com/web-api
+    # 流程: 获取 gtoken -> 获取邮箱 -> 用 Bearer token 收信
+    module Ockito
+      CHANNEL = "ockito"
+      BASE_URL = "https://ockito.com/web-api"
+
+      DEFAULT_HEADERS = {
+        "Accept" => "application/json",
+        "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"
+      }.freeze
+
+      module_function
+
+      # 请求并解析 JSON
+      def fetch_json(path, method: :get, headers: nil, payload: nil)
+        request_headers = DEFAULT_HEADERS.dup
+        request_headers.merge!(headers) if headers
+
+        resp = if method == :post
+                 Http.post("#{BASE_URL}#{path}", headers: request_headers, json: payload || {})
+               else
+                 Http.get("#{BASE_URL}#{path}", headers: request_headers)
+               end
+
+        text = resp.body || ""
+        data = text.empty? ? {} : JSON.parse(text)
+        raise "ockito http #{resp.status_code}" unless resp.ok?
+
+        [resp.status_code, data.is_a?(Hash) ? data : {}]
+      end
+
+      # 打包 token
+      def pack_token(access_token, refresh_token)
+        JSON.generate({ "access_token" => access_token, "refresh_token" => refresh_token })
+      end
+
+      # 解包 token
+      def unpack_token(token)
+        value = token.to_s.strip
+        raise "ockito: 无效的会话 token" if value.empty? || !value.start_with?("{")
+
+        data = JSON.parse(value)
+        raise "ockito: 无效的会话 token" unless data.is_a?(Hash)
+
+        access = data["access_token"].to_s.strip
+        refresh = data["refresh_token"].to_s.strip
+        raise "ockito: 无效的会话 token" if access.empty? || refresh.empty?
+
+        [access, refresh]
+      end
+
+      # 刷新 access token
+      def refresh_access_token(refresh_token)
+        _, data = fetch_json("/grefresh", method: :post,
+                                          headers: { "Authorization" => "Bearer #{refresh_token}", "X-PASSTHROUGH" => "Y" })
+        access = data["access_token"].to_s.strip
+        raise "ockito: 刷新 token 失败" if access.empty?
+
+        access
+      end
+
+      # 带 Bearer 认证的请求（401 时自动刷新重试）
+      def fetch_bearer_json(path, access_token, refresh_token)
+        _, data = fetch_json(path, headers: { "Authorization" => "Bearer #{access_token}" })
+        data
+      rescue RuntimeError => e
+        raise unless e.message.include?("401")
+
+        refreshed = refresh_access_token(refresh_token)
+        _, data = fetch_json(path, headers: { "Authorization" => "Bearer #{refreshed}" })
+        data
+      end
+
+      # 扁平化收件箱行
+      def flatten_inbox_row(raw, recipient)
+        {
+          "id" => (raw["uid"] || "").to_s,
+          "from" => (raw["sender"] || "").to_s,
+          "to" => recipient,
+          "subject" => (raw["subject"] || "").to_s,
+          "text" => (raw["snippet"] || "").to_s,
+          "html" => (raw["html"] || "").to_s,
+          "date" => (raw["timestamp"] || "").to_s,
+          "is_read" => false,
+          "attachments" => []
+        }
+      end
+
+      # 扁平化邮件详情
+      def flatten_message(raw, recipient)
+        obj = raw["obj"].is_a?(Hash) ? raw["obj"] : raw
+        {
+          "id" => (raw["uid"] || "").to_s,
+          "from" => (obj["sender_email"] || obj["SenderEmail"] || obj["from_"] || obj["From"] || obj["from"] || obj["sender_name"] || obj["SenderName"] || "").to_s,
+          "to" => (obj["to"] || obj["To"] || recipient).to_s,
+          "subject" => (obj["subject"] || obj["Subject"] || "").to_s,
+          "text" => (obj["text"] || "").to_s,
+          "html" => (obj["html"] || "").to_s,
+          "date" => (obj["date"] || obj["Date"] || "").to_s,
+          "is_read" => false,
+          "attachments" => []
+        }
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        _, login = fetch_json("/gtoken", method: :post, payload: {})
+        access_token = login["access_token"].to_s.strip
+        refresh_token = login["refresh_token"].to_s.strip
+        raise "ockito: 无效的 token 响应" if access_token.empty? || refresh_token.empty?
+
+        _, email_data = fetch_json("/email", headers: { "Authorization" => "Bearer #{access_token}" })
+        email_value = email_data["email"]
+        email = if email_value.is_a?(String)
+                  email_value.strip
+                elsif email_value.is_a?(Hash)
+                  (email_value["email"] || "").to_s.strip
+                else
+                  ""
+                end
+        raise "ockito: 无效的邮箱响应" if email.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: pack_token(access_token, refresh_token))
+      end
+
+      # 获取邮件列表
+      # @param token [String] JSON 编码的 access+refresh token
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        access_token, refresh_token = unpack_token(token)
+        address = email.to_s.strip
+        raise "ockito: 邮箱地址为空" if address.empty?
+
+        data = fetch_bearer_json("/retrieve/#{URI.encode_www_form_component(address)}/emails", access_token, refresh_token)
+        rows = data["inbox"]
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |row| row.is_a?(Hash) }.map do |row|
+          uid = row["uid"].to_s.strip
+          if uid.empty?
+            Normalize.normalize_email(flatten_inbox_row(row, address), address)
+          else
+            begin
+              detail = fetch_bearer_json("/retrieve/#{URI.encode_www_form_component(address)}/#{URI.encode_www_form_component(uid)}", access_token, refresh_token)
+              Normalize.normalize_email(flatten_message(detail, address), address)
+            rescue StandardError
+              Normalize.normalize_email(flatten_inbox_row(row, address), address)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/one_sec_mail.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # 1SecMail 渠道 — https://tmaily.com
+    module OneSecMail
+      CHANNEL = "1sec-mail"
+      BASE_URL = "https://tmaily.com/"
+      HEADERS = { "Accept" => "application/json", "User-Agent" => "Mozilla/5.0" }.freeze
+
+      module_function
+
+      # 生成临时邮箱，从 Set-Cookie 提取会话 Cookie
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{BASE_URL}generate", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        cookie_val = resp.cookie_value("TMaily_sid")
+        raise "1sec-mail: 未获取到会话 Cookie" if cookie_val.nil? || cookie_val.empty?
+
+        cookie = "TMaily_sid=#{cookie_val}"
+        data = resp.json
+        email = data.is_a?(Hash) ? data["address"].to_s.strip : ""
+        raise "1sec-mail: 无效的邮箱响应" unless email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: cookie)
+      end
+
+      # @param email [String]
+      # @param token [String] 会话 Cookie
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        address = email.to_s.strip
+        raise "1sec-mail: 邮箱地址为空" if address.empty?
+
+        resp = Http.get("#{BASE_URL}emails?address=#{address}",
+                        headers: HEADERS.merge("Cookie" => token.to_s), timeout: 15)
+        resp.raise_for_status
+        rows = resp.json
+        raise "1sec-mail: 无效的邮件列表响应" unless rows.is_a?(Array)
+
+        rows.select { |r| r.is_a?(Hash) }.map { |item| Normalize.normalize_email(item, address) }
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/restmail_net.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # restmail-net 渠道 — https://restmail.net
+    # Mozilla 开源项目，无需创建邮箱，ad-hoc 模式
+    module RestmailNet
+      CHANNEL = "restmail-net"
+      BASE_URL = "https://restmail.net"
+      HEADERS = {
+        "Accept" => "application/json",
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36"
+      }.freeze
+
+      module_function
+
+      def random_username
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(rand(10..12)) { chars.sample }.join
+      end
+
+      # 创建邮箱：随机 username 即可使用，无需请求服务端
+      # @return [EmailInfo]
+      def generate_email
+        EmailInfo.new(channel: CHANNEL, email: "#{random_username}@restmail.net")
+      end
+
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        address = email.to_s.strip
+        raise "restmail-net: 邮箱地址为空" if address.empty?
+
+        username = address.split("@").first.to_s
+        raise "restmail-net: 无法提取用户名" if username.empty?
+
+        resp = Http.get("#{BASE_URL}/mail/#{username}", headers: HEADERS, timeout: 15)
+        return [] if resp.status_code == 404
+
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Array)
+
+        data.select { |m| m.is_a?(Hash) }.map do |msg|
+          from_addr = ""
+          if msg["from"].is_a?(Array) && msg["from"][0].is_a?(Hash)
+            from_addr = msg["from"][0]["address"].to_s
+          end
+          from_addr = msg.dig("headers", "from").to_s if from_addr.empty? && msg["headers"].is_a?(Hash)
+          Normalize.normalize_email({
+                                      "id" => msg["id"] || "", "from" => from_addr, "to" => address,
+                                      "subject" => msg["subject"] || "", "text" => msg["text"] || "",
+                                      "html" => msg["html"] || "", "date" => msg["receivedAt"] || "",
+                                      "is_read" => false
+                                    }, address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/rootsh.rb

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Rootsh(BccTo) 渠道 — https://rootsh.com
+    # 需要 cookie session 认证，token 存储 time 值用于增量获取邮件
+    module Rootsh
+      CHANNEL = "rootsh"
+      BASE = "https://rootsh.com"
+      DEFAULT_DOMAIN = "bccto.cc"
+      TOK_PREFIX = "rootsh1:"
+
+      HEADERS = {
+        "Accept" => "application/json, text/plain, */*",
+        "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8",
+        "Cache-Control" => "no-cache",
+        "DNT" => "1",
+        "Pragma" => "no-cache",
+        "Referer" => "#{BASE}/",
+        "X-Requested-With" => "XMLHttpRequest",
+        "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
+
+      module_function
+
+      def random_local(length = 10)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      def encode_token(last_check_time, cookies)
+        payload = JSON.generate({ "t" => last_check_time, "c" => cookies })
+        "#{TOK_PREFIX}#{payload}"
+      end
+
+      def decode_token(token)
+        raise "rootsh: 无效的 session token" unless token&.start_with?(TOK_PREFIX)
+
+        data = JSON.parse(token[TOK_PREFIX.length..])
+        last_check_time = data["t"] || 0
+        cookies = data["c"] || {}
+        raise "rootsh: 无效的 session token" unless cookies.is_a?(Hash)
+
+        [last_check_time, cookies]
+      end
+
+      def build_cookie_header(cookies)
+        cookies.map { |k, v| "#{k}=#{v}" }.join("; ")
+      end
+
+      def extract_cookies(resp)
+        cookies = {}
+        resp.set_cookies.each do |line|
+          pair = line.split(";").first.to_s.strip
+          k, v = pair.split("=", 2)
+          cookies[k] = v if k && v
+        end
+        cookies
+      end
+
+      # 创建临时邮箱
+      # @param domain [String, nil] 可选域名
+      # @param channel [String] 渠道标识
+      # @return [EmailInfo]
+      def generate_email(domain = nil, channel = CHANNEL)
+        dom = (domain || "").strip
+        dom = DEFAULT_DOMAIN if dom.empty?
+        local = random_local
+        mail_addr = "#{local}@#{dom}"
+
+        # 获取 session cookie
+        r1 = Http.get("#{BASE}/", headers: {
+          "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+          "User-Agent" => HEADERS["User-Agent"]
+        })
+        r1.raise_for_status
+        cookies = extract_cookies(r1)
+
+        # POST /applymail 申请邮箱
+        r2 = Http.post("#{BASE}/applymail", headers: HEADERS.merge(
+          "Content-Type" => "application/x-www-form-urlencoded; charset=UTF-8",
+          "Cookie" => build_cookie_header(cookies)
+        ), body: "mail=#{mail_addr}")
+        r2.raise_for_status
+        cookies.merge!(extract_cookies(r2))
+
+        body = r2.json
+        raise "rootsh: applymail 响应格式无效" unless body.is_a?(Hash)
+        raise "rootsh: 邮箱申请失败: #{body['tips']}" unless body["success"].to_s == "true"
+
+        actual_email = (body["user"] || "").strip
+        actual_email = mail_addr if actual_email.empty?
+        last_check_time = body["time"] || 0
+
+        token = encode_token(last_check_time, cookies)
+        EmailInfo.new(channel: channel, email: actual_email, token: token)
+      end
+
+      # 获取邮件列表
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        raise "rootsh: token 不能为空" if token.nil? || token.empty?
+
+        addr = (email || "").strip
+        raise "rootsh: 邮箱地址不能为空" if addr.empty?
+
+        last_check_time, cookies = decode_token(token)
+        ts = (Time.now.to_f * 1000).to_i
+
+        r = Http.post("#{BASE}/getmail", headers: HEADERS.merge(
+          "Content-Type" => "application/x-www-form-urlencoded; charset=UTF-8",
+          "Cookie" => build_cookie_header(cookies)
+        ), body: "mail=#{addr}&time=#{last_check_time}&_=#{ts}")
+        r.raise_for_status
+        body = r.json
+
+        return [] unless body.is_a?(Hash) && body["success"].to_s == "true"
+
+        mail_list = body["mail"]
+        return [] unless mail_list.is_a?(Array)
+
+        mail_list.filter_map do |item|
+          next unless item.is_a?(Array) && item.length >= 5
+
+          from_email = item[1].to_s
+          from_display = item[0].to_s
+          from_addr = from_email.empty? ? from_display : from_email
+          subject = item[2].to_s
+          date_str = item[3].to_s
+          mail_fid = item[4].to_s
+
+          # 获取邮件正文
+          html_content = ""
+          unless mail_fid.empty?
+            begin
+              rv = Http.post("#{BASE}/viewmail", headers: HEADERS.merge(
+                "Content-Type" => "application/x-www-form-urlencoded; charset=UTF-8",
+                "Cookie" => build_cookie_header(cookies)
+              ), body: "mail=#{mail_fid}&to=#{addr}")
+              if rv.ok?
+                vb = rv.json
+                html_content = vb["mail"] || "" if vb.is_a?(Hash) && vb["success"].to_s == "true"
+              end
+            rescue StandardError
+              # 单封邮件获取失败不影响其他
+            end
+          end
+
+          raw = {
+            "id" => mail_fid,
+            "from" => from_addr,
+            "to" => addr,
+            "subject" => subject,
+            "date" => date_str,
+            "html" => html_content
+          }
+          Normalize.normalize_email(raw, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/shitty_email.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # shitty.email 渠道 — https://shitty.email
+    module ShittyEmail
+      CHANNEL = "shitty-email"
+      API_BASE = "https://shitty.email/api"
+      HEADERS = { "Accept" => "application/json", "User-Agent" => "Mozilla/5.0" }.freeze
+
+      module_function
+
+      def headers_with_token(token = nil)
+        h = HEADERS.dup
+        h["X-Session-Token"] = token if token && !token.empty?
+        h
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{API_BASE}/inbox", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        raise "shitty-email: 响应格式无效" unless data.is_a?(Hash)
+
+        email = (data["email"] || "").strip
+        token = (data["token"] || "").strip
+        raise "shitty-email: 创建邮箱响应无效" if email.empty? || !email.include?("@") || token.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: token, expires_at: data["expiresAt"])
+      end
+
+      # 获取邮件列表
+      # @param token [String] 会话令牌
+      # @param email [String] 邮箱地址
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        session_token = (token || "").strip
+        address = (email || "").strip
+        raise "shitty-email: token 为空" if session_token.empty?
+        raise "shitty-email: 邮箱地址为空" if address.empty?
+
+        resp = Http.get("#{API_BASE}/inbox", headers: headers_with_token(session_token), timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash)
+
+        rows = data["emails"]
+        return [] unless rows.is_a?(Array)
+
+        rows.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          message_id = (item["id"] || "").to_s.strip
+          detail = nil
+          unless message_id.empty?
+            begin
+              dr = Http.get("#{API_BASE}/email/#{URI.encode_www_form_component(message_id)}",
+                            headers: headers_with_token(session_token), timeout: 15)
+              detail = dr.json if dr.ok?
+            rescue StandardError
+              # 单封邮件获取失败不影响其他
+            end
+          end
+
+          source = (detail.is_a?(Hash) ? detail : item)
+          raw = {
+            "id" => source["id"],
+            "from" => source["from"],
+            "to" => source["to"] || address,
+            "subject" => source["subject"],
+            "text" => source["text"],
+            "html" => source["html"],
+            "date" => source["date"]
+          }
+          Normalize.normalize_email(raw, address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/smailpro.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # smailpro.com 渠道实现
+    # 两段式流程：先获取 JWT payload，再调用 api.sonjj.com 接口
+    module Smailpro
+      CHANNEL = "smailpro"
+      BASE_URL = "https://smailpro.com"
+      API_BASE_URL = "https://api.sonjj.com/v1/temp_email"
+
+      HEADERS = {
+        "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",
+        "Accept" => "application/json, text/plain, */*",
+        "Referer" => "#{BASE_URL}/"
+      }.freeze
+
+      module_function
+
+      # 获取访问 sonjj API 所需的 JWT
+      def fetch_payload(target_url, extra = nil)
+        url = "#{BASE_URL}/app/payload?url=#{URI.encode_www_form_component(target_url)}"
+        if extra
+          extra.each { |k, v| url += "&#{URI.encode_www_form_component(k)}=#{URI.encode_www_form_component(v)}" }
+        end
+        resp = Http.get(url, headers: HEADERS)
+        resp.raise_for_status
+        payload = resp.body.strip.delete('"')
+        raise "smailpro: payload 为空" if payload.empty?
+
+        payload
+      end
+
+      # 携带 JWT 调用 sonjj API
+      def call_api(target_url, extra = nil)
+        payload = fetch_payload(target_url, extra)
+        resp = Http.get("#{target_url}?payload=#{URI.encode_www_form_component(payload)}", headers: HEADERS)
+        resp.raise_for_status
+        resp.json
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        data = call_api("#{API_BASE_URL}/create")
+        raise "smailpro: 创建响应格式异常" unless data.is_a?(Hash)
+
+        email = data["email"].to_s.strip
+        raise "smailpro: 创建邮箱失败" if email.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: email, expires_at: data["expired_at"])
+      end
+
+      # 获取单封邮件正文
+      def fetch_message(email, mid)
+        return ["", ""] if mid.to_s.empty?
+
+        data = call_api("#{API_BASE_URL}/message", { "email" => email, "mid" => mid })
+        return ["", ""] unless data.is_a?(Hash)
+
+        [(data["body"] || "").to_s, (data["textBody"] || "").to_s]
+      rescue StandardError
+        ["", ""]
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token = "")
+        addr = email.to_s.strip
+        raise "smailpro: 邮箱地址为空" if addr.empty?
+
+        data = call_api("#{API_BASE_URL}/inbox", { "email" => addr })
+        raise "smailpro: 邮件列表响应格式异常" unless data.is_a?(Hash)
+
+        # API 响应: {"status": true, "data": {"messages": [...]}}
+        inner = data["data"]
+        messages = if inner.is_a?(Hash)
+                     inner["messages"]
+                   else
+                     data["messages"]
+                   end
+        return [] unless messages.is_a?(Array) && !messages.empty?
+
+        messages.select { |m| m.is_a?(Hash) }.map do |m|
+          mid = m["mid"].to_s.strip
+          html_body, text_body = fetch_message(addr, mid)
+          raw = {
+            "id" => mid,
+            "from" => m["from"] || "",
+            "to" => addr,
+            "subject" => m["subject"] || "",
+            "date" => m["datetime"] || ""
+          }
+          raw["html"] = html_body if !html_body.empty? || !text_body.empty?
+          raw["text"] = text_body if !html_body.empty? || !text_body.empty?
+          Normalize.normalize_email(raw, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/ta_easy.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # ta-easy.com 临时邮箱渠道
+    # API: https://api-endpoint.ta-easy.com/temp-email/
+    module TaEasy
+      CHANNEL = "ta-easy"
+      API_BASE = "https://api-endpoint.ta-easy.com"
+      ORIGIN = "https://www.ta-easy.com"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "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",
+        "origin" => ORIGIN,
+        "referer" => "#{ORIGIN}/"
+      }.freeze
+
+      module_function
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{API_BASE}/temp-email/address/new",
+                         headers: HEADERS.merge("Content-Length" => "0"), body: "")
+        resp.raise_for_status
+        data = resp.json
+        raise "ta-easy: #{data['message'] || 'create failed'}" unless data["status"] == "success" && data["address"] && data["token"]
+
+        expires_at = data["expiresAt"].is_a?(Numeric) ? data["expiresAt"].to_i : nil
+        EmailInfo.new(channel: CHANNEL, email: data["address"], token: data["token"], expires_at: expires_at)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        resp = Http.post("#{API_BASE}/temp-email/inbox/list",
+                         headers: HEADERS.merge("Content-Type" => "application/json"),
+                         json: { "token" => token, "email" => email })
+        resp.raise_for_status
+        data = resp.json
+        raise "ta-easy: #{data['message'] || 'inbox failed'}" unless data["status"] == "success"
+
+        raw_list = data["data"]
+        return [] unless raw_list.is_a?(Array)
+
+        raw_list.map { |raw| Normalize.normalize_email(raw, email) }
+      end
+    end
+  end
+end