Generate and Manage API Access in openSIS

Generate and Manage API Access in openSIS

Overview

The API Access page allows authorized users to generate API keys for connecting openSIS data with other applications. API keys can be used to access supported openSIS data, including School, Student, and Staff information, through available API endpoints.

This section is mainly used by administrators, technical users, or integration teams who need API-based access to openSIS data.

Info
Menu > Tools > Developers > API Access

Steps to Generate a New API Key

  1. Log in to openSIS with an authorized user account.
  2. Go to the left menu.
  3. Click Tools.
  4. Under Developers, click API Access.
  5. Click Generate New API Key.
  6. In the Generate New API Key modal, enter a Title for the API key.
  7. Click Generate.
  8. The new API key appears on the API Access page.

View an API Key

  1. Go to Menu > Tools > Developers > API Access.
  2. Locate the API key record.
  3. Click the expand arrow on the right side of the API key row.
  4. The API key details will be displayed.
  5. Use the copy icon to copy the API key if needed.

Manage API Key Access

  1. Open the API Access page.
  2. Locate the API key you want to manage.
  3. Click the settings icon beside the key.
  4. The API Keys access configuration page opens.
  5. Review the available modules, such as:
    • School
    • Student
    • Staff
  6. Use the access toggle to enable or disable API access for a module or endpoint.
  7. Expand a module to view available API endpoint details.
  8. Click Update to save the access configuration.

Field and Button Explanation

Field/ButtonDescription
Generate New API KeyOpens the modal to create a new API key.
TitleA required name used to identify the API key.
GenerateCreates the API key after the title is entered.
CancelCloses the modal without creating a key.
API DocsOpens API documentation for setup and usage guidance.
Edit IconAllows the API key details, such as title, to be edited.
Delete IconDeletes the selected API key.
Settings IconOpens the access configuration page for the API key.
Expand ArrowShows or hides the API key details.
Copy IconCopies the API key.
Refresh IconRefreshes or regenerates the API key, if supported.
Access ToggleEnables or disables access for a module or endpoint.
UpdateSaves the API access configuration.

Important Notes

  • API Access should be used only by authorized users.
  • API keys can allow external applications to access openSIS data.
  • Keep API keys secure and do not share them publicly.
  • Delete unused API keys to reduce unnecessary access risk.
  • Enable only the modules or endpoints required for the integration.
  • Review API access settings carefully before clicking Update.
  • Use the API Docs link for technical implementation guidance.