अस्थायी ईमेल सेवा API का उपयोग कैसे करें?
अस्थायी ईमेल और API गाइड
अस्थायी ईमेल आपकी गोपनीयता की सुरक्षा करना और स्पैम रोकना आसान बनाते हैं। हमारी सेवा आपको सरल API के माध्यम से इन्हें बनाने और प्रबंधित करने की सुविधा देती है। आप कुछ ही स्टेप्स में अस्थायी ईमेल सेट कर सकते हैं, संदेश प्राप्त कर सकते हैं और उनका कंटेंट हैंडल कर सकते हैं।
यह गाइड हर API का विवरण देता है, जिससे आप जल्दी से शुरुआत कर सकते हैं।
हमारी API क्यों इस्तेमाल करें?
गोपनीयता सुरक्षा: अपनी असली ईमेल एड्रेस को निजी रखें।
तेज़ सेटअप: एक ही लाइन कोड में ईमेल बनाएं और प्राप्त करें।
लचीलापन: साइन-अप, टेस्टिंग या वन-टाइम कोड पाने के लिए बिल्कुल सही।
API प्रमाणीकरण
हर API अनुरोध (request) के लिए सुरक्षित प्रमाणीकरण जरूरी है। अनुरोध हेडर्स में अपने API की और ऑथराइजेशन टोकन का उपयोग करें।
यहाँ बताया गया है कि इन्हें अनुरोध में कैसे शामिल करें:
1. उपलब्ध डोमेन की सूची बनाएं
Endpoint: api/domains/{apiKey}/{type}
Method: GET
Parameters:
apiKey- Your API key.type- Type of domains to fetch (free, premium, all).
Example Request:
GET api/domains/your-api-key/allExample Response:
{
"status": true,
"data": {
"domains": [
{
"domain": "free.com",
"type": "Free"
},
{
"domain": "lobage.com",
"type": "Free"
},
{
"domain": "premium.com",
"type": "Premium"
}
]
}
}Endpoint: api/emails/{apiKey}
Method: POST
Parameters:
apiKey- Your API key.
Example Request:
POST api/emails/your-api-keyExample Response:
{
"status": true,
"data": {
"email": "random@example.com",
"domain": "example.com",
"ip": "127.0.0.1",
"fingerprint": "eef780ab2ec7535e66c1405c0bff1c64",
"expire_at": "2025-01-01T00:00:00.000000Z",
"created_at": "2025-01-01T00:00:00.000000Z",
"id": 1,
"email_token": "email_token"
}
}Endpoint: api/emails/{apiKey}/{email}/{username}/{domain}
Method: POST
Parameters:
apiKey- Your API key.email- The current email address.username- The new username.domain- The new domain.
Example Request:
POST api/emails/your-api-key/old@example.com/newuser/newexample.comExample Response:
{
"status": true,
"data": {
"email": "newuser@newexample.com",
"domain": "newexample.com",
"ip": "127.0.0.1",
"fingerprint": "eef780ab2ec7535e66c1405c0bff1c64",
"expire_at": "2025-01-01T00:00:00.000000Z",
"created_at": "2025-01-01T00:00:00.000000Z",
"id": 2,
"email_token": "email_token"
}
}Endpoint: api/emails/{apiKey}/{email}
Method: POST
Parameters:
apiKey- Your API key.email- The email address to delete.
Example Request:
POST api/emails/your-api-key/old@example.comExample Response:
{
"status": true,
"message": "Email has been successfully deleted."
}Endpoint: api/messages/{apiKey}/{email}
Method: GET
Parameters:
apiKey- Your API key.email- The email address to fetch messages for.
Example Request:
GET api/messages/your-api-key/example@example.comExample Response:
{
"status": true,
"mailbox": "example@example.com",
"messages": [
{
"is_seen": true,
"subject": "Test Subject",
"from": "John Doe",
"from_email": "john@example.com",
"to": "example@example.com",
"receivedAt": "2025-01-01 00:00:38",
"id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
"html": true,
"content": "Test content",
"attachments": [
{
"name": "file.txt",
"extension": "txt",
"size": 91,
"url": "http://yoursite.com/api/d/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/file.txt"
}
]
}
]
}Endpoint: api/messages/{apiKey}/message/{messageId}
Method: GET
Parameters:
apiKey- Your API key.messageId- The ID of the message to fetch.
Example Request:
GET api/messages/your-api-key/message/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1Example Response:
{
"status": true,
"data": {
"is_seen": true,
"subject": "Test Subject",
"from": "John Doe",
"from_email": "john@example.com",
"to": "example@example.com",
"receivedAt": "2024-12-28 00:00:38",
"id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
"html": true,
"content": "Test content",
"attachments": [
{
"name": "file.txt",
"extension": "txt",
"size": 91,
"url": "http://yoursite.come/api/d/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/file.txt"
}
]
}
}Endpoint: api/messages/{apiKey}/message/{messageId}
Method: POST
Parameters:
apiKey- Your API key.messageId- The ID of the message to delete.
Example Request:
POST api/messages/your-api-key/message/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1Example Response:
{
"status": true,
"message": "Message was deleted successfully."
}Endpoint: api/d/{hash_id}/{file?}
Method: GET
Parameters:
hash_id- The hash ID of the message.file- The name of the file to download (optional).
Example Request:
GET api/d/abc123/filename.pdfExample Response:
The file will be downloaded directly.
Endpoint: /token/{email_token}
Method: GET
Description: Send your visitors to a site with a token to create the same email.
Parameters:
email_token- Your email token
Example Response:
The user will be redirected to a page where the email associated with the token is created or displayed.