Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
#F4F5F7
Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor
Info

This document provides an overview of the steps involved in process for integrating with the Bi-Directional Fraud Data API.

Table of Contents
minLevel1
maxLevel2

...

  • Work with the CCCTC Enabling Services team to obtain API account and credentials

  • Integrate with the Fraud Data (GraphQL) API

    • Install Postman tool and import event collections (optional, but recommended)

    • Or set up standard templates in preferred API tool (Python, cURL, Powershell, Ruby, Node, Java, etc.)

  • Install the Fraud Report staging table and deploy latest version of College Adaptor to receive a live stream of fraud notifications; or use the GraphQL Fraud Report Query to receive a list of fraud notification

...

  • CCCTC creates API account for the authorized college user, configured with the appropriate roles, MIS code, and OAuth details.

  • CCCTC provides the college with the API account credentials via secure process.

  • CCCTC provides the college with Postman collection files customized with the Bi-directional Fraud Data API schema and queries (optional).

  • CCCTC provides support for Fraud Report staging table and College Adaptor schema update.

  • CCCTC provides GraphQL API and schema documentation, integration recommendations, and supporting resources.

CCCTC Provides API Account & Credentials to College

The ES engineer will create an API account for the approved user during the implementation process and passes their credentials via a secure process (such as PrivNote). The credentials passed include the account username and password, configured with the appropriate role(s) and college MIS Code

...

(s).

Integrate with the Bi-directional Fraud Data API

Colleges and districts have options for integrating with the Bi-directional Fraud Data API, including:

  1. Install and use Postman to interface with theFraud Data API (optional, but recommended)

  2. Set up standard templates in your preferred API tool (Python, CURLcURL, Powershell, Ruby, Node, Java, etc.)

Install and Use Postman

The CCCTC recommends implementing Postman for use with the Bi-directional Fraud Data API. Instructions for downloading, installing and configuring Postman are available from your Enabling Services Implementation Configuration Engineer (ICE).

Advantages of Using Postman

Using an API client tool, such as Postman, can greatly simplify the fraud reporting and querying processes for users that may not have experience with a GraphQL an API. The CCCTC has provided and configured to the Fraud Data API schema, submitting created templates based on the API schema that will simplify submitting and querying fraud reports for your college will be greatly simplified. See the Fraud Data API Operations section below for query instructions, screenshots, and helpful tips with the three primary Fraud Report API requests.

...

.

(blue star) Please ask your Enabling Services ICE engineer for a copy of Using Postman with the Fraud Data API for installation and user instructions.

Panel
panelIconId33bfe2b7-860e-4d5a-bd01-ea85976cc352
panelIcon:Postman-Logo:
panelIconText:Postman-Logo:
bgColor#F4F5F7

Recommended: Install & Configure Postman

With Postman installed and configured to the Fraud Data API schema, submitting fraud reports for your college will be greatly simplified. See the Fraud Data API Operations section below for query instructions, screenshots, and helpful tips with the three primary Fraud Report API requests.

Configure Fraud Report Staging Table for SIS

Update College Adaptor Schema to v.4.4

...

panelIconId33bfe2b7-860e-4d5a-bd01-ea85976cc352
panelIcon:Postman-Logo:
panelIconText:Postman-Logo:
bgColor#FFFFFF

Recommended: Use Postman to Submit Fraud Reports via API

...

Integrate / Update College Adaptor & Fraud Staging Table

In our current flow of bi-directional fraud reporting, the CCCTC enables a college to submit (via the Bi-directional Fraud Data API) a fraud report and have it broadcast to other colleges (those colleges that the student also applied to). For the colleges that have the College Adaptor installed and the appropriate configuration item enabled (within CCCTC systems), the fraud report is pushed into that college’s sis staging table for fraud reports.

For colleges that don't have the College Adaptor installed (or the configuration item is set to disabled), we are unable to share the fraud report with them in this way. Instead, It is expected that the college will use the Bi-directional Fraud Data API to retrieve the fraud reports associated with their college (by misCode).

(lightbulb) By providing direct access to the Fraud Data API schema, the CCCTC has provided the districts with the ability to create and generate a custom user interface. That interface could, for example, be used to implement a more automated process for dealing with fraud application data in their district.