Protocol

Authentication

1. Client aquires client certificate from certificate store
2. Client initiates secured HTTPS connection to localhost port 12984
3. Server authenticates client by client certificate. If the client certificate is not in the allowed list, server prompts user to allow or deny the client
   1. If user denies the client, the server aborts the connection
   2. If user allows the client, the client certificate is added to the allowed list and the connection is authenticated
4. Client sends requests

RESTful API

The server expects and returns data formatted with JSON.

Get

Returns entry identified by uuid

Uri: /entry/{uuid}

Method: GET

Fields:

And any other variable fields of the entry.

Update

Updates existing entry identified by uuid

Uri: /entry/{uuid}

Method: PUT

If the update is successful, you get the following return.

Delete

Deletes entry identified by uuid

Uri: /entry/{uuid}

Method: DELETE

If the delete is successful, you get the following return.

Create

Creates new entry.

Uri: /entry

Method: POST

Parameters:

If the create is successful, you get the following return.

Search

Queries for entries

Uri: /entry/search

Method: POST

Parameters:

Returns collection of matching entries