Versions Compared

Key

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

This document provides an overview of the steps involved in integrating with the Fraud Data API.

Table of Contents
minLevel1
maxLevel7

...

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

  • Integrate with the Fraud Report 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, 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

Get Started

...

With Enabling Services

To get started with the implementation process, an authorized representative from the college or district should engage with the CCCTC Enabling Services (ES) team and schedule an initial overview meeting.

Below is a summary of the steps that will be completed during the implementation overview meeting:

  • 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 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 secure process such as PrivNote. The credentials passed include the account username and password, configured with the appropriate role(s) and college MIS Code, to ensure the user access is restricted to their college or district.

...

Integrate with the Fraud Data API

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

  1. Install and use Postman to interface with the Fraud Data API

...

To support your fraud report data submissions and queries for your college, two Postman collection files have been created containing all the JS code and environment information you need to automate your requests and workflows. Download and save these two files locally and import once your Postman install is complete. The two files are detailed in the Install & Configure Postman section below.

College Configures New Fraud Report Staging Table

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

...

  1. (optional, but recommended)

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

Install and Use Postman

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 API. The CCCTC has provided 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.

(blue star) See /wiki/spaces/GLUEPD/pages/2851438610 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

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

Recommended: Use Postman to Submit Fraud Reports via API

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.