Offered APIs

The following API calls are available for the PORTAL Platform subsystem:

Changed the V1 api’s to V3 api’s as a part of API versioning of ONAP components.

PORTAL API Details

roles-approval-system-controller

PUT /auxapi/userProfile

Updates an application user to have only the specified roles.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
extSysUser body extSysUser

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/userProfile

Creates an application user with the specified roles.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
extSysUser body extSysUser

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

DELETE /auxapi/userProfile

Processes a request to delete one or more application roles for one specified user who has roles.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
extSysUser body extSysUser

Responses

200 - OK

403 - Forbidden

204 - No Content

401 - Unauthorized

ticket-event-controller

POST /auxapi/ticketevent

Accepts messages from external ticketing systems and creates notifications for Portal users.

  • Produces: [u’*/*’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
ticketEventJson body ticketEventJson

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

session-communication-controller

GET /auxapi/getSessionSlotCheckInterval

Gets session slot-check interval, a duration in milliseconds.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/extendSessionTimeOuts

Extends session timeout values for all on-boarded applications.

  • Produces: [u’*/*’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
sessionMap query sessionMap string

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

apps-controller-external-request

POST /auxapi/portalAdmin

Creates a new user as a Portal administrator.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
epUser body epUser

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

PUT /auxapi/onboardApp/{appId}

Updates information about an on-boarded application in Portal.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
appId path appId integer
oldOnboardApp body oldOnboardApp

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/onboardApp/{appId}

Gets the specified application that is on-boarded in Portal.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
appId path appId integer

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/onboardApp

Adds a new application to Portal.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
newOnboardApp body newOnboardApp

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

external-access-roles-controller

GET /auxapi/users

Gets all active Users of application

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/role/{role_id}

Gets role information for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
role_id path role_id integer

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/upload/portal/roles

Bulk upload roles for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/activeRoles

Gets active roles for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

DELETE /auxapi/deleteRole/{code}

Deletes role for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
code path code string

Responses

200 - OK

403 - Forbidden

204 - No Content

401 - Unauthorized

GET /auxapi/function/{code}

Gets role information for an application provided by function code.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
code path code string

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

DELETE /auxapi/deleteDependcyRoleRecord/{roleId}

deletes user roles for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
roleId path roleId integer

Responses

200 - OK

403 - Forbidden

204 - No Content

401 - Unauthorized

POST /auxapi/upload/portal/userRoles

Bulk upload user roles for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/roleFunction

Saves role function for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
roleFunc body roleFunc

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/functions

Gets all role functions for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/upload/portal/functions

Bulk upload functions for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/role

Saves role for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
role body role

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/upload/partner/roleFunctions

Bulk upload role functions for an partner application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
upload body upload

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/menuFunctions

Gets all functions along with global functions

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/upload/portal/roleFunctions

Bulk upload role functions for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/upload/partner/functions

Bulk upload functions for an partner application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
upload body upload

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/roles

Gets roles for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

DELETE /auxapi/roleFunction/{code}

Deletes role function for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
code path code string

Responses

200 - OK

403 - Forbidden

204 - No Content

401 - Unauthorized

GET /auxapi/user/{loginId}

Gets user role for an application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
loginId path loginId string

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/upload/partner/roles

Bulk upload roles for an partner application.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
upload body upload

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

external-apps-restful-controller

GET /auxapi/getFavorites

getFavoritesForUser

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/functionalMenuItemsForUser

getFunctionalMenuItemsForUser

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

policy-controller

POST /auxapi/get_policy

getPolicyInfo

  • Produces: [u’*/*’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
policy_request body policy_request

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

scheduler-controller

POST /auxapi/submit_vnf_change_timeslots

postSubmitVnfChangeTimeslots

  • Produces: [u’*/*’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
scheduler_request body scheduler_request

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/post_create_new_vnf_change

postCreateNewVNFChange

  • Produces: [u’*/*’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
scheduler_request body scheduler_request

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/get_time_slots/{scheduler_request}

getTimeSlots

  • Produces: [u’*/*’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
scheduler_request path scheduler_request string

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

web-analytics-ext-app-controller

POST /auxapi/storeAnalytics

Accepts data from partner applications with web analytics data.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
analyticsMap body analyticsMap

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/analytics

Gets javascript with functions that support gathering and reporting web analytics.

  • Produces: [u’application/javascript’]
  • Consumes: [u’application/json’]

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

shared-context-rest-controller

GET /auxapi/context/get_user

Gets user information for the specified context.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
context_id query context_id string

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/context/get

Gets a value for the specified context and key.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
context_id query context_id string
ckey query ckey string

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/context/clear

Clears all key-value pairs in the specified context.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
context_id query context_id string

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/context/remove

Removes the specified key in the specified context.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
context_id query context_id string
ckey query ckey string

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

GET /auxapi/context/check

Tests for presence of the specified key in the specified context.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
context_id query context_id string
ckey query ckey string

Responses

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

POST /auxapi/context/set

Sets a context value for the specified context and key. Creates the context if no context with the specified ID-key pair exists, overwrites the value if it exists already.

  • Produces: [u’application/json’]
  • Consumes: [u’application/json’]

Parameters

Name Position Description Type
userJson body userJson

Responses

201 - Created

200 - OK

404 - Not Found

403 - Forbidden

401 - Unauthorized

Additional Information

Additional information, including examples, can be found at PortalApi link.

End of Document