Sugar Network/API

This page describes the APi that Sugar Network clients use to interact with Sugar Network server. See also the introduction page and technical overview.

Overview

The API is RESTful and being served via HTTP(S) using JSON notation.

The common RESTful url format is:

http[s]://<SERVER>/<OBJECT>/<COMMAND>?<AUTH-TOKEN>=<VALUE>[&<ARG>=<VALUE>]..]

For the beginning, API is not secure for reasons:

• Implement initial version in short period of time;
• The only users, for the beginning, are teachers and students from one-teacher scholls.

In particular:

• API is being provided only via HTTP;
• The AUTH-TOKEN is the uid which is a hashed value from Sugar profile public SSH key (the same as JID value in Sugar Shell but without the domain part) that does not require any handshake procedures.

The OBJECT value is one of the following objects. When COMMAND and a set of ARGs depend on OBJECT. Besides, particular COMMAND can input and return data in JSON notation. If COMMAND was failed, it returns the JSON directory that contains error key with error message.