What are the REST APIs Used by Exalate to access ServiceNow

    Introduction

    Exalate for ServiceNow is an application server that interfaces with ServiceNow using REST API calls.  This page contains an overview of all the REST APIs used by Exalate. 

    This page has been created based on the request of the security departments of prospective Exalate users. 

    Overview



    Call
    Comment
    1
    /oauth_token.do
    The oauth_token.do is used to refresh the OAuth token for authentication purposes
    2


    /api/now/v2/table/<tablename>
    /api/now/v2/table/<tablename>/$sysId
    /api/now/v2/table/<tablename>/$issueId


    Accesses this table for:

    • checking if the Proxy User has access to the table.
    • retrieving all information related to an entity.
    • retrieving the key of an entity.
    • creating an entity.
    • adding comments.
    • adding attachments.
    • updating an entity.
    3
    /api/now/import/<stagingTableName>

    Accesses this import set for

    • checking if the proxy user has access to the import set.
    • creating an entity (through a transformation).
    • adding comments.
    • updating an entity.
    4
    /api/global/user_role_inheritance

    Checks if the Exalate console user has admin permissions on the ServiceNow environment.

    This is required to ensure that only administrators can manipulate synchronization scripts

    5
    /api/now/v2/table/sys_journal_field

    Accesses the sys_journal table for:

    • retrieving the comments associated with an Incident.
    • retrieving the id of a comment whenever Exalate creates a comment. This is necessary to uncover the id.
    6
    /api/now/v1/attachment/file
    /api/now/v1/attachment/$sysId/file



    Accesses the attachment table for

    • adding an attachment.
    • retrieving an attachment.
    7
    /api/now/v2/table/sys_attachment

    Access the sys_attachment table for

    • retrieving the metadata of an attachment (filename, size ...).
    8
    /api/now/v2/table/sys_user/$sysId
    /api/now/v2/table/sys_user


    Access the sys_user table for

    • retrieving user information associated with an Incident.