META

General queries

ping

http://your.server/ramses/?ping

Use this query to test if the server is available before logging in, and/or get a new session token.

Reply content:

The server also adds a token value to the root object, specifically for this request. This token must be added to all other requests; if it’s not the same in following requests, you’re session will be ended and you’ll be logged out.

Reply body:

{
    "accepted": true,
    "query": "ping",
    "success": true,
    "message": "Server Ready!",
    "token": "2f5d2e3d4e3af1a9d459c5731247abd1ee9a7123",
    "content": {
        "version": "0.1.1-Alpha",
        "installed": true
    }
}

login

http://your.server/ramses/?login

Logs in with a username and a (hashed) password.

Query attributes:

Note

Your application / client should not send a clear password, but it should hash it first, even when using a secure/SSL connection.

Reply content:

If successful, the server replies with the user who’s logged in. Note that the content also includes the token you’ll need for further requests.

If not successful, the content is empty and the message explains the error.

Successful reply body:

{
    "accepted": true,
    "query": "login",
    "success": true,
    "message": "Server Ready!",
    "content": {
        "name": "Nicolas Dufresne",
        "shortName": "Duduf",
        "uuid": "2d7d7e01-671c-11e7-a78f-4ccc6a288527",
        "folderPath": "/home/duduf",
        "role": "admin"
    }
}

Unsuccesful reply body:

{
    "accepted":true,
    "success":false,
    "message":"Invalid username",
    "query":"login",
    "content":[]
}

init

http://your.server/ramses/?init

This special requests is used to retrieve all useful information when initializing the Ramses Client. It groups together in a single request the data which can be retrieved individually by getUsers, getTemplateSteps, getTemplateAssetGroups, getStates, getFileTypes, getApplications and getProjects. The project data contains only general project information (resolution, framerate…) but not the project content (shots, assets…). Use getProject to retrieve a specific project content.

Query attributes:

Reply content:

The server replies with all the data. Read the documentation for the corresponding individual requests for more details.

Reply body:

{
    "accepted": true,
    "query": "login",
    "success": true,
    "message": "Server Ready!",
    "content": {
        "users": [ ... ],
        "templateSteps": [ ... ],
        "templateAssetGroups": [ ... ],
        "states": [ ... ],
        "fileTypes": [ ... ],
        "applications": [ ... ],
        "projects": [ ... ]
    }
}