PHP

$client->tempMail

كل دالّة في مساحة الأسماء هذه: توقيعها ومعلماتها وما تُرجعه ومثال عليها.

الدوالّ

Short lived inboxes that need no account, authorised by the token they were created with. OpenEmail::createTempMail() reaches them without an API key, and on a client the token goes in as inboxToken:.

`tempMail->listDomains`

List the domains a disposable inbox can be created on

بلا بيانات اعتماد

التوقيع

listDomains(?string $inboxToken = null): array

Returns the pool of domains tempMail->create accepts, as a plain list in the order the operator wrote them in TEMP_MAIL_DOMAINS. It takes no credential at all: no API key and no inbox token are sent, even when the client holding this namespace has one.

Nothing checks that a listed domain is verified, so the list is only as good as the operator made it. An empty list is a normal answer meaning this install offers no disposable domains, and it is exactly the condition under which tempMail->create fails with 503 not_configured.

المعلمات

inboxTokenstring: Accepted for symmetry with the other methods and never sent, because this call is anonymous.

يُرجع

A list of arrays, each with object set to temp_domain and a lowercased domain to pass back to tempMail->create.

مثال

$domains = $client->tempMail->listDomains(); if ($domains === []) {    echo 'This install offers no disposable inboxes', PHP_EOL;} else {    echo implode(', ', array_column($domains, 'domain')), PHP_EOL;}

ملاحظات

The pool is server configuration, so a domain appears when the operator adds it to TEMP_MAIL_DOMAINS, not when it is added to a workspace.
Retried automatically on network failure and retryable statuses, like every GET.

متاح أيضًا في

API: GET /temp-mail/domains
TypeScript: tempMail.listDomains()
Python: temp_mail.list_domains()
Ruby: temp_mail.list_domains
CLI: openemail temp-mail list-domains

`tempMail->create`

Create a disposable inbox and its access token

بلا بيانات اعتماد

التوقيع

create(?array $body = null, ?string $inboxToken = null): array

Mints a disposable address and returns the inbox plus its token. It needs no credential, and only this call and tempMail->extend return a token. The token is the lease itself, signed, and nothing about it is stored on the server, so a lost token cannot be recovered, and every other method except tempMail->listDomains needs it. Store it before you show the address to anyone.

The body is optional and so is every field in it. With nothing, you get a 12 character generated local part on the first domain in the pool, leased for 60 minutes. A chosen localPart is lowercased and must be up to 64 letters, digits, dots, dashes or underscores, starting and ending with a letter or digit, or it is 422 invalid_address, and one longer than 64 characters is 422 invalid_parameter. Names such as postmaster, abuse and support are 422 reserved_address, and an install with no pooled domain answers 503 not_configured.

Nothing is rate limited and nothing reserves an address, so this never answers 429 or 409. A name you choose is issued to anyone who asks for it, and each of you reads the mail that reaches it from the start of your own lease. Leave localPart out when the mail should reach you alone.

المعلمات

domainstring: A domain from tempMail->listDomains. Omit it for the first one in the pool. Any other name is 422 unknown_domain rather than a silent substitute.
localPartstring: The part before the @. Omit it for a generated one, which nobody else is likely to be issued.
ttlMinutesint: Lease length from now, a whole number from 1 to 1440. Defaults to 60. Out of range is 422 invalid_parameter, not clamped.
inboxTokenstring: Ignored and never sent. Creating an inbox is anonymous and hands you the token instead.

يُرجع

An array with the inbox fields id, address, domain, createdAt, expiresAt, extensionsLeft, messageCount, messageLimit and lastMessageAt, plus the one time token beginning oe_inbox_.

مثال

$inbox = $client->tempMail->create(['ttlMinutes' => 120]); file_put_contents('.temp-inbox-token', $inbox['token']); echo 'Send the confirmation to ', $inbox['address'], ' before ', $inbox['expiresAt'], PHP_EOL;

ملاحظات

Not retried automatically. A retry would mint a second inbox, and the first would be unreachable because its only token was in the lost response.
Nothing holds an address back after its lease ends or its inbox is deleted, so it can be issued again at once, to anybody.
A lease of 1440 minutes reaches the 24 hour ceiling at once, yet the inbox still comes back with extensionsLeft at 23, because that counts calls rather than time. None of them can add a minute.
Unknown body keys are 422 invalid_parameter, while a body that is not valid JSON is treated as an empty one.

متاح أيضًا في

API: POST /temp-mail/inboxes
TypeScript: tempMail.create()
Python: temp_mail.create()
Ruby: temp_mail.create
CLI: openemail temp-mail create

`tempMail->get`

Read the lease and counters of a disposable inbox

رمز صندوق الوارد

التوقيع

get(string $inboxId, ?string $inboxToken = null): array

Returns the inbox with its expiry, remaining extensions and message counters, without any messages. To watch an inbox, poll tempMail->listMessages instead: it returns expiresAt alongside the mail, so one request covers both.

This call is authorised by the inbox token, never by an API key. A workspace key sent in its place is refused with 401 missing_inbox_token, and no scope on any key reaches this resource. The token alone decides which inbox is read, and the id in the path is not checked against it.

Once the lease is over the token answers 401 inbox_expired, and a token this server did not sign answers 404 resource_not_found. Deleting an inbox does not end its lease, so its token still reads it. messageCount is counted by reading every page, and is 0 when the install cannot read the mailbox that runs the pool.

المعلمات

inboxIdstringمطلوب: The tinb_ id tempMail->create returned. It is not checked against the token, which alone decides the inbox.
inboxTokenstring: The oe_inbox_ token tempMail->create returned. Overrides the token given to OpenEmail::createTempMail for this call, and is required on the OpenEmail client, which would otherwise send its API key.

يُرجع

An array with id, address, domain, createdAt, expiresAt, extensionsLeft, messageCount, messageLimit and lastMessageAt.

مثال

$inbox = $client->tempMail->get('tinb_k7m2q9xw4bdp', inboxToken: getenv('OPENEMAIL_INBOX_TOKEN') ?: null); echo $inbox['address'], ': ', $inbox['messageCount'], ' messages, expires ', $inbox['expiresAt'], PHP_EOL;echo $inbox['extensionsLeft'], ' extensions left', PHP_EOL;

ملاحظات

A token that does not start with oe_inbox_ is 401 missing_inbox_token, the same as no token at all. One that starts with it but was not signed by this server is 404 resource_not_found.
messageCount counts every message the inbox is showing, across every page, and goes down when one is deleted. messageLimit, which is 50, is the page size of tempMail->listMessages, not a ceiling: nothing past it is dropped.

متاح أيضًا في

API: GET /temp-mail/inboxes/{id}
TypeScript: tempMail.get()
Python: temp_mail.get()
Ruby: temp_mail.get
CLI: openemail temp-mail get

`tempMail->extend`

Push the expiry of an inbox an hour further out

رمز صندوق الوارد

التوقيع

extend(string $inboxId, ?string $inboxToken = null): array

Adds up to 60 minutes to expiresAt and returns the updated inbox and a new token that carries the later expiry. There is no body. The old token keeps its old expiry, so use the new one from here on, including in a TempMail made with OpenEmail::createTempMail(inboxToken: ...).

The new expiry is the earlier of one hour past the current expiry and 24 hours after createdAt, and a lease allows at most 23 extensions. The last extension can buy less than an hour, and on a lease that already reaches the 24 hours a call still succeeds, spends an extension and buys nothing. extensionsLeft counts only the 23 calls, so compare expiresAt with createdAt before offering more time.

When extensionsLeft is 0 this answers 422 extension_limit for good, and the only way on is a new inbox. The response reads no mail, so its messageCount is 0 and its lastMessageAt is null.

المعلمات

inboxIdstringمطلوب: The tinb_ id tempMail->create returned. It is not checked against the token, which alone decides the inbox.
inboxTokenstring: The oe_inbox_ token tempMail->create returned. Overrides the token given to OpenEmail::createTempMail for this call, and is required on the OpenEmail client, which would otherwise send its API key.

يُرجع

An array with the inbox fields, the new expiresAt and the updated extensionsLeft, plus the new token beginning oe_inbox_.

مثال

use OpenEmail\Exception\ApiException; try {    $inbox = $client->tempMail->extend('tinb_k7m2q9xw4bdp', inboxToken: getenv('OPENEMAIL_INBOX_TOKEN') ?: null);     file_put_contents('.temp-inbox-token', $inbox['token']);     echo 'Now expires ', $inbox['expiresAt'], ', ', $inbox['extensionsLeft'], ' extensions left', PHP_EOL;} catch (ApiException $error) {    if ($error->errorCode !== 'extension_limit') {        throw $error;    }     echo 'This inbox cannot be extended again', PHP_EOL;}

ملاحظات

Not retried automatically, because a replay would spend a second extension.
An inbox created with 'ttlMinutes' => 1440 still reports extensionsLeft at 23, and none of them can add a minute.

متاح أيضًا في

API: POST /temp-mail/inboxes/{id}/extend
TypeScript: tempMail.extend()
Python: temp_mail.extend()
Ruby: temp_mail.extend
CLI: openemail temp-mail extend

`tempMail->delete`

Move the mail in a disposable inbox to the bin now

رمز صندوق الوارد

التوقيع

delete(string $inboxId, ?string $inboxToken = null): array

Moves every message the inbox shows to the bin of the mailbox that runs the pool, at once. It does not end the lease: nothing about a lease is stored, so there is nothing to revoke, and the token keeps opening the address until its expiry. Mail that arrives afterwards is listed as usual.

Nothing holds the address back either, so it can be issued again at once, to anybody. An install with no key to read the pool answers 503 not_configured.

The response is a tombstone rather than an empty body, so a log line can name what went.

المعلمات

inboxIdstringمطلوب: The tinb_ id tempMail->create returned. It is not checked against the token, which alone decides the inbox.
inboxTokenstring: The oe_inbox_ token tempMail->create returned. Overrides the token given to OpenEmail::createTempMail for this call, and is required on the OpenEmail client, which would otherwise send its API key.

يُرجع

An array with object set to temp_inbox, the id and destroyed set to true.

مثال

$result = $client->tempMail->delete('tinb_k7m2q9xw4bdp', inboxToken: getenv('OPENEMAIL_INBOX_TOKEN') ?: null); if ($result['destroyed']) {    echo 'Moved the mail in ', $result['id'], ' to the bin', PHP_EOL;}

ملاحظات

The flag is destroyed, not deleted as on other tombstones.
Not retried automatically. Repeating it is harmless: the lease still stands, so a second call answers 200 and moves whatever has arrived since.

متاح أيضًا في

API: DELETE /temp-mail/inboxes/{id}
TypeScript: tempMail.delete()
Python: temp_mail.delete()
Ruby: temp_mail.delete
CLI: openemail temp-mail delete

`tempMail->listMessages`

List one page of the messages in a disposable inbox

رمز صندوق الوارديتصفح النتائج صفحةً صفحة

التوقيع

listMessages(    string $inboxId,    ?int $limit = null,    ?string $cursor = null,    ?string $inboxToken = null,): TempMessagesPage

Returns one page of the messages in the inbox newest first, by the time the server received them, together with the inbox expiresAt. Rows carry metadata only, and polling this is the way to wait for a confirmation email. Only mail delivered to this address since the lease began is listed.

A page holds up to 50 messages. When more have arrived, hasMore is true and nextCursor goes back as cursor: for the next page, so nothing that reached the inbox is hidden. tempMail->listAllMessages and tempMail->iterateMessages do that walk for you. A page can hold fewer than limit: rows, even none, while hasMore is true, because mail to other addresses on the pool is read and dropped. snippet is plain text capped at 400 characters, which is often enough to read a one time code without opening the message.

spam is a flag, never a filing decision. A machine sent confirmation from a sender with no reputation is exactly what a disposable inbox exists to receive, so flagged messages are still listed. from is whatever the message claimed and has not been authenticated.

المعلمات

inboxIdstringمطلوب: The tinb_ id tempMail->create returned. It is not checked against the token, which alone decides the inbox.
limitint: Messages per page, a whole number from 1 to 50, defaulting to 50. Out of range is 422 invalid_parameter.
cursorstring: The nextCursor from the previous page. Never build one yourself.
inboxTokenstring: The oe_inbox_ token tempMail->create returned. Overrides the token given to OpenEmail::createTempMail for this call, and is required on the OpenEmail client, which would otherwise send its API key.

يُرجع

A TempMessagesPage with items, a list of message arrays (id, from, to, subject, snippet, spam, seen, attachmentCount, sizeBytes, receivedAt), hasMore, nextCursor and the inbox expiresAt.

مثال

$token = getenv('OPENEMAIL_INBOX_TOKEN') ?: null; do {    sleep(5);     $page = $client->tempMail->listMessages('tinb_k7m2q9xw4bdp', limit: 10, inboxToken: $token);} while (count($page) === 0); $latest = $page->items[0]; echo $latest['from']['email'], ': ', $latest['subject'], PHP_EOL;echo 'The inbox expires ', $page->expiresAt, PHP_EOL;

ملاحظات

A message whose Message-ID header matches one already in the inbox is not stored twice.
to is the inbox address. A +tag the sender added is folded back into the base address.
Every message the inbox has received is listed, a page at a time. messageLimit on the inbox is the size the tool is built for, not a point past which mail is hidden.
An install with no key to read the pool answers 503 not_configured.

متاح أيضًا في

API: GET /temp-mail/inboxes/{id}/messages
TypeScript: tempMail.listMessages()
Python: temp_mail.list_messages()
Ruby: temp_mail.list_messages
CLI: openemail temp-mail list-messages

`tempMail->listAllMessages`

Collect every message in a disposable inbox into one array

رمز صندوق الوارديتصفح النتائج صفحةً صفحة

التوقيع

listAllMessages(    string $inboxId,    ?int $limit = null,    ?string $cursor = null,    ?string $inboxToken = null,): array

Follows nextCursor from page to page and returns every message the inbox has received, newest first. Rows carry metadata only, as on tempMail->listMessages.

المعلمات

inboxIdstringمطلوب: The tinb_ id tempMail->create returned.
limitint: Page size per request, from 1 to 50, defaulting to 50.
cursorstring: A cursor from an earlier page to start after.
inboxTokenstring: The oe_inbox_ token tempMail->create returned, sent with every page.

يُرجع

A list of message arrays holding every message across all pages.

مثال

$messages = $client->tempMail->listAllMessages('tinb_k7m2q9xw4bdp', inboxToken: getenv('OPENEMAIL_INBOX_TOKEN') ?: null); foreach ($messages as $message) {    echo $message['receivedAt'], ' ', $message['from']['email'], ' ', $message['subject'], $message['spam'] ? ' (flagged as spam)' : '', PHP_EOL;}

ملاحظات

A failure on any page throws out of the whole call, and none of the pages already read are returned.

متاح أيضًا في

API: GET /temp-mail/inboxes/{id}/messages
TypeScript: tempMail.listAllMessages()
Python: temp_mail.list_all_messages()
Ruby: temp_mail.list_all_messages

`tempMail->iterateMessages`

Stream the messages in a disposable inbox one at a time

رمز صندوق الوارديتصفح النتائج صفحةً صفحة

التوقيع

iterateMessages(    string $inboxId,    ?int $limit = null,    ?string $cursor = null,    ?string $inboxToken = null,): Generator

Returns a Generator that yields the inbox messages one at a time, newest first, and requests the next page only once the current one is used up. Breaking out of the foreach stops the requests.

المعلمات

inboxIdstringمطلوب: The tinb_ id tempMail->create returned.
limitint: Page size per request, from 1 to 50, defaulting to 50.
cursorstring: A cursor from an earlier page to start after.
inboxTokenstring: The oe_inbox_ token tempMail->create returned, sent with every page.

يُرجع

A Generator that yields one message array per step.

مثال

$token = getenv('OPENEMAIL_INBOX_TOKEN') ?: null;$code = null; foreach ($client->tempMail->iterateMessages('tinb_k7m2q9xw4bdp', inboxToken: $token) as $message) {    if (preg_match('/\b\d{6}\b/', $message['snippet'], $match) === 1) {        $code = $match[0];         break;    }} echo $code ?? 'No code yet', PHP_EOL;

ملاحظات

The generator is lazy, so an abandoned loop costs only the pages you consumed.

متاح أيضًا في

API: GET /temp-mail/inboxes/{id}/messages
TypeScript: tempMail.iterateMessages()
Python: temp_mail.iterate_messages()
Ruby: temp_mail.iterate_messages

`tempMail->getMessage`

Read one message with its stored body

رمز صندوق الوارد

التوقيع

getMessage(string $inboxId, string $messageId, ?string $inboxToken = null): array

Returns the list row for one message plus the parsed message as stored. Reading it does not mark it seen: seen mirrors the unread state of the message in the mailbox that runs the pool, and nothing on these routes changes it.

Render message.decodedBody. body and processedHtml are empty strings for every message that can reach a disposable inbox, so a client reading either shows a blank page. The body is never cut, so truncated is always false.

The HTML came from a stranger to an address anyone could name. Render it outside your own origin, for example in a sandboxed iframe.

المعلمات

inboxIdstringمطلوب: The tinb_ id tempMail->create returned. It is not checked against the token, which alone decides the inbox.
messageIdstringمطلوب: An id from tempMail->listMessages, such as thr_ and 24 hex.
inboxTokenstring: The oe_inbox_ token tempMail->create returned. Overrides the token given to OpenEmail::createTempMail for this call, and is required on the OpenEmail client, which would otherwise send its API key.

يُرجع

An array with every field of a tempMail->listMessages row plus message, the stored parsed message, and truncated.

مثال

$token = getenv('OPENEMAIL_INBOX_TOKEN') ?: null; $detail = $client->tempMail->getMessage('tinb_k7m2q9xw4bdp', 'thr_9e3b7c1a5f2d8e40b6a9c3f1', inboxToken: $token); $html = $detail['message']['decodedBody'] ?? null; echo '<h1>', htmlspecialchars($detail['subject']), '</h1>', PHP_EOL; if (is_string($html)) {    echo '<iframe sandbox srcdoc="', htmlspecialchars($html), '"></iframe>', PHP_EOL;}

ملاحظات

A message this lease cannot see, deleted ones included, is 404 resource_not_found. An expired lease is 401 inbox_expired, and an install with no key to read the pool answers 503 not_configured.
message is an array with no fixed shape, so check that decodedBody is a string before rendering it.

متاح أيضًا في

API: GET /temp-mail/inboxes/{id}/messages/{messageId}
TypeScript: tempMail.getMessage()
Python: temp_mail.get_message()
Ruby: temp_mail.get_message
CLI: openemail temp-mail get-message

`tempMail->deleteMessage`

Delete one message from a disposable inbox

رمز صندوق الوارد

التوقيع

deleteMessage(string $inboxId, string $messageId, ?string $inboxToken = null): array

Moves the message, attachments and all, to the bin of the mailbox that runs the pool, and no lease lists or opens it again. Nothing in this SDK restores it.

messageCount goes down by one. There is never a slot to free: an inbox keeps every message that reaches it, and tempMail->listMessages pages through all of them.

المعلمات

inboxIdstringمطلوب: The tinb_ id tempMail->create returned. It is not checked against the token, which alone decides the inbox.
messageIdstringمطلوب: An id from tempMail->listMessages, such as thr_ and 24 hex.
inboxTokenstring: The oe_inbox_ token tempMail->create returned. Overrides the token given to OpenEmail::createTempMail for this call, and is required on the OpenEmail client, which would otherwise send its API key.

يُرجع

An array with object set to temp_message, the message id and deleted set to true.

مثال

$token = getenv('OPENEMAIL_INBOX_TOKEN') ?: null; $result = $client->tempMail->deleteMessage('tinb_k7m2q9xw4bdp', 'thr_9e3b7c1a5f2d8e40b6a9c3f1', inboxToken: $token); if ($result['deleted']) {    echo 'Moved ', $result['id'], ' to the bin', PHP_EOL;}

ملاحظات

An unknown or already deleted message id is 404 resource_not_found, and an install with no key to read the pool answers 503 not_configured.
Not retried automatically. If you repeat it yourself after a lost response, that 404 means the first attempt already worked.

متاح أيضًا في

API: DELETE /temp-mail/inboxes/{id}/messages/{messageId}
TypeScript: tempMail.deleteMessage()
Python: temp_mail.delete_message()
Ruby: temp_mail.delete_message
CLI: openemail temp-mail delete-message

`tempMail->listAttachments`

List the attachments of a message, metadata only

رمز صندوق الوارد

التوقيع

listAttachments(string $inboxId, string $messageId, ?string $inboxToken = null): array

Returns every attachment on a message as a plain list of metadata: attachmentId, filename, mimeType and size in decoded bytes, with body an empty string and headers empty. No route on a disposable inbox serves the bytes, and there is no per attachment fetch.

filename and mimeType are whatever the sender declared, and nothing here is scanned. A message this lease cannot see is 404 resource_not_found, and an install with no key to read the pool answers 503 not_configured.

المعلمات

inboxIdstringمطلوب: The tinb_ id tempMail->create returned. It is not checked against the token, which alone decides the inbox.
messageIdstringمطلوب: An id from tempMail->listMessages, such as thr_ and 24 hex.
inboxTokenstring: The oe_inbox_ token tempMail->create returned. Overrides the token given to OpenEmail::createTempMail for this call, and is required on the OpenEmail client, which would otherwise send its API key.

يُرجع

A list of arrays, each with attachmentId, filename, mimeType, size in decoded bytes, body as an empty string and headers as an empty list.

مثال

$token = getenv('OPENEMAIL_INBOX_TOKEN') ?: null; foreach ($client->tempMail->listMessages('tinb_k7m2q9xw4bdp', inboxToken: $token) as $message) {    if ($message['attachmentCount'] === 0) {        continue;    }     foreach ($client->tempMail->listAttachments('tinb_k7m2q9xw4bdp', $message['id'], inboxToken: $token) as $attachment) {        echo $attachment['filename'], ' ', $attachment['mimeType'], ' ', $attachment['size'], ' bytes', PHP_EOL;    }}

ملاحظات

Listing attachments does not mark the message seen.
Check attachmentCount from tempMail->listMessages first to skip this call for messages with none.

متاح أيضًا في

API: GET /temp-mail/inboxes/{id}/messages/{messageId}/attachments
TypeScript: tempMail.listAttachments()
Python: temp_mail.list_attachments()
Ruby: temp_mail.list_attachments
CLI: openemail temp-mail list-attachments

$client->tempMail

الدوالّ

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

المعلمات

يُرجع

مثال

ملاحظات

متاح أيضًا في

صندوق بريدك،بشروطك أنت.

صندوق بريدك،
بشروطك أنت.