Integration with Router

Implementing Code Changes for Router Integration

Outlined below are the changes that members need to make to their implementation to use the SahamatiNet Router.

• Use the following Sahamati Router API endpoint as base path for all the requests.

https://api.sandbox.sahamati.org.in/router/v2

• Do note the Router API endpoint URL mentioned above is used for Sandbox, the respective URL for each environment (UAT and Production) will be updated when we progress to next environments.

• Add the recipient ID under the new header x-request-meta with recipient-id in a JSON object which is the identifier of the receiver to whom the API call needs to be forwarded.

  • The value of the x-request-meta is Base64 string of the JSON object with recipient-id.

  • This structure helps us to easily extend the JSON object by adding the required attributes for future use cases.

x-request-meta: <Base64 of JSON object 
{"recipient-id":"<entityID of the recipient>"}>

The receiver could be any of the participant, FIU, AA or FIP.

Particulars	Comments	Values
Host	The base path to use by the members of SahamatiNet Router.	​https://api.sandbox.sahamati.org.in/router
Headers	This will remain same as previous.	​ x-jws-signature - Authorization Token (from sender)
Additional Headers	The recipient id is a required property. It is the identifier of the receiver to whom the API call needs to be forwarded.	x-request-meta

These header changes need to be implemented for communication between FIU and AA, AA and FIP, FIP and AA, as well as FIU and AA.

Service URLs for the Sandbox

Service Name and their URLS

Public Key

https://api.sandbox.sahamati.org.in/auth/realms/sahamati/protocol/openid-connect/certs

IAM (Token Service)

https://api.sandbox.sahamati.org.in/iam

Central Registry (CR)

https://api.sandbox.sahamati.org.in/cr

Router

https://api.sandbox.sahamati.org.in/router

Please ensure that, in addition to the changes in the ReBIT API calls, the entity key validation for the public key is also pointing to the Sandbox for your code changes for POC. These URLs will vary across different environments. You can find the Base URLs for these in the FAQ section.

API Collection:

58KB

Router API - Sandbox.postman_collection.json

Open