2026 GoDaddy Email API 资格检查失败怎么办？先查测试邮箱能否创建

先按响应分流，不要重复提交创建

资格检查是创建前的条件评估，不是创建结果。GoDaddy 的说明要求先调用资格检查；若返回 422，地址当前不符合创建条件，应检查错误详情，而不是继续提交创建请求。邮箱创建指南

先分清响应处在哪一层：成功的资格结果会提供是否符合条件及可用的 eligibleAccounts；账户方案条目可能带有 requirements。失败响应则要查看 Email API 专用错误结构里的 name 和 details[]，其中 issue 是定位字段问题的线索。不要假定每种响应都会同时包含全部字段。资格检查接口参考；Email 错误结构说明

上表是排查起点，不是对所有账户状态的完整枚举。GoDaddy 的指南将 EMAIL_PLAN_NOT_AVAILABLE 列为资格检查 422 的示例；创建指南则将 409 归为地址已存在的冲突，并提示检查 403 是权限不足还是域名不属于认证账户。创建指南中的常见错误

域名、方案与地址问题要分开查

GoDaddy Email API 处理的是认证账户拥有的域名；资格检查还会判断可用于创建的 entitlements 及其条件。因此，资格失败不一定是邮箱格式错误。先核对调用凭证属于哪个账户、该账户是否拥有目标域名，再看 eligibleAccounts 是否列出可用方案。Email API 概览

当 EMAIL_PLAN_NOT_AVAILABLE 出现在资格检查详情中，优先检查方案和 entitlement，而不是连续改写地址。若响应列出多个可用账户或方案，确认创建请求里的 accountId 选择了预期条目；若没有可用项，再由有权限的人单独确认账户方案和购买权限。官方材料没有给出适用于所有账户的固定购买金额，不要把购买说成创建每个邮箱都必需的固定价格。

地址格式与地址冲突也不是一类问题。若响应说明地址字段格式无效，核对传入的完整地址是否有拼写、空格或编码问题，并遵循接口对该地址字段的校验；不要自行推断其他邮件系统的地址规则。若创建请求发生冲突，则先查是否已有该地址对应的邮箱资源，不要通过注册第三方平台账户来绕过地址占用。

requirements 是待审核条件，不是自动同意

eligibleAccounts 中的方案可能附带 requirements。GoDaddy 的说明举例指出，某些试用 entitlement 可能要求接受自动续费相关条件；创建时需要把已确认接受的对应条件放进 consents，创建后的邮箱资源会记录接受情况。Email API 的资格与同意说明

实际流程应是：先展示条件，再由有权限的账户持有人确认，最后才将匹配的同意项提交给创建接口。不要把示例中的某个 type 固定写成所有账户通用的清单，也不要在用户尚未确认时自动勾选。请求字段与 requirements[].type 的对应关系，按当前创建邮箱接口参考核对。

按里程碑完成检查、创建与收件验收

你可以把下面的清单用于一次自有产品或获授权环境的测试。每项都保存对应证据，避免把“资格通过”误记成“邮箱已创建”或“邮件已收”。

• [ ] 确认测试地址所在域名由当前认证账户拥有，并确认凭证具备创建邮箱所需的权限范围。
• [ ] 调用 GET /v1/email/check-mailbox-eligibility，记录请求地址、HTTP 状态、响应中的 isEligible、eligibleAccounts 及错误详情。
• [ ] 若返回失败，先按 details[].issue 和字段位置定位问题；遇到 EMAIL_PLAN_NOT_AVAILABLE，优先核对域名 entitlement 与账户方案。
• [ ] 若响应列出 requirements，先让有权限的账户持有人审核；只把已确认接受的匹配项目提交为 consents。
• [ ] 资格符合后，再调用创建接口；为创建请求设置 Idempotency-Key，并保存创建响应中的邮箱标识和初始状态。
• [ ] 依据创建结果继续查询邮箱资源；不要把预检成功或请求已接受当作创建完成。
• [ ] 从你的产品或测试发件端向该地址发送测试邮件，再通过该邮箱实际支持的收件方式核对邮件内容、主题和发件信息。

官方文档说明创建接口返回 202 Accepted 时，初始状态为 EXECUTING，之后需查询资源直至状态到达 COMPLETED 或 FAILED。这就是资格检查与实际创建之间仍可能出现状态变化的原因；创建是否成功以资源状态为准，而实收还需要独立测试。

如果返回 EMAIL_ADDRESS_ALREADY_EXISTS，按响应定位并检查已有邮箱资源；如果返回 EMAIL_ADDRESS_INVALID，先核对地址字段及错误详情。当前官方接口材料能支持的通用判断是：创建时 409 表示资源冲突，地址格式或请求参数问题应结合错误详情判断；不要只按 HTTP 状态或某个未经接口文档确认的字符串做统一处理。

资格通过后，测试地址还要匹配验收目标

如果你的目标是测试自有域名下的邮箱能否创建，临时收件地址不能替代 GoDaddy 的资格检查或该域名的邮箱创建；你仍要按上面的里程碑验收目标邮箱。若只是验证自家产品发出的一封邮件能否进入一个可读取的收件箱，临时收件可以作为待核实的方案之一，前提是测试系统允许使用该地址，并且你能在有效期间完成检查。

FadeInbox 首页标示无需注册，并显示临时地址默认保留 3 小时、到期时地址与邮件一并销毁；这是短时收件的使用边界，不是 GoDaddy 邮箱资源，也不是长期测试账号的找回方案。查看 FadeInbox 临时收件页面 如果测试需要持续收通知、回信或长期找回账户，应改用你控制的长期邮箱或转发别名；需要选择收件类型时，可参考一次性邮箱与长期别名的适用边界。邮件已发送但收件箱没有内容时，再按验证码与邮件到达排查步骤逐项确认地址、发件状态和收件证据。

常见问题

资格检查返回不符合条件时，能否直接重试创建？
不能。先查看错误状态与 details[]，定位是方案、域名权限还是输入字段问题；资格检查返回 422 时，官方指南建议停止创建操作。修正原因后重新检查，再根据最新响应决定是否创建。

EMAIL_PLAN_NOT_AVAILABLE 应该从哪里查起？
先看目标域名是否有可用的账户 entitlement，以及请求选择的账户方案是否匹配。不要先把它当作地址格式错误，也不要假定购买某个固定价格的方案就一定能通过。

EMAIL_ADDRESS_ALREADY_EXISTS 和 EMAIL_ADDRESS_INVALID 怎么区分？
前者指向资源冲突，按响应检查已有邮箱；后者指向地址输入或格式校验，检查实际传入字段。还要核对当前接口文档和响应详情，因为可用的错误标识可能随接口定义而异。

返回 requirements 后，创建请求怎样带同意项？
先由有权限的账户持有人审核并确认接受，再将与返回条件匹配的项目作为 consents 提交。不要硬编码固定同意项，也不要自动代替账户持有人作出接受决定。

如果你只是想验证一封测试邮件能否进入一个临时收件箱，可以打开 FadeInbox 查看其当前页面说明，再判断它是否符合你的测试边界；它不能替你通过 GoDaddy 的资格检查，也不适合需要长期收信、回信或找回的重要账户。