tempmail_sdk 1.3.4 → 1.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9633959dc0f47ae3b8b30e6cb69db5e16976773039a186303e47701efd37a6b
-  data.tar.gz: 50eed70cbb31235fef5d96ea9d2288cc8d099568bd35946e752875d2c945291d
+  metadata.gz: 94b1283ca19ff9597330edb468dfa560e673fe8176921d74834e348ade013dc1
+  data.tar.gz: 1e9e82a350c0d42cba190079c117ed520ee4d48c2a28a0b2765e8746696856cd
 SHA512:
-  metadata.gz: b54a192368aa851e240a34c91c7e8f2b6fc5b0d5587f6091fabd79f54b89bf7f29dc51c13c57987f499c65b570084aa0754838fbe263d7fbc8d564b5ce2e1bc2
-  data.tar.gz: f630396b6757e1dd049a931141f946a99c92bcf28a28b3aeb8c78d69767f1b5c383a580cfefdc1ade984cbbaec051173ec82f904dff11ee9b5a8983dec03d7ea
+  metadata.gz: 1b1d8285e29796a127ae34c83fd014df2fcf7a06efccc6739bac2a567cbf9eb9d15b87861ec488a61c432be578b5426643c6ded3ff6c2bfeccf2a9a7a7045709
+  data.tar.gz: d1c0b4969332cecc27ed714ebfa1adaef8715eb0c53fddc836c0b1c87a299b4f202081e180490500196f4f59ff165633ef46f09357d9f21d9fc12208e1c8417b

data/README.md

@@ -2,7 +2,7 @@
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 
-Ruby 语言临时邮箱 SDK，公开 **279** 个 `channel` 渠道标识，聚合 100+ 个第三方临时邮箱服务商，所有渠道返回**统一标准化格式**。渠道标识与顺序与 Go / npm / Rust / Python / C 等其余各端保持一致（十端同步）；随机生成邮箱时在本端独立打乱尝试顺序。
+Ruby 语言临时邮箱 SDK，公开 **296** 个 `channel` 渠道标识，聚合 100+ 个第三方临时邮箱服务商，所有渠道返回**统一标准化格式**。渠道标识与顺序与 Go / npm / Rust / Python / C 等其余各端保持一致（十端同步）；随机生成邮箱时在本端独立打乱尝试顺序。
 
 ## 安装
 

data/lib/tempmail_sdk/channels.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# 渠道标识常量模块（279 个），常量值即渠道 slug。
+# 渠道标识常量模块（296 个），常量值即渠道 slug。
 # 由 .channel_meta.json 生成，供用户以常量方式引用渠道，避免手写字符串出错。
 #
 module TempmailSdk
@@ -31,6 +31,7 @@ module TempmailSdk
     MAILFORSPAM_DISPOSABLE = "mailforspam-disposable"
     TEMPMAILC = "tempmailc"
     MAILNESIA = "mailnesia"
+    MAILTICKING = "mailticking"
     THROWAWAYMAIL = "throwawaymail"
     TEMPMAIL_FISH = "tempmail-fish"
     NEIGHBOURS_SH = "neighbours-sh"
@@ -80,7 +81,6 @@ module TempmailSdk
     VILLATOGEL_COM = "villatogel-com"
     MAIL123 = "mail123"
     MAIL10S = "mail10s"
-    WEBMAILTEMP = "webmailtemp"
     TEMPFASTMAIL = "tempfastmail"
     C_1SEC_MAIL = "1sec-mail"
     FAKEMAIL = "fakemail"
@@ -162,7 +162,6 @@ module TempmailSdk
     HARIBU = "haribu"
     ROOTSH = "rootsh"
     FAKE_EMAIL_SITE = "fake-email-site"
-    MOHMAL = "mohmal"
     MAILGOLEM = "mailgolem"
     BEST_TEMP_MAIL = "best-temp-mail"
     DISPOSABLEMAIL_APP = "disposablemail-app"
@@ -183,14 +182,12 @@ module TempmailSdk
     TEMPP_MAILS = "tempp-mails"
     EMAILTEMP_ORG = "emailtemp-org"
     MYTEMPMAIL_CC = "mytempmail-cc"
-    TEMP_MAIL_NOW = "temp-mail-now"
     MAIL_TD = "mail-td"
     MAILHOLE_DE = "mailhole-de"
     TMAIL_LINK = "tmail-link"
     C_24MAIL_CHACUO = "24mail-chacuo"
     NIMAIL = "nimail"
     FREECUSTOM = "freecustom"
-    C_16888888_CYOU = "16888888-cyou"
     C_17666688_SHOP = "17666688-shop"
     C_282MAIL_COM = "282mail-com"
     BLACKHOLE_DJURBY_SE = "blackhole-djurby-se"
@@ -205,7 +202,6 @@ module TempmailSdk
     EASYME_PRO = "easyme-pro"
     EBS_COM_AR = "ebs-com-ar"
     ETGDEV_DE = "etgdev-de"
-    EVERGREENCO_SHOP = "evergreenco-shop"
     FWD2M_ESZETT_ES = "fwd2m-eszett-es"
     JAMA_TRENET_EU = "jama-trenet-eu"
     J_FAIRUSE_ORG = "j-fairuse-org"
@@ -279,11 +275,37 @@ module TempmailSdk
     TEMPGMAILER = "tempgmailer"
     TEMP_MAIL_ORG = "temp-mail-org"
     XKX_ME = "xkx-me"
-    GONEBOX_EMAIL = "gonebox-email"
     MAILCAT_AI = "mailcat-ai"
     TEMPGO_EMAIL = "tempgo-email"
     RESTMAIL_NET = "restmail-net"
     DROPMAIL_ME = "dropmail-me"
     TEN_MINUTE_MAIL_NET = "ten-minute-mail-net"
+    TEMPMAILS_IO = "tempmails-io"
+    SHITPOST_EMAIL = "shitpost-email"
+    SMAILS = "smails"
+    TEMPMAILPORTAL = "tempmailportal"
+    HUSKMAIL = "huskmail"
+    ZERODROP = "zerodrop"
+    FIRETEMPMAIL = "firetempmail"
+    NULLMAIL = "nullmail"
+    TENMIN_APP = "tenmin-app"
+    MTEMPMAIL = "mtempmail"
+    TEMPMAIL_EE = "tempmail-ee"
+    TEMPORARYMAIL_COM = "temporarymail-com"
+    C_30MINEMAIL = "30minemail"
+    LINSHI_XYZ = "linshi-xyz"
+    CRAZYMAILING = "crazymailing"
+    NOXEN_DE5_NET = "noxen-de5-net"
+    NUKEMAIL = "nukemail"
+    SHADOWMAIL = "shadowmail"
+    FLYBYMAIL = "flybymail"
+    NOWTEMPMAIL = "nowtempmail"
+    CLAWDEMAIL = "clawdemail"
+    TEMPMAIL100 = "tempmail100"
+    TEMPMAILTO = "tempmailto"
+    TEMP_MAIL_GG = "temp-mail-gg"
+    TMPKIT = "tmpkit"
+    INTERNXT = "internxt"
+    GENERATOR_EMAIL = "generator-email"
   end
 end

data/lib/tempmail_sdk/channels_data.rb

@@ -4,7 +4,7 @@
 # 每项为 [slug, name, website]，注册表按此顺序枚举，顺序为硬约束。
 #
 module TempmailSdk
-  # 279 个渠道的有序元数据
+  # 296 个渠道的有序元数据
   CHANNEL_DATA = [
     ["tempmail", "TempMail", "tempmail.ing"],
     ["tempmail-cn", "TempMail CN", "tempmail.cn"],
@@ -31,6 +31,7 @@ module TempmailSdk
     ["mailforspam-disposable", "MailForSpam Disposable", "disposable.email"],
     ["tempmailc", "TempMailC", "tempmailc.com"],
     ["mailnesia", "Mailnesia", "mailnesia.com"],
+    ["mailticking", "MailTicking", "mailticking.com"],
     ["throwawaymail", "ThrowawayMail", "throwawaymail.app"],
     ["tempmail-fish", "TempMail Fish", "tempmail.fish"],
     ["neighbours-sh", "Neighbours", "neighbours.sh"],
@@ -80,7 +81,6 @@ module TempmailSdk
     ["villatogel-com", "villatogel.com", "getnada.net"],
     ["mail123", "Mail123", "mail123.fr"],
     ["mail10s", "Mail10s", "mail10s.com"],
-    ["webmailtemp", "WebMailTemp", "webmailtemp.com"],
     ["tempfastmail", "TempFastMail", "tempfastmail.com"],
     ["1sec-mail", "1SecMail", "1sec-mail.com"],
     ["fakemail", "FakeMail", "fakemail.net"],
@@ -162,7 +162,6 @@ module TempmailSdk
     ["haribu", "Haribu", "haribu.net"],
     ["rootsh", "Rootsh(BccTo)", "rootsh.com"],
     ["fake-email-site", "FakeEmailSite", "fake-email.site"],
-    ["mohmal", "Mohmal", "mohmal.com"],
     ["mailgolem", "MailGolem", "mailgolem.com"],
     ["best-temp-mail", "BestTempMail", "best-temp-mail.com"],
     ["disposablemail-app", "DisposableMail", "disposablemail.app"],
@@ -183,14 +182,12 @@ module TempmailSdk
     ["tempp-mails", "TemppMails", "tempp-mails.com"],
     ["emailtemp-org", "EmailTemp", "emailtemp.org"],
     ["mytempmail-cc", "MyTempMail.cc", "mytempmail.cc"],
-    ["temp-mail-now", "TempMailNow", "temp-mail.now"],
     ["mail-td", "Mail.td", "mail.td"],
     ["mailhole-de", "Mailhole.de", "mailhole.de"],
     ["tmail-link", "TMail.link", "tmail.link"],
     ["24mail-chacuo", "24Mail Chacuo", "24mail.chacuo.net"],
     ["nimail", "NiMail", "nimail.cn"],
     ["freecustom", "FreeCustom.Email", "freecustom.email"],
-    ["16888888-cyou", "Mailmomy (16888888.cyou)", "mailmomy.com"],
     ["17666688-shop", "Mailmomy (17666688.shop)", "mailmomy.com"],
     ["282mail-com", "Mailmomy (282mail.com)", "mailmomy.com"],
     ["blackhole-djurby-se", "Mailinator (blackhole.djurby.se)", "mailinator.com"],
@@ -205,7 +202,6 @@ module TempmailSdk
     ["easyme-pro", "Mailmomy (easyme.pro)", "mailmomy.com"],
     ["ebs-com-ar", "Mailinator (ebs.com.ar)", "mailinator.com"],
     ["etgdev-de", "Mailinator (etgdev.de)", "mailinator.com"],
-    ["evergreenco-shop", "Mailmomy (evergreenco.shop)", "mailmomy.com"],
     ["fwd2m-eszett-es", "Mailinator (fwd2m.eszett.es)", "mailinator.com"],
     ["jama-trenet-eu", "Mailinator (jama.trenet.eu)", "mailinator.com"],
     ["j-fairuse-org", "Mailinator (j.fairuse.org)", "mailinator.com"],
@@ -279,11 +275,37 @@ module TempmailSdk
     ["tempgmailer", "TempGmailer", "tempgmailer.com"],
     ["temp-mail-org", "Temp-Mail.org", "temp-mail.org"],
     ["xkx-me", "XKX.me", "xkx.me"],
-    ["gonebox-email", "Gonebox Email", "gonebox.email"],
     ["mailcat-ai", "Mailcat AI", "mailcat.ai"],
     ["tempgo-email", "TempGo Email", "tempgo.email"],
     ["restmail-net", "Restmail.net", "restmail.net"],
     ["dropmail-me", "DropMail.me", "dropmail.me"],
     ["ten-minute-mail-net", "10MinuteMail.net", "10minutemail.net"],
+    ["tempmails-io", "TempMails.io", "tempmails.io"],
+    ["shitpost-email", "ShitPost.email", "shitpost.email"],
+    ["smails", "Smails.dev", "smails.dev"],
+    ["tempmailportal", "TempMail Portal", "tempmailportal.com"],
+    ["huskmail", "HuskMail", "huskmail.xyz"],
+    ["zerodrop", "Zerodrop", "zerodrop.dev"],
+    ["firetempmail", "FireTempMail", "firetempmail.com"],
+    ["nullmail", "NullMail", "nullmail.cc"],
+    ["tenmin-app", "Tenmin.app", "tenmin.app"],
+    ["mtempmail", "MTempMail", "mtempmail.com"],
+    ["tempmail-ee", "TempMail.ee", "tempmail.ee"],
+    ["temporarymail-com", "Temporarymail.com", "temporarymail.com"],
+    ["30minemail", "30minemail", "30minemail.com"],
+    ["linshi-xyz", "Linshi.xyz", "linshi.xyz"],
+    ["crazymailing", "CrazyMailing", "crazymailing.com"],
+    ["noxen-de5-net", "UniMail Bot", "tempmail.noxen.de5.net"],
+    ["nukemail", "NukeMail", "nukemail.app"],
+    ["shadowmail", "ShadowMail", "shadowmail.win"],
+    ["flybymail", "FlyByMail", "flybymail.com"],
+    ["nowtempmail", "NowTempMail", "nowtempmail.com"],
+    ["clawdemail", "ClawdEmail", "clawdemail.com"],
+    ["tempmail100", "TempMail100", "tempmail100.com"],
+    ["tempmailto", "Tempmailto", "tempmailto.com"],
+    ["temp-mail-gg", "TempMailGG", "temp-mail.gg"],
+    ["tmpkit", "Tmpkit", "tmpkit.com"],
+    ["internxt", "Internxt", "internxt.com"],
+    ["generator-email", "GeneratorEmail", "generator.email"],
   ].freeze
 end

data/lib/tempmail_sdk/providers/clawdemail.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # ClawdEmail 渠道实现（clawdemail.com，API 域 api.clawdemail.com）
+    #
+    # POST /register 建箱（无验证码，body {"name":"xxx"}，响应 success/email/token），
+    # GET /inbox 读信列表（Header Authorization: Bearer <token>，
+    #   响应 success/email/count/unread/emails[]），GET /email/{id} 取单封详情（Bearer）。
+    # 信件保留 30 分钟，仅接收不发送，正文仅纯文本。
+    module Clawdemail
+      CHANNEL = "clawdemail"
+      BASE_URL = "https://api.clawdemail.com"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) " \
+                        "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
+      }.freeze
+
+      RETRY_KEYS = %w[id Id slug messageId message_id].freeze
+
+      module_function
+
+      # 设置 clawdemail 请求的通用请求头（可选附带 Bearer token）
+      # @param token [String] 认证令牌
+      # @return [Hash]
+      def auth_headers(token)
+        hdrs = HEADERS.dup
+        hdrs["Authorization"] = "Bearer #{token}" unless token.to_s.empty?
+        hdrs
+      end
+
+      # 创建 clawdemail.com 临时邮箱
+      # POST /register（body {"name":""}）返回 email 与 token。
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/register",
+                         headers: auth_headers("").merge("Content-Type" => "application/json"),
+                         json: { "name" => "" }, timeout: 15)
+        raise "clawdemail: 创建邮箱失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        raise "clawdemail: 创建响应非对象" unless data.is_a?(Hash)
+
+        email = data["email"].to_s.strip
+        token = data["token"].to_s.strip
+        raise "clawdemail: 创建邮箱响应缺少必要字段" if email.empty? || token.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: token)
+      end
+
+      # 获取 clawdemail.com 邮件列表
+      # 流程：GET /inbox?limit=50 取列表，对每个元素按 id 逐封 GET /email/{id} 合并详情；
+      # 详情失败时以列表摘要归一。
+      # @param email [String] 邮箱地址
+      # @param token [String] 注册返回的认证令牌
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        resp = Http.get("#{BASE_URL}/inbox?limit=50",
+                        headers: auth_headers(token), timeout: 15)
+        raise "clawdemail: 获取邮件列表失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        raise "clawdemail: 收件箱响应非对象" unless data.is_a?(Hash)
+
+        unless data["success"] == true
+          raise "clawdemail: 读取收件箱失败: #{data["error"]}"
+        end
+        emails = data["emails"]
+        return [] unless emails.is_a?(Array)
+
+        emails.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          detail = get_detail(token, message_id_of(m))
+          row = m.dup
+          if detail.is_a?(Hash)
+            detail.each { |k, v| row[k] = v unless row.key?(k) }
+          end
+          Normalize.normalize_email(row, addr)
+        end
+      end
+
+      # 从列表元素中提取邮件 ID（候选键 id/Id/slug/messageId/message_id）
+      # @param row [Hash]
+      # @return [String]
+      def message_id_of(row)
+        RETRY_KEYS.each do |key|
+          val = row[key]
+          return val.to_s.strip unless val.nil? || val.to_s.strip.empty?
+        end
+        ""
+      end
+
+      # 获取 clawdemail.com 单封邮件详情
+      # GET /email/{id}（Bearer token），响应含 email 嵌套对象（from_addr/body_text/received_at）
+      # 时提升嵌套对象。
+      # @param token [String] 认证令牌
+      # @param id [String] 邮件 ID
+      # @return [Hash, nil]
+      def get_detail(token, id)
+        return nil if id.to_s.empty?
+
+        uri = "#{BASE_URL}/email/#{URI.encode_www_form_component(id)}"
+        resp = Http.get(uri, headers: auth_headers(token), timeout: 15)
+        return nil unless resp.ok?
+
+        detail = resp.json
+        return nil unless detail.is_a?(Hash)
+
+        nested = detail["email"]
+        nested.is_a?(Hash) ? nested : detail
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/crazymailing.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Crazymailing 渠道实现（crazymailing.com）
+    #
+    # Next.js 全栈站点，API 结构：
+    #   POST /api/mailbox（空 JSON body）建箱，响应
+    #     {"mailbox":{"id":"...","address":"...@crazymailing.com","expiresAt":"<RFC3339>"}}；
+    #   GET /api/messages?mailbox=<完整地址 URL 编码> 读信，响应 {"messages":[...]}；
+    #   GET /api/message/{id}/body 取单封正文（完整 HTML 页面）。
+    # 请求需携带 Origin/Referer 浏览器形态头。
+    module Crazymailing
+      CHANNEL = "crazymailing"
+      BASE_URL = "https://crazymailing.com"
+
+      HEADERS = {
+        "Content-Type" => "application/json",
+        "Accept" => "application/json",
+        "Origin" => BASE_URL,
+        "Referer" => "#{BASE_URL}/",
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) " \
+                        "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
+      }.freeze
+
+      RETRY_KEYS = %w[id Id slug messageId message_id].freeze
+
+      module_function
+
+      # 创建临时邮箱
+      # POST /api/mailbox（空 JSON body）；域名由服务端统一分配（当前仅 @crazymailing.com）。
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/api/mailbox",
+                         headers: HEADERS, json: {}, timeout: 15)
+        raise "crazymailing: 创建邮箱失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        mailbox = data.is_a?(Hash) ? data["mailbox"] : nil
+        raise "crazymailing: 创建响应缺少 mailbox" unless mailbox.is_a?(Hash)
+
+        address = mailbox["address"].to_s.strip
+        raise "crazymailing: 创建响应缺少 mailbox.address" if address.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: address,
+                      token: mailbox["id"].to_s, expires_at: mailbox["expiresAt"].to_s)
+      end
+
+      # 读取收件箱
+      # GET /api/messages?mailbox=<完整地址 URL 编码>，响应 {"messages":[...]}；
+      # 对每个元素逐封 GET /api/message/{id}/body 拉取正文（失败不阻断列表）。
+      # @param email [String] 完整邮箱地址
+      # @param token [String] 建箱返回的 mailbox id
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        raise "crazymailing: 邮箱地址为空" if addr.empty?
+
+        uri = "#{BASE_URL}/api/messages?mailbox=#{URI.encode_www_form_component(addr)}"
+        resp = Http.get(uri, headers: HEADERS, timeout: 15)
+        raise "crazymailing: 读取收件箱失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        messages = data.is_a?(Hash) ? data["messages"] : nil
+        return [] unless messages.is_a?(Array)
+
+        messages.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          row = m.dup
+          row["to"] = addr unless row.key?("to")
+          id = message_id_of(row)
+          unless id.empty?
+            # 列表元素为摘要，正文须逐封二拉（失败不阻断）
+            html = get_body(id)
+            row["html"] = html if !html.empty?
+          end
+          Normalize.normalize_email(row, addr)
+        end
+      end
+
+      # 从列表元素中提取邮件 ID（候选键 id/Id/slug/messageId/message_id）
+      # @param row [Hash]
+      # @return [String]
+      def message_id_of(row)
+        RETRY_KEYS.each do |key|
+          val = row[key]
+          return val.to_s.strip unless val.nil? || val.to_s.strip.empty?
+        end
+        ""
+      end
+
+      # 拉取单封正文（GET /api/message/{id}/body，响应为完整 HTML 页面）
+      # @param id [String] 邮件 ID
+      # @return [String]
+      def get_body(id)
+        uri = "#{BASE_URL}/api/message/#{URI.encode_www_form_component(id)}/body"
+        resp = Http.get(uri,
+                        headers: {
+                          "Accept" => "text/html,application/xhtml+xml,*/*;q=0.8",
+                          "Origin" => BASE_URL,
+                          "Referer" => "#{BASE_URL}/",
+                          "User-Agent" => HEADERS["User-Agent"]
+                        },
+                        timeout: 15)
+        return "" unless resp.ok?
+
+        resp.body.to_s
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/firetempmail.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Firetempmail 渠道实现（firetempmail.com）
+    #
+    # 无认证 REST：建箱无需请求，本地生成 随机词+0-999@<域>（域池与官网一致：
+    # offrework.click / service-today.click / jobsdeforyou.sa.com）；
+    # 读信 GET https://mail.firetempmail.com/mail/get?address=<邮箱 URL 编码>，
+    # 必须携带 Header Origin: https://firetempmail.com（否则 403 'Origin not allowed'）。
+    # 响应形如 {"status":"ok","code":200,"msg":"...","stats":{},"mails":[...]}，
+    # 邮件字段以 sender/subject/date + content-html/content-text/content-plain 多候选归一。
+    module Firetempmail
+      CHANNEL = "firetempmail"
+      API_BASE = "https://mail.firetempmail.com"
+      ORIGIN = "https://firetempmail.com"
+      # 官网 JS 中的完整平台域池，顺序与官网一致
+      DOMAINS = %w[offrework.click service-today.click jobsdeforyou.sa.com].freeze
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "Origin" => ORIGIN,
+        "Referer" => "#{ORIGIN}/",
+        "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
+
+      # 生成 3-6 位小写随机词（模拟官网 1-5 字母词的观感）
+      LETTERS = ("a".."z").to_a
+      def random_word
+        Array.new(rand(3..6)) { LETTERS.sample }.join
+      end
+
+      # 创建临时邮箱
+      # 建箱无需请求，本地随机生成 随机词+0-999@域名；token 复用完整地址
+      # @return [EmailInfo]
+      def generate_email
+        email = "#{random_word}#{rand(0..999)}@#{DOMAINS.sample}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # 读取收件箱
+      # GET https://mail.firetempmail.com/mail/get?address=<URL 编码完整邮箱>，必带 Origin 头
+      # @param email [String] 邮箱地址
+      # @param _token [String] 令牌（本渠道忽略，以邮箱为准）
+      # @return [Array<Email>]
+      def get_emails(email, _token)
+        addr = email.to_s.strip
+        raise "firetempmail: 邮箱地址为空" if addr.empty?
+
+        url = "#{API_BASE}/mail/get?address=#{URI.encode_www_form_component(addr)}"
+        resp = Http.get(url, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash)
+
+        # 错误与成功共用同一信封：status 非 ok 时抛错
+        status = data["status"].to_s
+        if !status.empty? && status != "ok"
+          raise "firetempmail: #{data["msg"] || "读信失败"}"
+        end
+
+        mails = data["mails"]
+        return [] unless mails.is_a?(Array)
+
+        mails.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          row = {
+            "from" => m["sender"] || m["from"] || m["from_address"],
+            "to" => addr,
+            "subject" => m["subject"] || m["title"],
+            "date" => m["date"] || m["received_at"] || m["created_at"],
+            "html" => m["content-html"] || m["html"],
+            "text" => m["content-text"] || m["content-plain"] || m["text"]
+          }
+          Normalize.normalize_email(row, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/flybymail.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Flybymail 渠道实现（flybymail.com）
+    #
+    # POST /api/recipients 建箱（空 JSON body，响应 id/email/createdAt/expiresAt，
+    #   expiresAt 为毫秒时间戳），GET /api/recipients/{email}/emails 读信
+    #   （按邮箱地址、非 id 查询，响应 {"emails":[...]}）。
+    # 信件字段：id/from/to/subject/body（纯文本）/htmlBody（HTML 正文）/preview/time/read。
+    module Flybymail
+      CHANNEL = "flybymail"
+      BASE_URL = "https://flybymail.com"
+
+      HEADERS = {
+        "Content-Type" => "application/json",
+        "Accept" => "application/json",
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) " \
+                        "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
+      }.freeze
+
+      module_function
+
+      # 创建 flybymail.com 临时邮箱
+      # POST /api/recipients（空 JSON body）返回 id/email/createdAt/expiresAt，
+      # expiresAt 为毫秒时间戳（约 4 小时），转换为毫秒值供 EmailInfo 统一展示。
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/api/recipients",
+                         headers: HEADERS, json: {}, timeout: 15)
+        raise "flybymail: 创建邮箱失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        raise "flybymail: 创建响应非对象" unless data.is_a?(Hash)
+
+        id = data["id"].to_s.strip
+        email = data["email"].to_s.strip
+        raise "flybymail: 创建邮箱响应缺少必要字段" if id.empty? || email.empty? || !email.include?("@")
+
+        expires_at = data["expiresAt"].to_i.positive? ? data["expiresAt"].to_i : nil
+        EmailInfo.new(channel: CHANNEL, email: email, token: id, expires_at: expires_at)
+      end
+
+      # 获取 flybymail.com 邮件列表
+      # GET /api/recipients/{email}/emails（按地址查询）返回 {"emails":[...]}。
+      # @param email [String] 邮箱地址
+      # @param token [String] 建箱返回的收件人 ID（读信端点按邮箱地址查询，令牌保留）
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        raise "flybymail: 邮箱地址为空或格式错误" if addr.empty? || !addr.include?("@")
+
+        uri = "#{BASE_URL}/api/recipients/#{URI.encode_www_form_component(addr)}/emails"
+        resp = Http.get(uri, headers: HEADERS, timeout: 15)
+        raise "flybymail: 获取邮件列表失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        emails = data.is_a?(Hash) ? data["emails"] : nil
+        return [] unless emails.is_a?(Array)
+
+        emails.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          # id 为数字时按字符串归一，time 为毫秒时间戳时按 timestamp 归一
+          row = {
+            "id" => raw["id"].to_s.strip,
+            "from" => raw["from"],
+            "to" => raw["to"],
+            "subject" => raw["subject"],
+            "text" => raw["body"],
+            "html" => raw["htmlBody"],
+            "time" => raw["time"],
+            "read" => raw["read"],
+            "attachments" => raw["attachments"],
+            "timestamp" => timestamp_of(raw)
+          }
+          Normalize.normalize_email(row, addr)
+        end
+      end
+
+      # 归一邮件时间：候选 time/date 字段（time 为毫秒时间戳）
+      # @param m [Hash]
+      # @return [Object, nil]
+      def timestamp_of(m)
+        return m["time"] if m.key?("time") && !m["time"].nil?
+
+        m["date"]
+      end
+    end
+  end
+end