وثائق API

استخدم واجهة REST لإنشاء عناوين مؤقتة وقراءة رسائلها من برامجك. سجّل الدخول وانسخ مفتاح API من لوحة التحكم.

Authentication

Send your key in the X-API-Key header (or Authorization: Bearer KEY). Limit: 60 requests / minute.

curl -H "X-API-Key: YOUR_API_KEY" https://www.tempinboxer.com/api/v1/domains

تسجيل الدخول → لوحة التحكم → مفتاح API الخاص بك

Endpoints

List active domains.

{"ok":true,"domains":["example.com","example.net"]}

Create (reserve) an address. Both parameters are optional – a random name and the default domain are used when omitted.

{"ok":true,"address":"john@example.com"}

List the latest messages (max 100).

{"ok":true,"address":"john@example.com","count":1,"messages":[
  {"id":42,"from_name":"GitHub","from_email":"noreply@github.com","subject":"Verify your email",
   "preview":"Your code is 123456","attachments":0,"read":false,"received_at":"2026-01-01T12:00:00Z"}
]}

Read a full message (text, html and attachment links).

Delete one message.

Delete all messages of an address.

Example (JavaScript)

const KEY = "YOUR_API_KEY";
const api = (p) => fetch("https://www.tempinboxer.com/api/v1" + p, { headers: { "X-API-Key": KEY } }).then(r => r.json());

const { address } = await api("/mailbox");
// ...use the address on a sign-up form, then:
const { messages } = await api("/inbox?address=" + encodeURIComponent(address));