MailinatorPro allows email access to an entire domain's worth of email via web, pop, and imap interfaces. Additionally, for upgraded accounts, it also provides JSON API access to all emails.
Access to the API (and emails) are subject to the rate-limits for your subscription plan.
The default storage system for all accounts is a circular buffer where, by default, emails are stored. The size of this buffer (aka "your entire domain's inbox") varies per account. Lifetime of emails within the buffer is dependent on how big your buffer is but also the volume of email you receive (as new emails push out old ones).
You can watch incoming email into your domain inbox via the ajax-GUI on the website.
All accounts allow web-based access to their inboxes. Note that unlike most email clients, MailinatorPro's web access page monitors all inboxes of a given domain on one screen. Filtration based on explicit or wildcarded inbox names (i.e. "bob*") can be used to limit the view.
Personal subscriptions use their account username and password to login via Pop3. For these subscriptions, all emails that arrive for the account are returned (similar to the web view).
Subscriptions with API access (i.e. those above Personal accounts) may access their domain inbox using MailinatorPro's REST API. The REST API can be accessed via GET or POST requests and all requests must include the users's API-access-token found on your account settings page.
Specific examples of using the API are presented below under each individual command.
Results are return as
JSON with http return content type of 'application/json'.
All API calls should be directed to:
You can access all email that arrives at your target domain. Unlike normal email systems where you own an "inbox", MailinatorPro allows you to own and access all inboxes simultaneously. Of course, you can also refine your access to specific inboxes which you specify.Inbox Access API call:
|access_token||/api/inbox?access_token=...||none||REQUIRED for all api calls. You can find/change your access token on your account settings page.|
|to||/api/inbox?to=bob||*||Fetch all emails addressed to the specificed repicient (i.e. "bob"). You may also specify a trailing wildcard such as "to=bo*".|
|limit||/api/inbox?limit=10||20||limit the fetch to a specified number of emails between 1 and 50. The maximum number of emails per pull is 50.|
Once you have the email id's from a given inbox query, you can retrieve the full email.Email Access API call:
|access_token||/api/email?access_token=...||none||REQUIRED for all api calls. You can find/change your access token on your account settings page.|
|to||/api/email?id=1373143878-0-test22||*||Specific email id|
|format||/api/email?format=json||none||Format must be specified as 'json' or 'raw'|