Technology vendors must obtain approval from the school district or choice school before they can transmit data to the WISEdata through a REST API. The Ed-Fi Credential application provides a method for districts/schools to authorize the transmission of data.
To gain access to the Ed-Fi Credential application, you first need to create a WAMS Account (follow the self-registration process for WAMS UAT or WAMS Prod). After you obtain a WAMS ID, fill out this access request form.
The Profile Page
This page displays a list of vendor users (first name, last name, email). Only a selected number of members from the technology vendor have access to the Ed-Fi Credential application to manage data submissions on the district/school’s behalf.
The Ed-Fi API is a service secured via OAuth 2. An OAuth key and secret (per district/school) are needed to make REST calls. The Ed-Fi Credential application is the source for key/secret for all districts/schools that subscribe to technology vendors. When a school/district subscribes to a technology vendor, the vendor will receive an email notification.
The Profile page also includes the Ed-Fi URL's that vendors need to speak to the ODS / API. The Authentication is the URL for retrieving a session token; the Base is the Ed-Fi ODS API URL; the Swagger is the Open API (Swagger) base URL.
The Credentials Page
The Ed-Fi Credential application generates encryption keys and secrets that are used to establish a secure connection between the technology product and DPI. These keys and secrets are sensitive information that should be kept confidential and must not be sent via email.
The Credentials page displays the API credentials (key/secret) for each district/school. Secret codes are stored in a hashed format. Vendors and schools may use the secret Reset option to enter one of their own. Column content on this page is searchable via the Search box allowing vendors to quickly search for items without filtering columns.
The LEA Monitoring Page
This page allows vendors to check up on error volumes and common errors for districts/schools. The LEA Monitoring Page may help vendors offer proactive customer support by spotting or anticipating issues in advance and extending support to resolve it.
From this page, you can:
- View API (L1) errors encountered by organizations within the past 24 hours.
- See the total L2 error counts for each education organization you work with.
- Review a detailed list of L2 errors, along with knowledge base articles to help with troubleshooting.
Using the Error Count Tables, Charts and Exports
The LEA Monitoring page is broken down into two major sections, showing API errors over the last 24 hours and total L2 errors per organization.
Within each section, you can use the Search field to filter results based on data in the columns. For example, if you only want to see data for the 2020 school year, enter 2020 in the Search field. The table then only shows rows where the School Year column includes "2020."
Filters may also be applied by using the “Filter by” drop-down boxes, which will filter the tables/charts on that section. This makes it possible to do filtering which cannot be done with the Search field. Also, information in tables can be sorted by column. If a column header has a triangle that points up or down, you can change the order of the table display based on that column.
Click the Details link in the right-most column to see a full list of the errors encountered by the education organization in that row. Within the expanded table, click the number in the L2 Error Number column to see a knowledge base article with troubleshooting information for that error.
The Export button creates a comma-separated values file containing all your errors. Upon clicking the Export button, the CSV file will automatically download and may be opened and manipulated in Microsoft Excel. As a vendor, you can filter out particular rows or columns from the export; for example, you can filter out specific LEAs or L2 Errors by using the "Sort & Filter" button in the "Home" tab, then select only the data that you want to see.
You may identify the most common L1 errors and L2 messages in the last 24 hours by clicking on the Chart button. The API error chart displays the top 10 API Keys with API errors, and the L2 messages chart ranks the top 10 L2 validation messages (errors and unacknowledged warnings only) with the highest at the left and the lowest at the right. The knowledge base articles can be viewed by clicking the validation message code at the bottom of each bar. Also, you may apply filters by using the “Filter by” drop-down boxes to present selective data on the chart.