Lesen und Durchsuchen Ihres E-Mail-Posteingangs mit einer REST-API

Eine vollständige Dokumentation finden Sie hier

Authentifizierung

Um diese API zu verwenden und den Nachrichtendienst aufzurufen, müssen Sie sich zuerst authentifizieren und Ihr JSON-Web-Token (JWT) abrufen.

curl -X POST "https://api.ijpuk.com/api/v1/authenticate" -H "accept: application/json" -H "authorization: Basic {your base64 encoded username:password}" -d "Content-Length: 0"

Im obigen Beispiel ist {your base64 encoded 'username:password'} muss durch das Token ersetzt werden erhalten von dieser Seite

Wenn Sie diese Anfrage stellen, wird etwas Ähnliches wie das unten gezeigte zurückgegeben. Der Inhalt des zurückgegebenen Tokens wird benötigt, wenn zukünftige Anrufe an den Nachrichtendienst getätigt werden

{
   "token" : "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IlVfSUFOXzQwSUpQVUsuQ09NIiwiY2VydHRodW1icHJpbnQiOiI0cW85WjVaTW1QOC9ibm1iKzMrclFBPT0iLCJzdWIiOiJpYW5AaWpwdWsuY29tIiwianRpIjoiODVkaaa3ODQtMjZhZC00Nzk0LWE1NzItZTQzMjRjMWQ1MzUxIiwiaWF0IjoxNTM4MzMwMTI1LCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9wb3N0YWxjb2RlIjoiOTAuMjQwLjcwLjE0MCIsIm5iZiI6MTUzODMzMDEyNSwiZXhwIjoxNTM4MzMzNzI1LCJpc3MiOiJpanB1ay13ZWIuYXp1cmV3ZWJzaXRlcy5uZXQiLCJhdWQiOiJpanB1ay13ZWIuYXp1cmV3ZWJzaXRlcy5uZXQifQ.KwEq01gWlNSqVSnUM1MJp1Y9pRx6wFPR3Mx8MptC-YI"
}

So listen Sie alle Nachrichten in Ihrer E-Mail-Box auf

Dieser Aufruf gibt eine Liste aller E-Mails in Ihrem E-Mail-Posteingang zurück. Die zurückgegebenen Informationen sollen kurz sein. Eine detailliertere E-Mail-Nachricht wird zurückgegeben, siehe "So rufen Sie Ihre E-Mail-Nachricht ab".

curl -X GET "https://api.ijpuk.com/api/v1/message" -H "accept: application/json" -H "mailServerKey: {your mail server key}" -H "Authorization: bearer {your token here}"

Antwort

[
   {
       "id":"6509",
       "subject":"Life 360 - Ian has Just arrived at \"Ian Home\"",
       "dateSent":"2018-07-29T16:56:36+00:00"
   },
   {
       "id":"6514",
       "subject":"Life 360 - Ian has Just left \"Ian Home\"",
       "dateSent":"2018-07-31T16:53:11+00:00"
   }
]

So rufen Sie Ihre E-Mail-Nachricht ab

Um weitere Details einer bestimmten E-Mail abzurufen, geben Sie einfach die E-Mail-Id an.

curl -X GET "https://api.ijpuk.com/api/v1/message/{email id}" -H "accept: application/json" -H "mailServerKey: {your mail server key}" -H "Authorization: bearer {your token here}"

Antwort

{
   "isPlainText":true,
   "isHtml":true,
   "text":"Just arrived at Ian Home",
   "id":"6526",
   "subject":"Life 360 - Ian has Just arrived at \"Ian Home\"",
   "dateSent":"2018-09-01T11:40:28+00:00"
}

So löschen Sie eine E-Mail

Durch diesen Anruf wird eine bestimmte E-Mail aus Ihrem E-Mail-Konto gelöscht. Geben Sie einfach die E-Mail-Id an.

curl -X DELETE "https://api.ijpuk.com/api/v1/message/{email id}" -H "accept: application/json" -H "mailServerKey: {your mail server key}" -H "Authorization: bearer {your token here}"

Um Ihre E-Mails zu durchsuchen

Dieser API-Aufruf durchsucht die E-Mail-Benachrichtigungen in Ihrer E-Mail-Box und gibt eine Liste der Übereinstimmungen zurück.

curl -X POST "https://api.ijpuk.com/api/v1/message/search" -H "accept: application/json" -H "mailServerKey: {your mail server key}" -H "Authorization: bearer {your token here}" -H "Content-Type: application/json" -d "{ \"matchConditions\": [ { \"regEx\": \"Ian (?'status'.+) Home\", \"type\": \"setPresence\", \"parts\": [ { \"variableName\": \"IanHome\", \"regExGroupName\": \"status\", \"matchConditions\": [ \"left\", \"arrived at\", \"is at\" ] } ] }, { \"regEx\": \"^Weather Report: (?'WeatherCapture'.+) today$\", \"type\": \"setWeather\", \"parts\": [ { \"variableName\": \"Weather\", \"regExGroupName\": \"WeatherCapture\" ] } ]}"