API Reference · v1 · REST

API Documentation

Complete reference for every BhejDe public endpoint — request parameters, headers, response envelopes, and error codes. All HTTP, all JSON.

2Endpoints

RESTStyle

JSONFormat

BearerAuth

Browse Reference

bhejde — api-reference

endpoint

POST/api/v1/public/tokenPublic

request body

request.json

{

"clientId": "bdclient_xxxx",

"clientSecret": "••••••••"

}

response200 OK89ms

{

"status": "success",

"data": { "token": "eyJhbGci…" }

}

POST/api/v1/public/token Public

Get Access Token

Exchange your API client credentials (clientId + clientSecret) for a short-lived Bearer token. Create an API client first via Settings → Webhooks in your BhejDe account.

Request Headers

Header	Value	Required
`Content-Type`	`application/json`	Yes

Request Body Parameters

Field	Type	Req	Description
`clientId`	`string`	Yes	Your API client ID (starts with bdclient_). Create one under Settings → Webhooks.
`clientSecret`	`string`	Yes	Your API client secret, issued when the client was created. Store it securely.

Sample Request Body

request.json

{
  "clientId": "bdclient_xxxxxxxxxxxx",
  "clientSecret": "your-client-secret"
}

Sample Response

response.json

{
  "status": "success",
  "message": "Token issued successfully.",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIs...",
    "expiresIn": 3600
  },
  "isSuccess": true
}

Error Codes

400Missing or malformed request body.

401clientId or clientSecret not recognised.

429Too many token requests — rate limit exceeded.