開発者ドキュメントSDK

Once Email SDK

受信専用 API 向けのオープンソース SDK 候補を7つのエコシステムでテストしています。

7 Once Email SDK

TypeScript、Python、Java、Go、.NET、PHP、Ruby は審査済みの OpenAPI 契約を共有します。ソース、資料、版、アーカイブは公開済みです。

Linux · macOS · Windows

Linux、macOS、Windows のネイティブ CI を通過しました。TypeScript と Python は自動テスト、他はビルドまたは構文検査を実行します。

公開状態

公式 Go モジュールプロキシには旧版の先行モジュール v0.1.0-private.1 が残っています。現在の Go SDK 候補はこのページの固定版アーカイブを参照してください。npm、PyPI、Maven Central、NuGet、Packagist、RubyGems の正式版はなく、API Key 作成と実呼び出しも一般公開されていません。現行アーカイブの SHA256SUMS を確認してください。

各アーカイブにコードと資料を含み、MANIFEST.txt と SHA256SUMS も提供します。
SDK を選ぶ

テストサービスの既存言語を使います。7クライアントは同じ受信専用契約に従います。

導入前に検証

不変版アーカイブを取得し SHA256SUMS と照合、同梱 README を読み、版を固定します。

処理範囲を限定

認可テストごとに受信箱を作り、期限内だけポーリングし、429/503を分け、メールやコードを記録せず finally で削除します。

SDK Demo

コード、資料、Demo をまとめて取得

固定版アーカイブにコード、資料、境界、チェックサムを含みます。

完全な使い方

SDK を選ぶ

所有または明示的に許可されたアプリだけをテストします。Once Email は受信専用です。

資料、ソース、SDK アーカイブ、Skill 先行版は公開済みです。各環境の公開状態は SDK ページで確認してください。 公開ドキュメントや先行版パッケージのダウンロードで API アクセス権が付与されることはありません。API キー作成と実際の呼び出しは一般公開されていません。

展開前に SHA256SUMS を確認します。

正確なローカル開始点

現在の 0.1.0-private.2 アーカイブ内の README にあるローカルコマンドを使います。Go Proxy の旧モジュールは別の先行版です。

取得からクリーンアップまで

  1. 許可済みサービスの既存言語を選びます。
  2. アーカイブを取得し SHA-256 を確認します。
  3. 版、契約、Runtime、ライセンス、状態を確認します。
  4. 現在の 0.1.0-private.2 アーカイブ内の README にあるローカルコマンドを使います。Go Proxy の旧モジュールは別の先行版です。
  5. API アクセスの明示的な許可と、必要最小限の権限を持つ発行済みの有効な認証情報がある場合だけ続行してください。認証情報はプロセスのシークレット管理機構に保管します。アクセス権がなければ資料とダウンロード内容の確認までにとどめてください。 キーを Secret から注入し期限内に実行します。
  6. finally で削除し機密データを表示しません。

失敗と復旧

400/401/403/404/413/429/503、期限、曖昧さ、抽出、検証、削除を区別し、固定期限内だけ再試行します。