You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
|
|
Communications
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
All the communication are done over HTTP using JSON.
|
|
|
|
|
|
|
|
|
|
Errors
|
|
|
|
|
======
|
|
|
|
|
|
|
|
|
|
In case of error a standard HTTP error is raise and you got a
|
|
|
|
|
JSON like that
|
|
|
|
|
|
|
|
|
|
.. code-block:: json
|
|
|
|
|
|
|
|
|
|
{
|
|
|
|
|
"status": 409,
|
|
|
|
|
"message": "Conflict"
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
Limitations
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
Concurrency
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
A VM can't process multiple request in the same time. But you can make
|
|
|
|
|
multiple request on multiple VM. It's transparent for the client
|
|
|
|
|
when the first request on a VM start a lock is acquire for this VM id
|
|
|
|
|
and released for the next request at the end. You can safely send all
|
|
|
|
|
the requests in the same time and let the server manage an efficent concurrency.
|
|
|
|
|
|
|
|
|
|
We think it can be a little slower for some operations, but it's remove a big
|
|
|
|
|
complexity for the client due to the fact only some command on some VM can be
|
|
|
|
|
concurrent.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Authentification
|
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
|
|
In this version of the API you have no authentification system. If you
|
|
|
|
|
listen on your network interface instead of localhost be carefull. Due
|
|
|
|
|
to the nature of the multiple supported VM it's easy for an user to
|
|
|
|
|
upload and run code on your machine.
|
|
|
|
|
|
|
|
|
|
|
