Page Comparison

Tap onto Groovs unified API using the developer tools/kit to access data directly in your application to power up new offerings/propositions for your customers

Getting started for developers

This guide is for our developer community and is an attempt to outline an initial getting started steps that the developer teams need to authenticate a connection with Groov and then explore our unified API. 

Anchor
#authenticate #authenticate

Authenticate

Groov uses Bearer authentication (also called token authentication) to allows access to its APIs. Bearer Authentication is an HTTP authentication scheme that involves security tokens called bearer tokens. The name “Bearer authentication” can be understood as “give access to the bearer of this token.” The bearer token is a cryptic string, usually generated by the server in response to a login request.

The Bearer authentication scheme was originally created as part of OAuth 2.0 in RFC 6750, but is sometimes also used on its own. Similarly to Basic authentication, Bearer authentication should only be used over HTTPS (SSL).

Get your secret key

The client must send the Bearer token in the Authorization header when making requests to Groov's protected resources:

Authorization:Bearer<token>

Your API secret keys can be viewed and copied if you have a Groov account with user role as Administrator or Developer, this has been described in detail in Integration section of this guide, refer to user secret_key.  Copy your key before moving to the next step..

Add your secret key to Swagger to Authorise your connection

a. Select Groov API from the documentation links or click here  to go to Groov's Swagger section.

b. Select Authorize.

c. Enter the secret key  (as copied in the previous step) in the Value field (as per the screenshot below) and authorize your connection. You should see an authorised message which confirms your setup has been successfully authenticated.

Try one of our end point on Swagger

a. Click Ledger Accounts - it will show the endpoints we have enabled for you to know more business informatio  about your customers who are connected to Groov via consent journey. We call your customers 'Ledger accounts' on Groov

b. Select GET /v1/ledgeraccounts to view details about the list all ledger accounts and then click on  Try it out option on Swagger.

c. click on Execute (the page field default will be 0)

d. You'll see the API response in the Responses section.

Anchor
#connect-your-account-via-code #connect-your-account-via-code

Connect your accounts via code to Sandbox partner

Whilst we are enabling the endpoint for you to call our CONNECT hosted page oAuth API using code, you can always use our Portal dashboard enabled CONNECT web product to setup multiple connections using Sandbox partner setup.Most likely you would have gone through this testing process as detailed in Set up your account - connect your accounts' section.

Anchor
#test-1st-groov-api #test-1st-groov-api

Call Groov API's

Now you are all setup, you have already authorised yourself and have tested a sample API using our Swagger documentation. 

Call our API for the first time using code

a. Create a new REST client using http://a176c8bb8ab2c4915b0f44bb7e322232-382251731.eu-west-2.elb.amazonaws.com/api/ as the base URL. (we are working on a proper subdomain setup, we will inform you once that is up and ready)

b. Add the secret_key as per above step and connect atleast one test customer using a test/dummy account id to Sandbox

c. Create a GET request for the /ledgeraccounts endpoint and execute the API request..

Retrieve data from all our available APIs

Groov has provides a rich suite of various endpoints associated to your customer connected platform and all is structured with 'ledgeraccount' object as the primary root. The endpoints that have been available till date have been explained in details in our Groov API swagger section. 

As an example if you want to query for all the payments associated to your customer (i.e a ledgeraccount on Groov), you should use the GET /v1/payments endpoint with the provisioned input parameters as explained in the documentation. 

Call Groov API's

Please browse through our catalog to see what we are working towards to over the next few days. Groov API Catalogue

Happy Grooving....