開発者センター
Once Email API ドキュメント
自動メールテスト向けの公開資料：認証、割り当て、エラー、安全な利用規則。
資料は公開されています。APIキーは有効なDeveloper契約でのみ提供され、ダッシュボードで管理します。
認証
各リクエストに Authorization: Bearer oe_live_… を付けます。キーの完全表示は一度だけです。Secret Managerに保存し、ブラウザコード、ログ、Gitに置かないでください。
Authorization: Bearer oe_live_your_key基本フロー
- 1一時受信箱を作成し、返されたIDを保存します。
- 2テスト対象システムからそのアドレスへメールを送ります。
- 3バックオフを使って一覧を取得し、短い空ポーリングを避けます。
- 4対象メールを読み、検証後すぐ受信箱を削除します。
非公開ベータのエンドポイント
POST /v1/inboxesGET /v1/inboxes/{inboxId}/messagesGET /v1/inboxes/{inboxId}/messages/{uid}GET /v1/inboxes/{inboxId}/messages/{uid}/attachments/{cid}DELETE /v1/inboxes/{inboxId}ステータスコード
400無効なリクエスト
401キーがないか無効
403プランまたはリソースが拒否
404リソースが見つからない
429速度制限または月間上限
5xx一時的なサービス障害
クライアントの提供状況
TypeScript テストツールと Python クライアントには実装済みの基盤があります。インストール可能な公開パッケージや全言語 SDK はまだ提供していません。
課金状況
Developer は Stripe の月額契約と月間 API 枠を使用します。チャージ残高は提供しません。支払いと返金の検証完了まで Live 決済は閉じています。
利用範囲
権限のあるシステムのテストだけに使用してください。スパム、規則回避、アカウント乱用、他人の通信監視、個人データの長期保存は禁止です。
API は本番準備中です
先に公開契約を示します。キーと実呼び出しは決済Webhook、割り当て、回帰試験の完了後にのみ開放します。