I would like to remotely retrieve the status of delivery and registration of my emails I send. Is there any way to do this?
When you forward an email to eEvidence as part of, say, an ERP workflow, you are confident we will deliver it to destination within seconds. However, how do you know we really did? The JSON and RESTful web services for data interchange through HTTPS, allow you to retrieve the status of your registered emails by directly querying our databases. Simple as that.
Some key resources needed to be deployed so as to provide this feature in a reliable manner. For this reason, this feature is available for Extended plans only.
About our JSON web service solution
JSON, or JavaScript Object Notation, is an open standard format that uses human-readable text to transmit data objects consisting of key:value pairs. It is used primarily to transmit data between a server and web application, as an alternative to XML.
The eEvidence JSON query is implemented by defining five aspects:
| /srv2/jlist | Base URI for the JSON web service |
| /{private.key} | Customer query private key |
| /{geteevid.key} | Customer query get eEvid key |
| /{start.date} | Starting date for the records to be retrieved in YYYYMMDD format |
| /{end.date} | Ending date for the records to be retrieved in YYYYMMDD format |
Once implemented, the query returns the relevant data for non-delivered eEvids within the date range following the following schema:
| Key | Value |
| id: | eEvid ID |
| type: | 'OUT' = request for registering outgoing email, 'IN' = request for registering incoming email, 'FILE' = request for registering body and attachments only |
| xfield: | email ID at source (X-eEvid-SourceID shown in the email header) |
| date: | delivery date in YYYY-MM-DD hh:mm:ss format |
| subject: | email subject |
| to: | email recipient |
| af: | attachment filenames |
| rcode: | reply code at destination |
| rlog: | full reply message at destination |
| Status: | 'S' = Confirmed, 'D' = Confirmed with annotation, 'P' = Pending delivery, 'E' = Failed, 'H' = Half-done |
| tx_id: | secondary ID for retrieving the eEvid.Cert through scripting |
The most elementary query is limited to the four basic parameters and does not return records for confirmed eEvids: in 99.9% of the cases, emails are delivered within seconds, so why waste time and resources. Optional parameters allow you to retrieve all records —{full}—, regardless of their status, or check the status of a particular email —{xfield}.
For any further questions, please contact Support.