使用欧盟区域Mailgun API验证Java邮箱遇403权限问题求助

问题描述 #

使用Java代码调用Mailgun欧盟区域API（https://api.eu.mailgun.net/）进行邮箱地址验证时，返回403 Forbidden错误，错误信息为：

{"message":"This feature is unavailable please contact support."}

调用代码 #

MailgunEmailVerificationApi mailgunEmailVerificationApi = MailgunClient.config("https://api.eu.mailgun.net/", "b6bbdb234cf9dc46250diu606c9e5c198-324e0bb2-46091a28")
    .logLevel(feign.Logger.Level.FULL)
    .createApi(MailgunEmailVerificationApi.class);

log.info("mail Validation {} ", mailgunEmailVerificationApi.validateAddress("foo@mailgun.com"));

完整请求日志 #

11:29:24.159 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] ---> GET https://api.eu.mailgun.net/v4/address/validate?address=foo%40mailgun.com HTTP/1.1
11:29:24.160 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] Accept: application/json
11:29:24.160 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] Authorization: Basic YXBpOmI2YmJkYjIzNGNmOBkYzYwNmM5ZTVjMTnj84LTMyNGUwYmIyLTQ2MDkxYTI4
11:29:24.160 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] ---> END HTTP (0-byte body)
11:29:24.490 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] <--- HTTP/1.1 403 Forbidden (329ms)
11:29:24.490 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] access-control-allow-credentials: true
11:29:24.490 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] access-control-allow-origin: *
11:29:24.490 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] cache-control: no-store
11:29:24.490 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] content-length: 66
11:29:24.490 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] content-type: application/json; charset=utf-8
11:29:24.490 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] date: Thu, 26 Oct 2023 08:29:24 GMT
11:29:24.490 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] strict-transport-security: max-age=63072000; includeSubDomains
11:29:24.490 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] x-xss-protection: 1; mode=block
11:29:24.490 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress]
11:29:24.491 [main] INFO com.mailgun.util.ConsoleLogger -- [MailgunEmailVerificationApi#validateAddress] {"message":"This feature is unavailable please contact support."}

错误原因分析 #

• 套餐权限限制：Mailgun的邮箱地址验证功能（V4 API的/v4/address/validate接口）仅对特定付费套餐开放，免费账户或基础套餐默认无法使用该功能。
• API密钥权限不足：使用的API密钥可能是域名级别的受限密钥，而非拥有全功能访问权限的主API密钥，导致无法调用验证接口。
• 区域服务限制：欧盟区域的Mailgun服务可能对地址验证功能有额外的开通要求，需要单独确认该区域是否支持此服务。
• 账户状态异常：账户存在未结清账单、违规操作等情况，导致功能被临时限制。

解决办法 #

• 检查账户套餐：登录Mailgun控制台，确认当前账户套餐是否包含邮箱地址验证服务，若为免费版需升级至对应的付费套餐。
• 更换主API密钥：使用Mailgun账户的主API密钥（而非域名密钥）进行调用，主密钥可在控制台的"API Keys"页面获取，拥有全接口访问权限。
• 确认区域服务可用性：确认欧盟区域API是否支持地址验证功能，若需单独开通，按照平台指引完成操作。
• 联系官方支持：若以上操作均无法解决问题，直接联系Mailgun支持团队，提供账户ID、请求日志等信息，排查账户层面的功能限制。

内容的提问来源于stack exchange，提问作者Nunyet Calçada