开发者文档SDK
Once Email SDK
面向 Once Email 只收不发 API 的开源 SDK 候选版,提供七种生态的已测试下载。
7 Once Email SDK
TypeScript、Python、Java、Go、.NET、PHP 和 Ruby 共用一份经过审校的 OpenAPI 合同。源码、参考文档、版本和本地下载包均已公开。
npm ci && npm run buildpython -m pip install .mvn clean installgo mod edit -replace github.com/pangxin12345/once-email-sdks/sdks/go=./once-email-go-sdk-0.1.0-private.2dotnet build OnceEmail.Sdk.slncomposer installbundle install && gem build once_email.gemspec原生 CI 已在 Linux、macOS 和 Windows 通过。TypeScript 与 Python 执行自动化测试,其余语言执行可用的原生构建或语法门禁。
官方 Go 模块代理仍收录较早的 v0.1.0-private.1 预发布模块;当前 Go SDK 候选版以本页固定版本归档为准。npm、PyPI、Maven Central、NuGet、Packagist 和 RubyGems 尚无正式发行。API Key 创建与真实调用仍未向公众开放;使用当前归档前核对 SHA256SUMS。
使用测试服务本来就采用的语言,不要只为轮询邮箱增加第二套运行时;七种客户端遵循同一只收不发合同。
下载一个不可变版本归档,对照 SHA256SUMS 校验摘要,阅读包内 README,并在项目中固定版本。
每个授权测试创建一个邮箱,在统一截止时间内轮询,分别处理 429/503,不记录邮件或验证码,并在 finally 中删除邮箱。
完整使用指南
选择具体 SDK
只测试你拥有或明确获授权的应用。Once Email 只接收邮件,不发送邮件,也不自动操作第三方注册。
解压前先打开 SHA256SUMS 校验文件。
准确的本地起点
按当前 0.1.0-private.2 归档内 README 的本地构建或安装命令操作;Go Proxy 上的旧模块是另一预发布版本。
从下载到第一次完整清理
- 选择获授权测试服务本来就在使用的语言。
- 下载该语言归档,解压前校验对应 SHA-256。
- 确认 SDK 0.1.0-private.2、API 合同 0.5.0-private-beta、运行时、许可证和预发布状态。
- 按当前 0.1.0-private.2 归档内 README 的本地构建或安装命令操作;Go Proxy 上的旧模块是另一预发布版本。
- 仅在已明确获得 API 访问授权、并已持有最小必要权限的有效凭据时继续。凭据存入进程密钥设施;没有此访问资格时,只阅读文档和查看下载内容。 通过进程密钥设施注入 Key,在一个截止时间内完成创建、列表、读取和错误处理。
- 无论成功失败都在 finally 删除,禁止输出地址、邮件、验证码、链接或 Key。
失败与恢复
必须区分 400、401、403、404、413、429 和 503;超时、歧义、提取、断言和清理也是不同失败。只在统一截止时间内重试,不能把依赖失败当成空收件箱。