Overview

The Event service API is based on Eventstore technology which allows subscribers to get event notifications that have occurred in the Arken system. Most of these events are related to data changes such as when client data is updated or a new document is added.

The Event service gives the option to subscribers to access past events making sure no event is lost.

Client example

Example client code is provided which enforces long polling which maintains the last received event number and makes sure that no event is missed even if the client was down for some time.

Request - Get last event based on Account Hash Id only

Get event feed starting from the next event raised

GET /pre/event/info?accountHashId=xxxxxxxx HTTP/1.1
Host: api.nz.pre.arken.legal
Accept: application/json
Authorization: Bearer xxxxxx

Response - no events

The event data object in XML format

HTTP/1.1 204 No Content
Content-Type: application/json

Response - Get last event based on Account Hash Id only

The event data object in XML format

HTTP/1.1 200 OK
Date: Wed, 05 Dec 2018 03:17:06 GMT
Content-Type: application/json
Content-Length: 468

{
    "feedLink": "https://api.nz.pre.arken.legal/pre/event?accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&eventPositionFrom=88&rowsReturned=50&direction=backward",
    "lastEventNumber": 88,
    "lastEntryFeed": {
        "eventId": "d6491737-9800-409c-9764-b4ebb1f57272",
        "eventType": "FileStore.GetFileDetail",
        "eventNumber": 88,
        "eventDateTimeUtc": "2019-02-06T21:05:54.51426Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=checking pack-07-02-2019 10-05-49.zip",
        "properties": [
            {
                "Key": "Description",
                "Value": "Checking Pack"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:05:53"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-05-49"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            }
        ]
    }
}

Request - Get events with paging

Get event feed starting from the next event raised

GET /pre/event?accountHashId=qzlVU5FB7Y7NNlHr7UOzr3& direction=forward& eventPositionFrom=70& rowsReturned=100 HTTP/1.1
Host: api.nz.pre.arken.legal
Accept: application/json
Authorization: Bearer xxxxxxxx

Response - no events

The event data object in XML format

HTTP/1.1 204 No Content
Content-Type: application/json

Response - Get events with paging

The event data object in XML format

[
    {
        "eventId": "d6491737-9800-409c-9764-b4ebb1f57272",
        "eventType": "FileStore.GetFileDetail",
        "eventNumber": 88,
        "eventDateTimeUtc": "2019-02-06T21:05:54.51426Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=checking pack-07-02-2019 10-05-49.zip",
        "properties": [
            {
                "Key": "Description",
                "Value": "Checking Pack"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:05:53"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-05-49"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            }
        ]
    },
    {
        "eventId": "07fdd59e-20f6-4e8b-b202-37c4bdda1bee",
        "eventType": "FileStore.Upload",
        "eventNumber": 87,
        "eventDateTimeUtc": "2019-02-06T21:05:53.5242131Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=Checking Pack-07-02-2019 10-05-49.ZIP",
        "properties": [
            {
                "Key": "Description",
                "Value": "Checking Pack"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-05-49"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:05:53"
            }
        ]
    },
    {
        "eventId": "4f5425aa-6ab7-4014-a2d2-4e4aba5cf519",
        "eventType": "DocumentData.Update",
        "eventNumber": 86,
        "eventDateTimeUtc": "2019-02-06T21:05:53.2420973Z",
        "link": "https://api.nz.pre.arken.legal/pre/documentdata?hashId=P6Rk4XMxaKcTp9BKep9v62",
        "properties": null
    },
    {
        "eventId": "bd00ea49-3c9a-4c15-8dcc-80af7af9d3de",
        "eventType": "FileStore.GetFileDetail",
        "eventNumber": 85,
        "eventDateTimeUtc": "2019-02-06T21:05:30.6277022Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=assets and liabilities-07-02-2019 10-05-21.zip",
        "properties": [
            {
                "Key": "Description",
                "Value": "Assets and Liabilities"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:05:26"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-05-21"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            }
        ]
    },
    {
        "eventId": "48c682a7-5009-429f-9f89-9ba6b2ed60cc",
        "eventType": "FileStore.Upload",
        "eventNumber": 84,
        "eventDateTimeUtc": "2019-02-06T21:05:29.7910956Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=Assets and Liabilities-07-02-2019 10-05-21.ZIP",
        "properties": [
            {
                "Key": "Description",
                "Value": "Assets and Liabilities"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-05-21"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:05:26"
            }
        ]
    },
    {
        "eventId": "49ddb84b-559b-49e2-bb99-4abd86148dc2",
        "eventType": "DocumentData.Update",
        "eventNumber": 83,
        "eventDateTimeUtc": "2019-02-06T21:05:26.7830383Z",
        "link": "https://api.nz.pre.arken.legal/pre/documentdata?hashId=P6Rk4XMxaKcTp9BKep9v62",
        "properties": null
    },
    {
        "eventId": "9660cc9d-37ec-4667-b6a0-b280411b2af7",
        "eventType": "FileStore.GetFileDetail",
        "eventNumber": 82,
        "eventDateTimeUtc": "2019-02-06T21:04:59.2741378Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=questionnaire-07-02-2019 10-04-46.zip",
        "properties": [
            {
                "Key": "Description",
                "Value": "Questionnaire"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:04:57"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-04-46"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            }
        ]
    },
    {
        "eventId": "e649c80f-218c-4d4e-a8cb-0cd94d733d5e",
        "eventType": "FileStore.Upload",
        "eventNumber": 81,
        "eventDateTimeUtc": "2019-02-06T21:04:59.1415736Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=Questionnaire-07-02-2019 10-04-46.ZIP",
        "properties": [
            {
                "Key": "Description",
                "Value": "Questionnaire"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-04-46"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:04:57"
            }
        ]
    },
    {
        "eventId": "19f8b6ea-5666-47a0-bfb6-dd4fd952a5c6",
        "eventType": "DocumentData.Update",
        "eventNumber": 80,
        "eventDateTimeUtc": "2019-02-06T21:04:57.771915Z",
        "link": "https://api.nz.pre.arken.legal/pre/documentdata?hashId=P6Rk4XMxaKcTp9BKep9v62",
        "properties": null
    },
    {
        "eventId": "326a1d5a-0192-4272-bdaa-8b269d4e83ba",
        "eventType": "FileStore.GetFileDetail",
        "eventNumber": 79,
        "eventDateTimeUtc": "2019-02-06T21:04:10.3085383Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=draft pack-07-02-2019 10-04-05.zip",
        "properties": [
            {
                "Key": "Description",
                "Value": "Draft Pack"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:04:08"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-04-05"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            }
        ]
    },
    {
        "eventId": "c0480c61-30d7-46db-ab30-a00154a2ce9b",
        "eventType": "FileStore.Upload",
        "eventNumber": 78,
        "eventDateTimeUtc": "2019-02-06T21:04:09.1719467Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=Draft Pack-07-02-2019 10-04-05.ZIP",
        "properties": [
            {
                "Key": "Description",
                "Value": "Draft Pack"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-04-05"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:04:08"
            }
        ]
    },
    {
        "eventId": "e13e0573-d913-47c3-8400-f5196602c824",
        "eventType": "DocumentData.Update",
        "eventNumber": 77,
        "eventDateTimeUtc": "2019-02-06T21:04:08.9343217Z",
        "link": "https://api.nz.pre.arken.legal/pre/documentdata?hashId=P6Rk4XMxaKcTp9BKep9v62",
        "properties": null
    },
    {
        "eventId": "b6c96854-1809-4adf-8f78-451c2bcacb7b",
        "eventType": "FileStore.GetFileDetail",
        "eventNumber": 76,
        "eventDateTimeUtc": "2019-02-06T21:03:35.6993754Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=checking pack-07-02-2019 10-03-31.zip",
        "properties": [
            {
                "Key": "Description",
                "Value": "Checking Pack"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:03:35"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-03-31"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            }
        ]
    },
    {
        "eventId": "535b77ee-a4b3-4f70-8915-f83d6c450073",
        "eventType": "FileStore.Upload",
        "eventNumber": 75,
        "eventDateTimeUtc": "2019-02-06T21:03:35.4056392Z",
        "link": "https://api.nz.pre.arken.legal/pre/accountHashId=qzlVU5FB7Y7NNlHr7UOzr3&clientHashId=v1wLxsmtn4MmLdAAwl8Z30&key=Checking Pack-07-02-2019 10-03-31.ZIP",
        "properties": [
            {
                "Key": "Description",
                "Value": "Checking Pack"
            },
            {
                "Key": "DownloadDate",
                "Value": "07-02-2019 10-03-31"
            },
            {
                "Key": "DownloadType",
                "Value": "ZIP"
            },
            {
                "Key": "DocumentType",
                "Value": "WILL-1"
            },
            {
                "Key": "DocumentFileCreatedDate",
                "Value": "2019/02/07 10:03:35"
            }
        ]
    },
    {
        "eventId": "d1ac85de-c3b2-4890-b8c3-d6ed3c5a9623",
        "eventType": "DocumentData.Update",
        "eventNumber": 74,
        "eventDateTimeUtc": "2019-02-06T21:03:35.0028758Z",
        "link": "https://api.nz.pre.arken.legal/pre/documentdata?hashId=P6Rk4XMxaKcTp9BKep9v62",
        "properties": null
    },
    {
        "eventId": "c6ae1b87-ab92-40b2-9860-163f1e4ad8fc",
        "eventType": "DocumentData.Update",
        "eventNumber": 73,
        "eventDateTimeUtc": "2019-02-06T21:03:20.3885112Z",
        "link": "https://api.nz.pre.arken.legal/pre/documentdata?hashId=P6Rk4XMxaKcTp9BKep9v62",
        "properties": null
    },
    {
        "eventId": "093f06dd-8c30-4afa-a65b-113c2ee1381c",
        "eventType": "DocumentData.Update",
        "eventNumber": 72,
        "eventDateTimeUtc": "2019-02-06T21:03:14.987286Z",
        "link": "https://api.nz.pre.arken.legal/pre/documentdata?hashId=P6Rk4XMxaKcTp9BKep9v62",
        "properties": null
    },
    {
        "eventId": "3d997930-dd88-4145-bc3c-2cf492f9b73d",
        "eventType": "DocumentData.Update",
        "eventNumber": 71,
        "eventDateTimeUtc": "2019-02-06T21:03:14.4809286Z",
        "link": "https://api.nz.pre.arken.legal/pre/documentdata?hashId=P6Rk4XMxaKcTp9BKep9v62",
        "properties": null
    },
    {
        "eventId": "4e02b7d2-8074-4298-ba03-c268814f08a4",
        "eventType": "DocumentData.Update",
        "eventNumber": 70,
        "eventDateTimeUtc": "2019-02-06T21:03:06.3405942Z",
        "link": "https://api.nz.pre.arken.legal/pre/documentdata?hashId=P6Rk4XMxaKcTp9BKep9v62",
        "properties": null
    }
]

Fetching Event Feeds and Code Examples

Below is an example on how you could poll the Event Api using System.Threading.Timers, WebClient and CancellationToken.

Attached here is the zipped full solution for your review:

Notes for this Example Code

If you want to receive the entire event history, just delete the event.lastevent.txt file or change its contents to 0.
If you want to receive the feed from a specific point, change the the event.lastevent.txt file content to an event point and re-run the application.

In this document:

Browser not supported