HTTPS REST API

I personally think (and I believe IC-SC had previously 
agreed) that one of the transport mechanisms be a HTTPS REST API. I 
recommend the IC-SC begin to draft such a specification and I would 
agree to be a co-editor of that spec if desired.

I recommend the HTTPS REST API be specified using another existing standard - OpenAPI (https://www.openapis.org/).
 I believe we should use OpenAPI V2 since V3 is still being worked (but 
switch to V3 once it is available). OpenAPI specifications can written 
in JSON or YAML - I recommend we use JSON since it would be weird (but I
 guess allowed) to write a YAML spec on how to send JSON. Note code 
generation for OpenAPI specified API's exist in over 40 languages, and 
OpenAPI is used in many API specifications (Google's probably being the 
most well known - I am at a conference at the moment, literally sitting 
in talk by Google on their use of OpenAPI, which prompted me to sent 
these emails).

Duncan Sparrell

sFractal Consulting LLC

iPhone, iTypo, iApologize