Skip to main content

Getting Started with APIs - Videos

In this video series, we guide you through the initial steps of working with Fenergo APIs. Utilizing Postman as a client, we delve into the intricate details of API messages and their security aspects. This series serves as a comprehensive introduction and technical exploration of how Fenergo APIs can be leveraged to execute integrations and fulfill technical use cases.

Resources​

info

To assist in getting started and bootstrap your own Fenergo API projects, we have provided the slides used across these videos and also a Postman Project which will only require that you replace your own Client Id , Client Secret and the Base URLs for the API and Identity Endpoints where your Tenant has been deployed. You will also need your Tenant ID.

Click Here To Download the Presentation

Click Here To Download the Getting Started Postman Collection

Part 1 - Authenticating and making your first API call​

In this first video, George from Fenergo offers a detailed tutorial on making API calls using Postman. He instructs on the process of downloading Postman, establishing a workspace, and generating an access token request. McGrane further explains the procedure of making a query call and setting up variables for future API calls, emphasizing the significance of security and efficiency in accessing APIs.

  • Part 1 - Content
    • Downloading and Installing Postman.
    • Creating an Authentication Request and examining the Access Token Response.
    • Setting Up Postman to use variables that make subsequent API calls easier to use.
    • Making the first call to retrieve a Legal Entity from the Entity Data Query API endpoint.

Part 2 - Creating a Legal Entity using APIs​

Building on previous knowledge, the tutorial guides on using Postman to authenticate and generate an access token for API calls on the Fenergo SaaS platform. It focuses on the ‘create legal entity’ method, simplifying the boilerplate request for a basic API call. The tutorial concludes with viewing the created record on the Fenergo user interface.

  • Part 2 - Content
    • Look at the Create Legal Entity Swagger Document Specification - Take the boilerplate request and edit it
    • Make the API call
    • View the LE record created on the Fenergo UI

Part 3- Working with Journeys and Draft Entity Data​

The tutorial delves deeper into working with APIs on the Fenergo SaaS platform, focusing on managing records and creating workflows, or ‘journeys’. It explores the relationship between legal entity, policy, and journey, and demonstrates how to create a journey API request, update a draft record, and understand the pattern of creating and updating legal entity data.

  • Part 3 - Content
    • Understand what the pattern means in the context of managing data and process on the Fenergo SaaS Platform.
    • Understand the relationship between LE Data, Policy and Journey
    • Look at the Create Journey API Request
    • Look at the Create Draft LE Data API Request
    • Update the draft record and compare it against the original.

Part 4 - Webhooks and Events​

The tutorial explores the eventing pattern on the Fenergo SaaS platform, focusing on events and webhooks. It demonstrates how to create test webhooks, generate events, and understand the content of notifications. The tutorial also discusses the role of correlation ID for tracing events and the use of HMAC signature for securing events.

  • Part 4 - Content
    • Understand what is meant by the eventing pattern including what is an event and what is a webhook.
    • Look at creating test webhook endpoints in the UI and API.
    • Generate some events and look at the content.
    • The role of a Corelation Identifier.
    • Understand the HMAC signature and validating event messages.