Certica Products

Authorization- Item Editor

Updated Mar 24, 2021

You may also embed the item authoring tool inside of your platform to allow users to create new items and edit existing items. Users will be directed to a page that is physically hosted on the itemlogic.com domain, but it can be customized to have the look and feel of your platform to maintain consistency in the user's experience. You must be provisioned for this service, and additional fees apply.

Getting an Access Token

curl -X POST \
https://assess.itemlogic.com/oauth/token_editor?<auth_method>

POST Fields

Name Description Type

itemId
ID of item UUID 
expires Number of seconds the token will be valid. This should be a very small number (e.g. 60 seconds). integer 
session JSON array of user information for authentication. Required fields are email, firstName, and lastName and clientId. If an ItemLogic account does not exist for this user, one will be created automatically. array 
redirect URL to which user should be redirected after the editing session. string

Sample POST Data

{
    "itemId": "557b5955-5c44-4fac-a4a1-0664c0a863c9",
    "expires": 60,
    "session": {
        "email": "snow.jon@ausd.k12.edu",
        "firstName": "Jon",
        "lastName": "Snow",
        "clientId": "23"
    }
}

Sample Response

Here's a sample response for this command. You will notice that the only data returned is a URL with which the user you specified in the token request may access and edit an item. This link should be valid only for the requested user.

{
  "code":"200",
  "status":"OK",
  "body":{
    "url":"https://app.itemlogic.com/items/edit/557b5955-5c44-4fac-a4a1-0664c0a863c9\
     ?access_token=efd045fcba7621da7358d49d78c9836a80775c80f706ea559984ed9c6be4eaf22\
     424f1410a4d6df75e52b3e4f16e11c3674e2744fd70293385e19af36bc23ff3583f67ae71e8614d\
     216bd0e66bfd36b2a834009f7c6ab619bd3b7e9692d31414792855a968e997af7713758d4b155f8\
     5dfd8e0b512a5016d163a362c503e43e6beea49f612358d1141e543f738c2810dcf2c913622cc62\
     cf56759da471faf0e43fb2"
  }
}

You should configure your platform to load a new tab (ex: target="_blank") containing an href to the link provided when the user invokes either an "edit" link inside of an item listing, or a "create item" button when authoring a new item.

When the editing session is completed by the user, the user will be redirected to the URL specified in the redirect parameter when creating the access token.

Previous Article Authorization- Assessment
Next Article Understanding Relationships