开发者文档SDK

Once Email SDK

面向 Once Email 只收不发 API 的开源 SDK 候选版,提供七种生态的已测试下载。

7 Once Email SDK

TypeScript、Python、Java、Go、.NET、PHP 和 Ruby 共用一份经过审校的 OpenAPI 合同。源码、参考文档、版本和本地下载包均已公开。

Linux · macOS · Windows

原生 CI 已在 Linux、macOS 和 Windows 通过。TypeScript 与 Python 执行自动化测试,其余语言执行可用的原生构建或语法门禁。

发布状态

官方 Go 模块代理仍收录较早的 v0.1.0-private.1 预发布模块;当前 Go SDK 候选版以本页固定版本归档为准。npm、PyPI、Maven Central、NuGet、Packagist 和 RubyGems 尚无正式发行。API Key 创建与真实调用仍未向公众开放;使用当前归档前核对 SHA256SUMS。

每个归档同时包含代码和文档;发布页另提供 MANIFEST.txt 与 SHA256SUMS。
选择 SDK

使用测试服务本来就采用的语言,不要只为轮询邮箱增加第二套运行时;七种客户端遵循同一只收不发合同。

安装前校验

下载一个不可变版本归档,对照 SHA256SUMS 校验摘要,阅读包内 README,并在项目中固定版本。

限制工作流边界

每个授权测试创建一个邮箱,在统一截止时间内轮询,分别处理 429/503,不记录邮件或验证码,并在 finally 中删除邮箱。

SDK Demo

代码、文档和 Demo 一起下载

版本归档包含源码、说明、安全边界和校验值。

完整使用指南

选择具体 SDK

只测试你拥有或明确获授权的应用。Once Email 只接收邮件,不发送邮件,也不自动操作第三方注册。

文档、源码、SDK 归档与 Skill 预发布包已公开;各生态的发行状态请查 SDK 页。 公开文档和预发布包下载不代表获得 API 访问权限;API Key 创建和真实调用尚未公开开放。

解压前先打开 SHA256SUMS 校验文件。

准确的本地起点

按当前 0.1.0-private.2 归档内 README 的本地构建或安装命令操作;Go Proxy 上的旧模块是另一预发布版本。

从下载到第一次完整清理

  1. 选择获授权测试服务本来就在使用的语言。
  2. 下载该语言归档,解压前校验对应 SHA-256。
  3. 确认 SDK 0.1.0-private.2、API 合同 0.5.0-private-beta、运行时、许可证和预发布状态。
  4. 按当前 0.1.0-private.2 归档内 README 的本地构建或安装命令操作;Go Proxy 上的旧模块是另一预发布版本。
  5. 仅在已明确获得 API 访问授权、并已持有最小必要权限的有效凭据时继续。凭据存入进程密钥设施;没有此访问资格时,只阅读文档和查看下载内容。 通过进程密钥设施注入 Key,在一个截止时间内完成创建、列表、读取和错误处理。
  6. 无论成功失败都在 finally 删除,禁止输出地址、邮件、验证码、链接或 Key。

失败与恢复

必须区分 400、401、403、404、413、429 和 503;超时、歧义、提取、断言和清理也是不同失败。只在统一截止时间内重试,不能把依赖失败当成空收件箱。