Temporary disposable email API
This API purpose is to automate QA tasks of the registration process and help to independent developers to create own apps and services that require temporary email functionality.
How it works:
- Generate email address by using our domain names.
- Sign up on sites that require confirmation by mail.
- The site sends email to the address you specify.
- Message comes to our SMTP server, processed and added to the database.
- You make a request to the API with md5 hash of mail address.
- You get a list of emails.
Usage:
Request address:
https://privatix-temp-mail-v1.p.mashape.com/request/mail/id/md5/
Where md5 email address hash
Example:
To check and get a list of emails for a mailbox demo@example.com:
https://privatix-temp-mail-v1.p.mashape.com/request/mail/id/7c4ff521986b4ff8d29440beec01972d/
One message:
https://privatix-temp-mail-v1.p.mashape.com/request/one_mail/id/md5/
Where md5 unique message identifier assigned by the system.
Source message:
https://privatix-temp-mail-v1.p.mashape.com/request/source/id/md5/
Where md5 unique message identifier assigned by the system.
Message attachments:
https://privatix-temp-mail-v1.p.mashape.com/request/atchmnts/id/md5/
Where md5 unique message identifier assigned by the system.
Content response field encoded in base64 RFC 4648.
One attachment:
https://privatix-temp-mail-v1.p.mashape.com/request/one_attachment/id/md5/atId/
Where md5 unique message identifier assigned by the system. atId - attachment id in attachments list.
Content response field encoded in base64 RFC 4648.
Message attachments (legacy):
https://privatix-temp-mail-v1.p.mashape.com/request/attachments/id/md5/
Where md5 unique message identifier assigned by the system.
Delete message:
https://privatix-temp-mail-v1.p.mashape.com/request/delete/id/md5/
Where md5 unique message identifier assigned by the system.
Domains list:
To generate email addresses by using a list of domains obtained through API:
https://privatix-temp-mail-v1.p.mashape.com/request/domains/
Response parameters:
API firsly returns an HTTP header
Name | Description |
---|---|
200 | Messages received (a list of all them) |
404 | Message (attachment) not found by id! |
Response format parameters:
API supports the output format of the responses, it is enough to indicate the end of the query:
Format | Request |
---|---|
XML | /format/xml/ |
JSON | /format/json/ |
Example:
To check and get a list of emails for a mailbox demo@example.com in JSON format:
https://privatix-temp-mail-v1.p.mashape.com/request/mail/id/7c4ff521986b4ff8d29440beec01972d/format/json/
Response parameters:
Name | Description |
---|---|
mail_unique_id | Unique identifier assigned by the system. |
mail_id | Unique identifier of the message in md5 hash assigned by the system. |
mail_address_id | md5 email address hash |
mail_from | Sender |
mail_subject | Subject |
mail_preview | Preview |
mail_text_only | Message in text or html format (main) |
mail_text | Message only in text format |
mail_html | Message only in html format |
Questions and suggestions:
If you have any questions or suggestions, please contact us via the feedback form