Steps for Go Live: Seeker Platform
Summary:
This document highlights the steps to be followed by a seeker platform for technical integration on the ONEST network in order to go live with their offerings. The first cohort within the ONEST network will go live with the discovery stage of the transaction[1]. Thus, post following the steps highlighted in the document, every seeker platform will be able to provide a view to the offerings from the provider platforms within the ONEST network on their platform. For any further steps within a transaction, the consumers will be routed to the respective provider platform.
Pre-reads:
- Understand DSEP Protocol:
Steps for technical integration:
Step 1: Identify key use cases and user stories to start with, following an MVP for go-live on the ONEST network
- Example use case: There is an organisation C that needs more number of offerings on their platform for their existing userbase or to attract more users. Such an organisation’s key usecase will be enabling the discoverability of learning and livelihood opportunities offered by provider platforms on ONEST network. Thus, they can join as a seeker platform and make all the offerings of the provider platforms discoverable on their platform.
Step 2: Understand the APIs and the structures from the specifications and examples
Step 3: List down the data points that will be sent as part of the search request
- For example: Let’s take the example of the same organisation as highlighted in step 1. If a user comes to the platform by Organisation C and searches for courses, the user may want to search by grade/ age group of students for whom the course is offered, the duration of the course, the topics covered and so on. These data points that need to be sent to the provider platforms as part of the Search request are listed. This will help the provider platforms respond with the relevant content as part of the on-search response.
Step 4: Map the data points against the search API call
Examples to help with the mapping:
- search for courses:
- search for scholarships:
Step 5: Register in the sandbox via the Network Participant form
#Link to Network Participant form to be added
Step 6: Integrate search API via Postman collection
- API call Samples and discovery protocol documentation: https://dsep.sunbird.org/discovery-protocol-specifications/discovery-protocol
- If you are facing any issues, please share your query on https://github.com/orgs/ONEST-Network/discussions
- Beckn Protocol Server is a service that helps the application connect to Beckn Network: Protocol server codebase: https://github.com/beckn/protocol-server/tree/master
Step 7: Test with reference BPPs (provider platforms) on the sandbox
- The postman collections for testing with reference apps are here: https://raw.githubusercontent.com/beckn/beckn-sandbox/main/artefacts/DSEP-PS-sandbox.postman_collection.json
- Hosted versions of the provider platform (BPP) and seeker platform (BAP) can be used to test the implementations. Link for the hosted version for a provider platform (BPP): https://sandbox-bpp-network.becknprotocol.io
Step 8: Demo the end-to-end flow
Step 9: Implement signatures and validation as per spec.
- Guide to integrating to beckn Gateway:
- sample code on generation of keys, signing and verification:
- Beckn Registry Documentation:
- Codes to be used for generating a pair of private key, public keys:
- 1.Discovery, Trust & Transact are the three stages of an end-to-end transaction ↑
Last modified 12d ago