ONEST Starter Pack
  • Introduction
    • ONEST- Focus Areas
    • Core Principles
    • Roles You Can Play
  • Join the network
  • Network Observability
    • Introduction
    • Telemetry Implementation
    • Transaction Dashboard
  • Learn
    • Beckn Protocol - Video Library
      • Chapter 1: Open Networks as a Digital Marketplace
      • Chapter 2: Beckn – An open protocol for decentralized commerce
      • Chapter 3: Beckn Ecosystem Architecture
      • Chapter 4: Specification and Support Layer
      • Chapter 5: Transaction Layer
      • Chapter 6: Implementing Beckn Protocol
      • Chapter 7: Network Topologies
      • Chapter 8: Beckn API Overview
      • Chapter 9: Example of a Retail Transaction
      • Chapter 10: Example of a Logistics Transaction
      • Chapter 11: Example of a Transaction using Interactive UI
    • Getting started on DSEP - Video Library
      • Chapter 1: Understanding Challenges in the Ecosystem
      • Chapter 2: Open Networks for Skilling and Education
      • Chapter 3: DSEP Overview
      • Chapter 4: DSEP Specification and Network Architecture
      • Chapter 5: DSEP APIs
      • Chapter 6: DSEP Schema
      • Courses and Training Transaction Workflow
      • Mentorships and Coaching Transaction Workflow
      • Scholarships and Grants Transaction Workflow
      • Internships and Jobs Transaction Workflow
    • Reference Implementation Guides
      • Financial Support (DSEP 1.0)
      • Skilling Experience (DSEP 1.0)
        • Course with scholarship
      • Work Opportunities (DSEP 2.0)
      • Suggested Form Structure for xInput
    • Understanding the APIs
    • Developing the APIs
      • Work Opportunities (DSEP 2.0)
      • Financial support, Skilling (DSEP 1.0)
    • Integration of Adaptors
      • Protocol Server
        • Introduction & Features
        • Architecture
        • Installation
        • Testing
        • Generate Keys
        • Local Tunnelling and Nginx Setup
        • FAQs
      • Job Manager
      • Profile Manager
      • AI Matching Engine
  • Community
    • Contribution Guide
    • Discussion Forum
    • Cohort calls
    • Issues Board
  • HELP
    • FAQs
Powered by GitBook
On this page
  • Steps to create a Request:
  • Note:
  • Registry Lookup API
  • Gateway URL

Was this helpful?

Edit on GitHub
  1. Learn
  2. Developing the APIs

Financial support, Skilling (DSEP 1.0)

Following are the APIs to be developed by BAP and BPP for the above two domains

BAP

BAP should consume the following on_action APIs and trigger action APIs.

  • on_search API

  • on_select API

  • on_init API

  • on_confirm

  • on_status

  • on_update

  • on_rating

  • on_support

BPP

BPP should consume the following action APIs and trigger on_action APIs.

  • search API

  • select API

  • init API

  • confirm

  • status

  • update

  • rating

  • support

Steps to create a Request:

  1. All the action and on_action APIs have context and message objects. Refer to this link to understand the list of properties in the context object. Message object varies based on the API, refer Reference Implementation Guides for examples. Below is the sample API request with context and message objects.

{
  "context": {
    "domain": "ONDC:ONEST11",
    "transaction_id": "a9aaecca-10b7-4d19-b640-b047a7c62196",
    "message_id": "$bb579fb8-cb82-4824-be12-fcbc405b6608",
    "action": "search",
    "timestamp": "2022-12-15T05:23:03.443Z",
    "version": "1.1.0",
    "bap_uri": "https://sample.bap.io/",
    "bap_id": "sample.bap.io",
    "ttl": "PT10M"
  },
  "message": {
    "intent": {
      "item": {
        "descriptor": {
          "name": "english"
        }
      }
    }
  }
}
  1. Participant should sign the payload and send to gateway. Steps to sign the request payload and verify when a payload received.

  2. Error codes implementation by BAP and BPP.

  3. Only search API goes through gateway, rest all APIs are between BAP and BPP. Example: BAP sends search API to gateway, and it will broadcast to all available providers in that domain. Next, BPP will make on_search API directly to BAP.

Note:

Protocol Server is a reference application, which helps the participants to quickly develop the protocol APIs. It will help in signing and verification of payload signature, schema validation, sending and receiving requests to Gateway and Participants.

It is not mandatory to use the protocol server; you can build your own network adaptors to connect to the ONEST network.

Sample code for implementing signature and verification.

Registry Lookup API

The registry lookup API can be used to get the details of all the participants in the registry. In request body, type can be BG,BAP, BPP

curl --location 'https://staging.registry.ondc.org/lookup' \
--header 'Content-Type: application/json' \
--data '{
    "country": "IND",
    "type":"BPP"
}'

https://staging.registry.ondc.org/lookup https://staging.registry.ondc.org/vlookup

Gateway URL

https://staging.gateway.proteantech.in/search

Last updated 6 months ago

Was this helpful?