Coral REST API

Webservice operations

There are several operations under development. They are accessible by sending a HTTP request to:

http://ocean-coral.no-ip.biz:14/<operation_path>

All these operations take a json object as a parameter which travels in a HTTP request body message.

---

The methods returns (in a HTTP response) a serialised object:

{ key1: value1, key2: value2 }

Or a serialised list of objects:

[ { key1: value1 }, { key2: value2 } ]

---

The whole communication begins when a client requests a handshake. It may be performed by a special operation:

handshake

Parameter's keys:

• client_key string

Returned value: object

Returned value's keys:

• coral_key string
• client_id string

---

When keys are successfully exchanged and a client ID is assigned, a client is eligible to perform other requests:

sign_in

Parameter's keys:

• username string
• password string
• client_id string

Returned value: object

Returned value's keys:

• status bool

sign_out

Parameter's keys:

• client_id string

Returned value: object

Returned value's keys:

• status bool

get_article_list

Parameter's keys:

• last_news_id string
• count int
• feed_id string
• client_id string

Returned value: list of objects

Each object's keys:

• article_id string
• author string
• title string
• time int
• description string
• image_source string

get_article_details

Parameter's keys:

• article_id string
• client_id string

Returned value: object

Returned value's keys:

• article_id string
• body string

get_feed_list

Parameter's keys:

• client_id string

Returned value: list of objects

Each object's keys:

• link string
• title string

create_feed

Parameter's keys:

• feed_tags list[string]
• client_id string

Returned value: object

Returned value's keys:

• status bool