Postman is a popular API development and testing tool that simplifies working with APIs (Application Programming Interfaces). It provides a user-friendly interface to make API calls (requests) and view responses, allowing developers to test and debug their APIs without writing code. Here’s how to call Adjutor endpoints using Postman:
- On opening Postman, you can quickly make a request by clicking on the ‘New Request’ button.
- Next, you’ll land on the requests page, where you can input the endpoint you wish to query.
- On Postman, you can make a series of requests using the GET, POST, PUT, PATCH, DELETE, and other methods.
- Under the Authorization tab, you can also see the various authentication types supported by Postman.
To call the endpoints on Adjutor in Postman, follow the below steps:
Log into Adjutor at https://app.adjutor.io/login, and click on the Docs icon at the top right corner of your screen.
This leads to the landing page of the Adjutor API documentation. Click on the API Reference tab located at the top right corner page.
Locate the Run in Postman button at the top of the page
All Adjutor endpoints require a bearer token. You’ll receive this token after creating an app on the Adjutor webapp.
You can edit your existing app on adjutor to select API scopes
Select API Scopes to define permissions to access Adjutor’s API. This helps control what actions your API can do, enhancing security and privacy
For this exercise, we’ll be making a GET request to the FirstCentral Credit Bureau Adjutor endpoint. This endpoint allows us to query the FirstCentral Credit Bureau database to get a user’s credit history. The endpoint is specified at https://adjutor.lendsqr.com/v2/creditbureaus/firstcentral/:bvn. This endpoint requires the user’s BVN to be passed as a path variable.
Once all details have been filled, click on the send button to make the request. You should get a successful response.
