Usage

EmailVoid provide module for most popular programming language in https://github.com/emailvoid

But you may write your one version or debug service.

Next chapter provide more detail.

Example

Let's make simple message count request:

Attempt 1. Get messages count

# curl -v -X POST http://www.emailvoid.com/api/3.0/domain/emailvoid.com/msgs/count
* Hostname was NOT found in DNS cache
*   Trying 104.236.28.148...
* Connected to www.emailvoid.com (104.236.28.148) port 80 (#0)
> POST /api/3.0/domain/emailvoid.com/msgs/count HTTP/1.1
> User-Agent: curl/7.38.0
> Host: www.emailvoid.com
> Accept: */*
>
< HTTP/1.1 403 Forbidden
* Server nginx/1.10.3 is not blacklisted
< Server: nginx/1.10.3
< Date: Fri, 03 Nov 2017 01:14:53 GMT
< Content-Type: application/json
< Content-Length: 97
< Connection: keep-alive
<
* Connection #0 to host www.emailvoid.com left intact
{"code": 1, "description": "You should verefy your API KEY", "error": "Wrong or outdate API KEY"}

We got wrong answer without API KEY.

Attempt 2. Get messages count with API KEY

$ curl -v -X POST --header "X-Auth: b8818f4c8594021a9ca1489d135a2540d726f855767496788c6f1d76f2f5917d" http://www.emailvoid.com/api/3.0/domain/emailvoid.com/msgs/count

We specify api_key in header X-Auth and expect domain message count.

* Hostname was NOT found in DNS cache
*   Trying 104.236.28.148...
* Connected to www.emailvoid.com (104.236.28.148) port 80 (#0)
> POST /api/3.0/domain/emailvoid.com/msgs/count HTTP/1.1
> User-Agent: curl/7.38.0
> Host: www.emailvoid.com
> Accept: */*
> X-Auth: b8818f4c8594021a9ca1489d135a2540d726f855767496788c6f1d76f2f5917d
>
< HTTP/1.1 200 OK
* Server nginx/1.10.3 is not blacklisted
< Server: nginx/1.10.3
< Date: Fri, 03 Nov 2017 01:18:54 GMT
< Content-Type: application/json
< Content-Length: 23
< Connection: keep-alive
<
* Connection #0 to host www.emailvoid.com left intact
{"count": 5, "code": 0}

We have JSON response with 5 message on server.

That is very simple ;)