Service Guides for ResourceIQ

Investigate use cases. Find sample scenarios. Learn how your applications can best use ResourceIQ.

Create an Administrative Access Details Assignment

After you have created your administrative access details (POST /{custid}/adminaccess), you can assign your administrative access details to a system entity that is either within EBSCO-KB or external to EBSCO-KB. A system entity is an EBSCO-KB entity such as a provider, package or package-title or an external URI. The request will yield an assignment id for the assignment.

To Assign Administrative Access Details to a System Entity (example):

Gather the following information for the request:

  • The customer ID and the API Key.
  • The administrative access ID for the administrative access details that you would like to create the assignment for. This will be the object id parameter.
  • The assignment object. The assignment object defines the access, assignment details and the system entity link for the assignment.

Request

POST https://sandbox.ebsco.io/rm/rmaccounts/CUSTID/assignment/OBJECTID
Body Request Parameter

{
  "access": "allow",
  "assignmentContext": "assignmentContext",
  "assignmentType": "sample_assignment_type",
  "extensionObject": {
    "objectDescription": "Sample description",
    "objectType": "admin_access"
  },
  "link": {
    "application": {
      "name": "test application",
      "softwareVersion": "version 2.1"
    },
    "description": "test description",
    "url": "http://hostnameadminaccess.com"
  },
  "relativeUrl": "http://hostnameadminaccess.com"
}


Response

201 Created

{
  "assignmentId": "eb38b7ca-0f46-4752-ab38-bf49a1efaf36",
  "errors": [],
  "successful": true
}



For more information on the POST create administrative access assignment resource, please refer to our interactive or service reference documentation.