tempmail_sdk 1.3.3 → 1.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c42b7ddf14c615d07554a2d6aa7efb1954cadad4ecef1f052bb6af5fb22f2a8
-  data.tar.gz: 46ab91c0e8946782a83c60c020feeebf840e625be330839d62c69b1c8f1ab5bc
+  metadata.gz: 94b1283ca19ff9597330edb468dfa560e673fe8176921d74834e348ade013dc1
+  data.tar.gz: 1e9e82a350c0d42cba190079c117ed520ee4d48c2a28a0b2765e8746696856cd
 SHA512:
-  metadata.gz: 175bf0d04d31f7db48739b559af1eba64bdc0c09b51bd18e90124fbf0f05727e4f2586157f714e6c76ee693d3b29725756c89f002fe9a484c4fc7bf969d26ba4
-  data.tar.gz: 4052cdcfa7f88faf5eff0461a40e427eea368a86ca976fdd7dc25de4900d638f1479401ae98240936ffa489af05cd17446fcec7e4354c9b8debd896c79f2de1c
+  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/altmails.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # altmails.com 渠道实现
+    #
+    # 流程：
+    #   1. GET / 建立 session，从 HTML inline script 提取 CSRF token（'_token': 'xxx'）
+    #   2. GET /random-email-address 获取随机邮箱地址（纯文本响应）
+    #   3. 收信：重新建立 session 获取新 CSRF，POST /fetch-emails/{email} 获取邮件列表
+    #   4. GET /view/{id} 获取每封邮件正文 HTML
+    module Altmails
+      CHANNEL = "altmails"
+      BASE_URL = "https://tempmail.altmails.com"
+
+      BROWSER_HEADERS = {
+        "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8",
+        "Accept-Language" => "en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7",
+        "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
+
+      CSRF_RE = /'_token'\s*:\s*'([^']+)'/.freeze
+
+      module_function
+
+      # 访问首页提取 CSRF token
+      # @return [String]
+      def fetch_csrf
+        resp = Http.get("#{BASE_URL}/", headers: BROWSER_HEADERS)
+        resp.raise_for_status
+        m = resp.body.match(CSRF_RE)
+        raise "altmails: 未能从首页提取 CSRF token" unless m
+
+        m[1]
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        csrf = fetch_csrf
+        resp = Http.get("#{BASE_URL}/random-email-address",
+                        headers: BROWSER_HEADERS.merge("Referer" => "#{BASE_URL}/"))
+        resp.raise_for_status
+        email = resp.body.strip
+        raise "altmails: 邮箱地址无效: #{email.inspect}" if email.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: csrf)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @param token [String] CSRF token（收信时重新获取新 session）
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        _ = token
+        csrf = fetch_csrf
+        fetch_url = "#{BASE_URL}/fetch-emails/#{URI.encode_www_form_component(email)}"
+        form = "_token=#{URI.encode_www_form_component(csrf)}"
+        resp = Http.post(fetch_url,
+                         headers: {
+                           "Accept" => "application/json, text/plain, */*",
+                           "Accept-Language" => "en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7",
+                           "Content-Type" => "application/x-www-form-urlencoded",
+                           "Origin" => BASE_URL,
+                           "Referer" => "#{BASE_URL}/",
+                           "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",
+                           "X-Requested-With" => "XMLHttpRequest"
+                         },
+                         body: form)
+        resp.raise_for_status
+        items = begin
+          resp.json
+        rescue StandardError
+          []
+        end
+        return [] unless items.is_a?(Array)
+
+        items.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          item["to"] = email
+          mail_id = item["id"].to_s
+          unless mail_id.empty?
+            begin
+              vr = Http.get("#{BASE_URL}/view/#{URI.encode_www_form_component(mail_id)}",
+                            headers: BROWSER_HEADERS.merge("Referer" => "#{BASE_URL}/"))
+              item["html_body"] = vr.body if vr.ok?
+            rescue StandardError
+              # 忽略正文获取失败
+            end
+          end
+          Normalize.normalize_email(item, email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/apihz.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+require "base64"
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # apihz（接口盒子）渠道实现
+    #
+    # 需 id/key 凭据，邮箱有效期 10 分钟。读信须携带创建时的 pwd，
+    # 故 token 用 base64(JSON{mail,pwd}) 编码保存。
+    module Apihz
+      CHANNEL = "apihz"
+      BASE_URL = "https://cn.apihz.cn"
+      TOK_PREFIX = "apihz1:"
+      # 官方公共账号（共享频次），未配置自有 id/key 时使用
+      PUBLIC_ID = "88888888"
+      PUBLIC_KEY = "88888888"
+      DOMAINS = %w[apimail.email apimail.vip].freeze
+
+      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
+
+      # 读取 id/key：优先环境变量 APIHZ_ID/APIHZ_KEY，回退官方公共账号
+      def credentials
+        id = ENV["APIHZ_ID"].to_s.strip
+        key = ENV["APIHZ_KEY"].to_s.strip
+        id = PUBLIC_ID if id.empty?
+        key = PUBLIC_KEY if key.empty?
+        [id, key]
+      end
+
+      # 生成随机本地部分
+      def random_local(length = 10)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 生成 12 位随机密码
+      def random_password
+        chars = ("A".."Z").to_a + ("a".."z").to_a + ("0".."9").to_a
+        Array.new(12) { chars.sample }.join
+      end
+
+      # token 编码：前缀 + base64(JSON{mail,pwd})
+      def encode_token(mail, pwd)
+        raw = JSON.generate("mail" => mail, "pwd" => pwd)
+        TOK_PREFIX + Base64.strict_encode64(raw)
+      end
+
+      # token 解码
+      def decode_token(token)
+        raise "apihz: 无效 token" unless token.to_s.start_with?(TOK_PREFIX)
+
+        raw = Base64.strict_decode64(token[TOK_PREFIX.length..])
+        o = JSON.parse(raw)
+        mail = o["mail"].to_s.strip
+        pwd = o["pwd"].to_s.strip
+        raise "apihz: 无效 token" if mail.empty? || pwd.empty?
+
+        [mail, pwd]
+      rescue ArgumentError, JSON::ParserError
+        raise "apihz: 无效 token"
+      end
+
+      # 创建临时邮箱
+      # GET /api/mail/mailcache.php?id=&key=&domain=&name=&pwd=&buytype=0
+      # @return [EmailInfo]
+      def generate_email
+        id, key = credentials
+        domain = DOMAINS.sample
+        name = random_local
+        pwd = random_password
+
+        url = "#{BASE_URL}/api/mail/mailcache.php?" \
+              "id=#{URI.encode_www_form_component(id)}&key=#{URI.encode_www_form_component(key)}" \
+              "&domain=#{URI.encode_www_form_component(domain)}" \
+              "&name=#{URI.encode_www_form_component(name)}" \
+              "&pwd=#{URI.encode_www_form_component(pwd)}&buytype=0"
+
+        resp = Http.get(url, headers: HEADERS)
+        resp.raise_for_status
+        data = resp.json
+        raise "apihz: 创建邮箱失败 #{data['msg']}" if data["code"] != 200 || data["mail"].to_s.empty?
+
+        final_pwd = data["pwd"].to_s
+        final_pwd = pwd if final_pwd.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: data["mail"], token: encode_token(data["mail"], final_pwd))
+      end
+
+      # 获取邮件列表
+      # GET /api/mail/mailgetlist.php?id=&key=&mail=&pwd=&page=1
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(token)
+        mail, pwd = decode_token(token)
+        id, key = credentials
+
+        url = "#{BASE_URL}/api/mail/mailgetlist.php?" \
+              "id=#{URI.encode_www_form_component(id)}&key=#{URI.encode_www_form_component(key)}" \
+              "&mail=#{URI.encode_www_form_component(mail)}" \
+              "&pwd=#{URI.encode_www_form_component(pwd)}&page=1"
+
+        resp = Http.get(url, headers: HEADERS)
+        resp.raise_for_status
+        data = resp.json
+        return [] if data["code"] != 200
+
+        list = data["data"]
+        return [] unless list.is_a?(Array) && !list.empty?
+
+        list.map do |msg|
+          from_addr = msg["frommail"].to_s
+          from_addr = msg["fromname"].to_s if from_addr.empty?
+          date_val = msg["time2"].to_s
+          date_val = msg["time1"].to_s if date_val.empty?
+          Normalize.normalize_email({
+            "id" => msg["time1"].to_s,
+            "from" => from_addr,
+            "to" => mail,
+            "subject" => msg["subject"].to_s,
+            "text" => msg["content"].to_s,
+            "html" => msg["content"].to_s,
+            "date" => date_val,
+            "isRead" => false
+          }, mail)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/awamail.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # awamail.com 渠道实现
+    #
+    # 流程：
+    #   1. POST /welcome/change_mailbox（空 body）不跟随重定向，从 Set-Cookie 提取 awamail_session
+    #   2. GET /welcome/get_emails 携带 Cookie 获取邮件列表
+    module Awamail
+      CHANNEL = "awamail"
+      BASE_URL = "https://awamail.com/welcome"
+
+      HEADERS = {
+        "Accept" => "application/json, text/javascript, */*; q=0.01",
+        "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6",
+        "Cache-Control" => "no-cache",
+        "DNT" => "1",
+        "Origin" => "https://awamail.com",
+        "Pragma" => "no-cache",
+        "Referer" => "https://awamail.com/?lang=zh",
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " \
+                       "(KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36 Edg/144.0.0.0",
+        "X-Requested-With" => "XMLHttpRequest"
+      }.freeze
+
+      module_function
+
+      # 创建临时邮箱
+      # POST /welcome/change_mailbox，从 Set-Cookie 提取 awamail_session
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/change_mailbox",
+                         headers: HEADERS.merge("Content-Length" => "0"))
+        # 不跟随重定向，直接从响应提取 cookie
+        session_cookie = resp.cookie_value("awamail_session")
+        raise "awamail: 未能提取 awamail_session cookie" if session_cookie.to_s.empty?
+
+        cookie_str = "awamail_session=#{session_cookie}"
+
+        data = begin
+          resp.json
+        rescue StandardError
+          {}
+        end
+
+        email_addr = data.is_a?(Hash) ? data.dig("data", "email_address").to_s : ""
+        if email_addr.empty?
+          # 若 POST 响应无邮箱，尝试 GET get_emails 获取
+          gr = Http.get("#{BASE_URL}/get_emails",
+                        headers: HEADERS.merge("Cookie" => cookie_str))
+          gr.raise_for_status
+          gd = gr.json
+          email_addr = gd.is_a?(Hash) ? gd.dig("data", "email_address").to_s : ""
+        end
+
+        raise "awamail: 未能获取邮箱地址" if email_addr.empty?
+
+        info = EmailInfo.new(channel: CHANNEL, email: email_addr, token: cookie_str)
+        if data.is_a?(Hash)
+          info.expires_at = data.dig("data", "expired_at").to_s
+          info.created_at = data.dig("data", "created_at").to_s
+        end
+        info
+      end
+
+      # 获取邮件列表
+      # GET /welcome/get_emails，携带 Cookie
+      # @param token [String] awamail_session cookie 字符串
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        resp = Http.get("#{BASE_URL}/get_emails",
+                        headers: HEADERS.merge(
+                          "Cookie" => token,
+                          "X-Requested-With" => "XMLHttpRequest"
+                        ))
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash) && data["success"]
+
+        emails_raw = data.dig("data", "emails")
+        return [] unless emails_raw.is_a?(Array)
+
+        emails_raw.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          Normalize.normalize_email(raw, email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/best_temp_mail.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "json"
+require "securerandom"
+
+module TempmailSdk
+  module Providers
+    # best-temp-mail.com 渠道实现
+    #
+    # 纯 JSON REST API，无需认证，无需 Session。
+    # 创建邮箱: POST /api/v3/createEmail  body: {"intToken":"<uuid>"}
+    # 获取邮件: POST /api/v3/getEmailList  body: {"address":"...","id":"...","intToken":"...","update_tag":"..."}
+    module BestTempMail
+      CHANNEL = "best-temp-mail"
+      API_BASE = "https://best-temp-mail.com/api/v3"
+
+      HEADERS = {
+        "Accept" => "application/json, text/plain, */*",
+        "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8",
+        "Content-Type" => "application/json",
+        "Origin" => "https://best-temp-mail.com",
+        "Referer" => "https://best-temp-mail.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"
+      }.freeze
+
+      module_function
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        int_token = SecureRandom.uuid
+        resp = Http.post("#{API_BASE}/createEmail",
+                         headers: HEADERS,
+                         json: { "intToken" => int_token })
+        resp.raise_for_status
+        data = resp.json
+        raise "best-temp-mail: 创建邮箱失败 status=#{data['status']}" \
+          if data["status"] != "success" || data.dig("data", "address").to_s.empty?
+
+        d = data["data"]
+        token = JSON.generate("intToken" => int_token, "id" => d["id"].to_s, "update_tag" => d["update_tag"].to_s)
+        EmailInfo.new(channel: CHANNEL, email: d["address"], token: token)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @param token [String] JSON 编码的 intToken/id/update_tag
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        tkn = JSON.parse(token)
+        resp = Http.post("#{API_BASE}/getEmailList",
+                         headers: HEADERS,
+                         json: {
+                           "address" => email,
+                           "id" => tkn["id"].to_s,
+                           "intToken" => tkn["intToken"].to_s,
+                           "update_tag" => tkn["update_tag"].to_s
+                         })
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.dig("data", "hasNewEmail")
+
+        emails_raw = data.dig("data", "emails")
+        return [] unless emails_raw.is_a?(Array)
+
+        emails_raw.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          Normalize.normalize_email(raw, email)
+        end
+      rescue JSON::ParserError
+        raise "best-temp-mail: 无效的 token 格式"
+      end
+    end
+  end
+end