SahamatiNet
  • Background
  • SahamatiNet POC
    • Introduction
    • Applications
    • Observability
    • Integration Steps
      • Sandbox Onboarding
      • IAM APIs
      • CR APIs
      • Integration with Router
        • Sample Code Snippets
          • Python
          • Java
          • JavaScript
          • GoLang
          • C#
        • Router APIs Specifications
          • FIU API Specification
          • AA API Specification
          • FIP API Specification
      • ReBIT Workflows using Router
        • Account Discovery & Linking
        • Consent Workflow
        • FI Request Workflow
    • Integration with Simulators
      • AA Simulator
      • FIP Simulator
      • FIU Simulator
    • Validation of Integration
  • Glossary
  • Guidelines
  • Frequently Asked Questions
  • How To Guides
    • How To Onboard to Sandbox ?
    • How To Decide on an Entity ID ?
    • How To Generate a Certificate ?
    • How To Generate Tokens ?
Powered by GitBook
LogoLogo

Copyright © 2025 - Sahamati Foundation

On this page
  • Implementing Code Changes for Router Integration
  • Service URLs for the Sandbox

Was this helpful?

Export as PDF
  1. SahamatiNet POC
  2. Integration Steps

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.

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

API Collection:

PreviousCR APIsNextSample Code Snippets

Was this helpful?

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 .

​
https://api.sandbox.sahamati.org.in/router
58KB
Router API - Sandbox.postman_collection.json
FAQ section