Contact

Say Hello! 👋

API Documentation

Basics

The auth_token required to access the API is a 36 digit UUID.

All API access must be over HTTPS. POST requests must include your account name and secure auth token in the header and be posted to https://api.bramble.io/[endpoint]. The API responds with a JSON object detailing success or failure of the request. In the case of failure, a reason is returned.

Normally this will be initiated & handled via your enterprise platform, but can be tested from the command line using curl

            
              curl -X POST https://api.bramble.io/PING \
                    -H 'agency:yourAgency' \
                    -H 'auth_token:yourToken'
            
          
            
              https.request({
                  host    : "api.bramble.io",
                  path    : "/PING",
                  method  : "POST",
                  headers : {
                    "agency": yourAgency
                    "auth_token": yourToken
                  }
              },
              function(response) {
                // Do awesome stuff with Bramble data!
              })
            
          
            
              {
                "APImethod": "PING",
                "status": "success",
                "result": "apiPONG"
              }
            
          

The Bramble API is always improving. To get an up to date list of the commands accessible to your account use /getPermissions

            
              curl -X POST https://api.bramble.io/getPermissions \
                    -H 'agency:yourAgency' \
                    -H 'auth_token:yourToken'
            
          
            
              https.request({
                  host    : "api.bramble.io",
                  path    : "/getPermissions",
                  method  : "POST",
                  headers : {
                    "agency": yourAgency
                    "auth_token": yourToken
                  }
              },
              function(response) {
                // With great power comes great responsibility!
              })
            
          
            
              {
                "APImethod": "getPermissions",
                "status": "success",
                "permissions": [
                  "PING",
                  "sessionPING",
                  "getStats",
                  "toastMSG",
                  "shareURL",
                  "pollySession",
                  "createRoom"
                ]
              }
            
          

Rooms & Users

For manageable numbers you will normally invite tutors to create their own rooms using the inviteTutors page provided for your account. This gives tutors choice over their room name and exposes them to the tutorial flow. As your volume grows you may prefer to integrate this programatically into your back end. You can create rooms directly via the API endpoint /createRoom. These will sit within your subdomain, and all usage will show up for analysis in your reporting.

            
              {
                "agency": yourAgency,
                "auth_token": yourToken,
                "room": "JaneBloggs"
              }
            
          
            
              {
                "APImethod": "createRoom",
                "status": "success",
                "result": "https://yourAgency.bramble.io/JaneBloggs"
              }
            
          

Reporting [Coming Soon]

We provide a rich reporting front end for you to analyse the usage & engagement of rooms within your account. Again, to integrate this more fully into your existing service, you can query specific requests via the reporting API for data ranging from session start and end time to the number of resources and strokes in a session.

The data analysis endpoints are continually getting richer as we work with you to better understand your requirements.

/getPlaybackInformationForSessions
/getNotebookInformationForSessions
/getUserActivityForSessions
/getReports
/getRooms

            
              {
                "account": yourAccount
                "authentication": yourToken
                "fromdate": 2016-01-22
                "todate": 2016-10-15
                "filter": "Bloggs"
              }
            
          
            
              {
                "reporting" : {
                  "filter" : "Bloggs",
                  "rooms" : {
                     "JaneBloggs2863" : [
                        {
                           "Users" : [
                              {
                                 "User" : "tutor@email.com[Mac]",
                                 "Strokes" : 99,
                                 "Texts" : 91,
                                 "Resources" : 9,
                                 "SnapShot" : 0,
                                 "WebCam" : 1
                                 "Export" : 1,
                              },
                              {
                                 "User" : "student@email.com[Mac]",
                                 "Strokes" : 135,
                                 "Texts" : 18,
                                 "Resources" : 0,
                                 "SnapShot" : 0
                                 "WebCam" : 2,
                                 "Export" : 0,
                              }
                           ],
                           "start_time" : "2017-05-12 17:35:09",
                           "session_UID" : 1234,
                           "Notebooks" : [
                              {
                                 "notebook_UID" : "23rd-083b-4yy5-a2r9-2de00b39",
                                 "maxPage" : 10
                              }
                           ],
                           "end_time" : "2017-05-12 18:56:14",
                           "Duration" : 80
                        }
                    }
              }