開発者向けAPI

受信トレイを作成

POST https://10genmail.com/api/inbox

リクエストボディは不要。新しいアドレスと空のメール一覧を返します。

{
  "address": "quick-fox-abc123@10genmail.com",
  "slug": "quick-fox-abc123",
  "createdAt": 1234567890123,
  "expiresAt": 1234568490123,
  "ttlSeconds": 600,
  "messages": []
}

レート制限：IPあたり1分間に10リクエスト。

受信トレイを取得

GET https://10genmail.com/api/inbox?address=...

クエリ：address（URLエンコードしたメールアドレス）。受信トレイとメールを返します。期限切れの場合は404。

{
  "address": "quick-fox-abc123@10genmail.com",
  "slug": "quick-fox-abc123",
  "createdAt": 1234567890123,
  "expiresAt": 1234568490123,
  "ttlSeconds": 420,
  "messages": [
    {
      "id": "msg-...",
      "from": { "name": null, "email": "sender@example.com" },
      "subject": "Hello",
      "text": "...",
      "html": null,
      "date": "...",
      "timestamp": 1234567900000
    }
  ]
}

レート制限：1分あたり120リクエスト（IP単位）。

有効期限を延長

POST https://10genmail.com/api/inbox/extend

ボディ：{ "address": "..." }。10分延長。作成時から合計30分まで。更新後の受信トレイを返します。

レート制限：取得と同じ（120/分）。