Je e-mailinbox lezen en doorzoeken met een REST API

Volledige documentatie is hier te vinden

Afbeelding met code

Authenticatie

Om deze API te gebruiken en om de berichtenservice te bellen, moet u eerst verifiëren en uw JSON Web Token (JWT) ophalen.

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"

In het bovenstaande voorbeeld {your base64 encoded 'username:password'}, moet worden vervangen door het token verkregen van deze pagina

Als u dit verzoek indient, wordt er iets geretourneerd dat lijkt op wat hieronder wordt weergegeven. De inhoud van het geretourneerde token is vereist bij toekomstige oproepen naar de berichtendienst

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

Om alle berichten in uw e-mailbox weer te geven

Deze oproep retourneert een lijst met alle e-mails in uw e-mailinbox. De geretourneerde informatie moet beknopt zijn. Een meer gedetailleerd e-mailbericht wordt geretourneerd, zie "Om uw bericht op te halen"

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}"

Reactie

[
   {
       "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"
   }
]

Om uw e-mailbericht op te halen

Om meer details van een specifieke e-mail op te halen, specificeert u gewoon de e-mail-Id.

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}"

Reactie

{
   "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"
}

Om een e-mail te verwijderen

Deze oproep verwijdert een specifieke e-mail uit uw e-mailaccount. Geef gewoon de e-mail-Id op.

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}"

Om uw e-mails te doorzoeken

Deze API-aanroep scant door de e-mailmeldingen in uw e-mailbox en retourneert een lijst met overeenkomsten.

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\" ] } ]}"