Switch Interface

#Get Switch Names blah blah

##REST Sequence

GET https://<host>[:<port>]/api/switches HTTP/1.1
<--empty-->

HTTP/1.1 200 OK
{
  value: {
    names: [String]
  }
}

HTTP/1.1 200 OK
{
  error: {
    message: String,
    details: { <--detailed error object--> }
  }
}

#Get Switch blah blah

##REST Sequence

GET https://<host>[:<port>]/api/switch/<name> HTTP/1.1
<--empty-->

HTTP/1.1 200 OK
{
  value: {
    ...
  }
}

HTTP/1.1 200 OK
{
  error: {
    message: String,
    details: { <--detailed error object--> }
  }
}

#CREATE Switch blah blah

##REST Sequence

POST https://<host>[:<port>]/api/switch/<name> HTTP/1.1
{
  ...
}

HTTP/1.1 200 OK
{
  value: {
    ...
  }
}

HTTP/1.1 200 OK
{
  error: {
    message: String,
    details: { <--detailed error object--> }
  }
}

#Update Switch blah blah

##REST Sequence

UPDATE https://<host>[:<port>]/api/switch/<name> HTTP/1.1
{
  ...
}

HTTP/1.1 200 OK
{
  value: {
    ...
  }
}

HTTP/1.1 200 OK
{
  error: {
    message: String,
    details: { <--detailed error object--> }
  }
}