API Group

Path: Client Management > API Group

API Group is for creating and maintaining API groups. APIs with the same authentication type can be placed in the same group here; APIs in this group will correspond to authorizable client permissions according to the security levels originally set; when selecting the API Scope, a group is used as the unit and authorized at once. This function is usually used to authorize API clients.

Take the figure below for example. The Module list has three groups /A, /B and C, in which group C contains the four APIs C1, C2, C3 and C4. If users need to use them, all four APIs in the group will be authorized for them at once.

Create Group

1. Click Create Group to access the group creation page.

1. Fill in the data or make selections as instructed below. The fields marked with “*” are required.

• Group name*: Name of the group. Cannot be changed once created.

• Group alias: Alias to help identify the group.

• Allowed access duration (0: Unlimited)*: The duration valid for this group; it will become invalid once the time expires. Set to 0 for unlimited duration.

• Number of allowed access times (0: Unlimited)*: The maximum number of times this group of APIs can be authorized; it can no longer be used after the number of times has exceeded. Set to 0 for unlimited duration.

• Authentication type: Authentication type is required for the APIs in this group; multiple choices allowed.

• Security level*: Security levels include A~F; the security level must correspond to the security level of the client’s account.

  • Simply select the default system security for the security level.

  • If C is selected as the security level for the client, security levels A and B cannot be found here at API Group.

• Description: Description or remarks of the group.

• API Module: Enter to select the API module currently mounted on the digiRunner platform.

1. Further instructions for completing the fields.

• Authentication type: Click on the icon to access and select from the authentication list; multiple choices allowed as mentioned above.

• API Module: Click Select to enter and select the API module currently mounted on the digiRunner platform.

  • Access the selection page and search for the module to add with the search field, then click Select to the left to add it into the module list. To cancel, click Delete to the right side of the selected module; make sure to click Apply when finished selecting.

• At this time, module is added but not API. It is only added to the group name, but there is nothing inside. Click Select API to complete adding API to the module.

• After selecting the API to add, click Apply.

• If the group is created with no API added to the module, this module will not be added to the group. Take the figure below for example. APIs are added to /UserManual, and no API is added to /UserManualDgrcGet2. Upon clicking Create, only /UserManual will be saved to the group and not /UserManualDgrcGet2.

1. Click Create to save and exit.

Search Group

To search for a group, enter the keywords or the authentication type or security level here to search for related groups.

View Group

Search for the group to view details, and click on theicon to access the group details page.

Update Group

1. Search for the group to modify, and click theicon to access the update page.

1. Modify the desired fields, and click Update to save and exit.

Delete Group

1. Search for the group to delete, and click on the icon to proceed.

1. Click Delete to delete the group and exit.