TempMailg Τεκμηρίωση API

Χρησιμοποιήστε αυτήν την τεκμηρίωση για να δημιουργήσετε το προσωπικό σας κλειδί API, να συνδεθείτε με τον αφιερωμένο host API χρήστη, να διαβάσετε μηνύματα ταχυδρομείου, να διαχειριστείτε τα mailbox που ανήκουν σε εσάς και να ενσωματώσετε το Temp Mail στις δικές σας εφαρμογές ή αυτοματοποιήσεις.

Βασική Διεύθυνση URL API Χρήστη

Μορφή αιτήματος Χρησιμοποιήστε το κλειδί API σας μόνο στο header Αυθεντικοποίησης Bearer και κρατήστε τα URL των endpoint καθαρά.

Συνδεθείτε για να Δημιουργήσετε Κλειδί API Δημιουργία Λογαριασμού

Λίστα ελέγχου γρήγορης εγκατάστασης

Ανοίξτε τη σελίδα διαχείρισης API του πίνακα ελέγχου σας και δημιουργήστε το προσωπικό σας κλειδί API.
Αντιγράψτε την ακριβή διεύθυνση URL Βάσης API Χρήστη που εμφανίζεται εκεί, για παράδειγμα https://v1.yourdomain.com/api.
Στείλτε κάθε αίτημα σε αυτόν τον host API με Authorization: Bearer YOUR_USER_API_KEY και Accept: application/json.
Παρακολουθήστε το μηνιαίο όριο αιτήσεων σας από την ίδια σελίδα του πίνακα ελέγχου και από τις κεφαλίδες του ορίου που επιστρέφονται σε κάθε απόκριση API χρήστη. μόνο οι επιτυχείς αιτήσεις 2xx μετρώνται για το όριο.

Εάν το API επιστρέψει 404 Βεβαιωθείτε ότι καλείτε τον αφιερωμένο χρήστη API host ακριβώς όπως εμφανίζεται στη σελίδα διαχείρισης API σας.

Πρόσβαση API κλειδιού

Συνδεθείτε για να δημιουργήσετε το προσωπικό σας κλειδί API και να προβάλετε ζωντανούς λεπτομέρειες ποσόστωσης.

Συνδεθείτε Εγγραφείτε

Ροή αυθεντικοποίησης

Γεννήστε το προσωπικό σας κλειδί API από τη σελίδα διαχείρισης API του πίνακα ελέγχου.
Αποστείλετε το κλειδί ως token Bearer σε κάθε αίτηση.
Χρησιμοποιήστε τον αφιερωμένο χρήστη API Base URL που εμφανίζεται στη σελίδα διαχείρισης API σας.
Αναγεννήστε το κλειδί οποιαδήποτε στιγμή που θέλετε να ακυρώσετε το παλιό και να αρχίσετε να χρησιμοποιείτε ένα νέο κλειδί αμέσως.

Ορατότητα κλειδιού Το κλειδί API χρήστη σας παραμένει ορατό μέσα στη σελίδα διαχείρισης API σας μέχρι να το αναγεννήσετε ή να το ανακαλέσετε.

Απαιτούμενες κεφαλίδες

Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json

Κεφαλίδες ορίου που επιστρέφονται σε κάθε απόκριση

Những τιμές ορίου αυξάνονται μόνο μετά από επιτυχείς απόκρισεις 2xx.

X-RateLimit-Limit: 50000
X-RateLimit-Used: 124
X-RateLimit-Remaining: 49876
X-RateLimit-Reset: 2026-05-01T00:00:00+05:00

Τερματικά API χρήστη

Κάθε τερματικό παρακάτω χρησιμοποιεί την ίδια βάση URL και το ίδιο token Bearer. Οι αιτήσεις Mailbox, μήνυμα και συνημμένο ελέγχονται έναντι του λογαριασμού του αυθεντικοποιημένου χρήστη.

GET https://v1.tempmailg.com/api/domains?type={type}

Λάβετε τις περιοχές που επιτρέπονται για το τρέχον σχέδιο και λογαριασμό χρήστη.

Επιτρεπόμενες τιμές τύπου: free, premium, all. Το σχέδιο Δωρεάν μπορεί να χρησιμοποιήσει μόνο free. Το σχέδιο Premium μπορεί να χρησιμοποιήσει free, premium, ή all.

Λάβετε τις επιτρεπόμενες περιοχές

const response = await fetch('https://v1.tempmailg.com/api/domains?type=free', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
  },
});

if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
}

response = requests.get('https://v1.tempmailg.com/api/domains?type=free', headers=headers, timeout=30)
response.raise_for_status()

print(response.json())

<?php

$ch = curl_init('https://v1.tempmailg.com/api/domains?type=free');

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_USER_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);

if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

var_dump($statusCode, json_decode($response, true));

curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Παράδειγμα απόκρισης

{
    "status": true,
    "data": {
        "requested_type": "free",
        "allowed_types": [
            "free"
        ],
        "domains": [
            {
                "domain": "example.com",
                "type": "Free",
                "custom": false
            }
        ]
    }
}

POST https://v1.tempmailg.com/api/emails

Δημιουργήστε ένα νέο τυχαίο mailbox που ανήκει στον πιστοποιημένο χρήστη.

Δημιουργήστε τυχαίο mailbox

const response = await fetch('https://v1.tempmailg.com/api/emails', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
  },
});

if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
}

response = requests.post('https://v1.tempmailg.com/api/emails', headers=headers, timeout=30)
response.raise_for_status()

print(response.json())

<?php

$ch = curl_init('https://v1.tempmailg.com/api/emails');

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_USER_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);

if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

var_dump($statusCode, json_decode($response, true));

curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Παράδειγμα απόκρισης

{
    "status": true,
    "data": {
        "id": 2301,
        "email": "randombox@example.com",
        "domain": "example.com",
        "expire_at": "2026-06-28T09:48:51+00:00",
        "expires_in_seconds": 600,
        "created_at": "2026-06-28T09:38:51+00:00",
        "email_token": "encrypted-email-token"
    }
}

POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}

Ενημερώστε ή αλλάξτε ένα υπάρχον mailbox που ανήκει στον χρήστη σε ένα νέο όνομα χρήστη και επιτρεπόμενη περιοχή.

Χρησιμοποιήστε ένα υπάρχον mailbox email στο {email}.

Ενημερώστε το mailbox που ανήκει στον χρήστη

const response = await fetch('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
  },
});

if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
}

response = requests.post('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', headers=headers, timeout=30)
response.raise_for_status()

print(response.json())

<?php

$ch = curl_init('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com');

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_USER_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);

if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

var_dump($statusCode, json_decode($response, true));

curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Παράδειγμα απόκρισης

{
    "status": true,
    "data": {
        "id": 2302,
        "email": "demo123@example.com",
        "domain": "example.com",
        "expire_at": "2026-06-28T09:48:51+00:00",
        "expires_in_seconds": 600,
        "created_at": "2026-06-28T09:38:51+00:00",
        "email_token": "encrypted-email-token"
    }
}

DELETE https://v1.tempmailg.com/api/emails/{email}

Διαγράψτε ένα mailbox που належить σε εσάς.

Διαγράψτε το mailbox που ανήκει στον χρήστη

const response = await fetch('https://v1.tempmailg.com/api/emails/demo123@example.com', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
  },
});

if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
}

response = requests.delete('https://v1.tempmailg.com/api/emails/demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()

print(response.json())

<?php

$ch = curl_init('https://v1.tempmailg.com/api/emails/demo123@example.com');

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_USER_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);

if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

var_dump($statusCode, json_decode($response, true));

curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Παράδειγμα απόκρισης

{
    "status": true,
    "message": "Email has been successfully deleted."
}

GET https://v1.tempmailg.com/api/messages?email={email}

Κατάλογος μηνυμάτων για ένα mailbox που ανήκει στον χρήστη.

Ο παράμετρος ερωτήματος email πρέπει να ανήκει στο λογαριασμό του πιστοποιημένου χρήστη.

Διαβάστε τα μηνύματα του mailbox

const response = await fetch('https://v1.tempmailg.com/api/messages?email=demo123@example.com', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
  },
});

if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
}

response = requests.get('https://v1.tempmailg.com/api/messages?email=demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()

print(response.json())

<?php

$ch = curl_init('https://v1.tempmailg.com/api/messages?email=demo123@example.com');

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_USER_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);

if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

var_dump($statusCode, json_decode($response, true));

curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages?email=demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Παράδειγμα απόκρισης

{
    "status": true,
    "mailbox": "randombox@example.com",
    "messages": [
        {
            "is_seen": false,
            "subject": "Welcome to Temp Mail",
            "from": "Example Sender",
            "from_email": "hello@example.org",
            "to": "randombox@example.com",
            "receivedAt": "2026-06-28 09:38:51",
            "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
            "html": true,
            "content": "<p>Hello from the inbox.</p>",
            "attachments": [
                {
                    "name": "file.txt",
                    "extension": "txt",
                    "size": 91,
                    "url": "https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt"
                }
            ]
        }
    ]
}

GET https://v1.tempmailg.com/api/messages/{messageId}

Διαβάστε ένα μόνο μήνυμα που ανήκει στον χρήστη.

Διαβάστε ένα μήνυμα

const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
  },
});

if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
}

response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()

print(response.json())

<?php

$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_USER_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);

if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

var_dump($statusCode, json_decode($response, true));

curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Παράδειγμα απόκρισης

{
    "status": true,
    "data": {
        "is_seen": true,
        "subject": "Welcome to Temp Mail",
        "from": "Example Sender",
        "from_email": "hello@example.org",
        "to": "randombox@example.com",
        "receivedAt": "2026-06-28 09:38:51",
        "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
        "html": true,
        "content": "<p>Hello from the inbox.</p>",
        "attachments": [
            {
                "name": "file.txt",
                "extension": "txt",
                "size": 91,
                "url": "https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt"
            }
        ]
    }
}

DELETE https://v1.tempmailg.com/api/messages/{messageId}

Διαγράψτε ένα μόνο μήνυμα που ανήκει στον χρήστη.

Διαγράψτε ένα μήνυμα

const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
  },
});

if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
}

response = requests.delete('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()

print(response.json())

<?php

$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_USER_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);

if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

var_dump($statusCode, json_decode($response, true));

curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Παράδειγμα απόκρισης

{
    "status": true,
    "message": "Message was deleted successfully."
}

GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}

Κατεβάστε μια συνημμένη αρχείο από ένα μήνυμα που ανήκει σε εσάς.

Αυτό το endpoint κατεβάζει το αρχείο απευθείας.

Κατεβάστε μια συνημμένη αρχείο

const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
  },
});

if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}

const blob = await response.blob();
const downloadUrl = window.URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = downloadUrl;
link.download = 'file.txt';
document.body.appendChild(link);
link.click();
link.remove();
window.URL.revokeObjectURL(downloadUrl);

import requests

headers = {
    'Authorization': 'Bearer YOUR_USER_API_KEY',
    'Accept': 'application/json',
}

response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', headers=headers, stream=True, timeout=30)
response.raise_for_status()

with open('file.txt', 'wb') as handle:
    for chunk in response.iter_content(chunk_size=8192):
        if chunk:
            handle.write(chunk)

<?php

$fileHandle = fopen('file.txt', 'w');
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt');

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_FILE => $fileHandle,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_USER_API_KEY',
        'Accept: application/json',
    ],
]);

if (curl_exec($ch) === false) {
    fclose($fileHandle);
    throw new RuntimeException(curl_error($ch));
}

curl_close($ch);
fclose($fileHandle);

curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY' \
  --output file.txt

Συμπεριφορά λήψης Αυτό το τερματικό επιστρέφει το αιτούμενο αρχείο απευθείας αντί για σώμα JSON.

Συχνά λάθη και αντιμετώπιση προβλημάτων

Αυτά είναι οι πιο συχνοί κωδικοί απόκρισης που μπορείτε να δείτε ενώ ενσωματώνετε το API χρήστη.

401 Άκυρο ή λείπων token Bearer.

403 Η πρόσβαση API του χρήστη είναι απενεργοποιημένη για το τρέχον σχέδιο χρήστη.

404 Ο πόρος δεν βρέθηκε στο επιτρεπόμενο host ή δεν ανήκει στον χρήστη.

410 Το mailbox έχει λήξει ή είναι ανενεργό.

422 Η επαλήθευση απέτυχε ή το ζητούμενο mailbox/τομέας δεν επιτρέπεται.

429 Η μηνιαία ποσόστωση API του χρήστη έχει υπερβεί.

Γρήγορη λίστα ελέγχου

401 - Το token Bearer λείπει, είναι λάθος, έχει ανακληθεί ή έχει αντιγραφεί λανθασμένα.
403 - Το τρέχον σχέδιο δεν έχει δικαίωμα πρόσβασης API χρήστη αυτή τη στιγμή.
404 - Το Mailbox, μήνυμα ή συνημμένο δεν ανήκει σε αυτόν τον χρήστη ή ο λάθος host χρησιμοποιείται.
410 - Το mailbox έχει λήξει ή δεν είναι πλέον ενεργό.
429 - Η μηνιαία ποσόστωση αιτημάτων έχει χρησιμοποιηθεί πλήρως για την τρέχουσα περίοδο.

Συνιστώμενο επόμενο βήμα

Εάν έχετε συνδεθεί, ανοίξτε πρώτα τη Διαχείριση API και επιβεβαιώστε την κατάσταση του κλειδιού, της ποσόστωσης, της πρόσβασης στο σχέδιο και την ακριβή Βασική Διεύθυνση API Χρήστη πριν από την αποσφαλμάτωση της εξωτερικής εφαρμογής σας.

Συνδεθείτε για να Ρυθμίσετε Κλειδί API