Developer API¶
20 endpoint(s).
| Endpoint | Method | Summary | Auth |
|---|---|---|---|
/api/dev/v1/access-status |
GET |
Access Status | 🔒 |
/api/dev/v1/admin/access-requests |
GET |
Admin List Requests | 🔒 |
/api/dev/v1/admin/access-requests/{request_id}/approve |
POST |
Admin Approve | 🔒 |
/api/dev/v1/admin/access-requests/{request_id}/reject |
POST |
Admin Reject | 🔒 |
/api/dev/v1/admin/credits-summary |
GET |
Admin Credits Summary | 🔒 |
/api/dev/v1/credits |
GET |
Get Credits | 🔒 |
/api/dev/v1/credits/order |
POST |
Create Topup | 🔒 |
/api/dev/v1/credits/verify |
POST |
Verify Topup | 🔒 |
/api/dev/v1/keys |
GET |
List Keys | 🔒 |
/api/dev/v1/keys |
POST |
Create Key | 🔒 |
/api/dev/v1/keys/{key_id} |
DELETE |
Revoke Key | 🔒 |
/api/dev/v1/lalkitab/{rest} |
POST |
Forward Lalkitab | |
/api/dev/v1/lalkitab/{rest} |
GET |
Forward Lalkitab | |
/api/dev/v1/ping |
GET |
Ping | |
/api/dev/v1/prashna/{rest} |
POST |
Forward Prashna | |
/api/dev/v1/prashna/{rest} |
GET |
Forward Prashna | |
/api/dev/v1/pricing |
GET |
Pricing | |
/api/dev/v1/request-access |
POST |
Request Access | 🔒 |
/api/dev/v1/vedic/{rest} |
POST |
Forward Vedic | |
/api/dev/v1/vedic/{rest} |
GET |
Forward Vedic |
GET /api/dev/v1/access-status¶
Access Status
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
Example
curl -X GET 'https://api.example.com/api/dev/v1/access-status' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/dev/v1/admin/access-requests¶
Admin List Requests
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
| Param | In | Type | Required | Description |
|---|---|---|---|---|
status_filter |
query | any | no |
Response 422 — HTTPValidationError
Example
curl -X GET 'https://api.example.com/api/dev/v1/admin/access-requests' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/dev/v1/admin/access-requests/{request_id}/approve¶
Admin Approve
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
| Param | In | Type | Required | Description |
|---|---|---|---|---|
request_id |
path | integer | yes |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/dev/v1/admin/access-requests/${request_id}/approve' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/dev/v1/admin/access-requests/{request_id}/reject¶
Admin Reject
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
| Param | In | Type | Required | Description |
|---|---|---|---|---|
request_id |
path | integer | yes |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/dev/v1/admin/access-requests/${request_id}/reject' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/dev/v1/admin/credits-summary¶
Admin Credits Summary
API income: revenue, credits sold/spent/outstanding, recent purchases.
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
Example
curl -X GET 'https://api.example.com/api/dev/v1/admin/credits-summary' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/dev/v1/credits¶
Get Credits
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
Example
curl -X GET 'https://api.example.com/api/dev/v1/credits' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/dev/v1/credits/order¶
Create Topup
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
amount_inr |
integer |
yes | Rupees to top up (1 credit = ₹1). |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/dev/v1/credits/order' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/dev/v1/credits/verify¶
Verify Topup
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
razorpay_order_id |
string |
yes | |
razorpay_payment_id |
string |
yes | |
razorpay_signature |
string |
yes |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/dev/v1/credits/verify' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/dev/v1/keys¶
List Keys
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
Example
curl -X GET 'https://api.example.com/api/dev/v1/keys' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/dev/v1/keys¶
Create Key
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
name |
string |
no | A label for this key. |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/dev/v1/keys' \
-H 'Authorization: Bearer <API_KEY>'
DELETE /api/dev/v1/keys/{key_id}¶
Revoke Key
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
| Param | In | Type | Required | Description |
|---|---|---|---|---|
key_id |
path | integer | yes |
Response 422 — HTTPValidationError
Example
curl -X DELETE 'https://api.example.com/api/dev/v1/keys/${key_id}' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/dev/v1/lalkitab/{rest}¶
Forward Lalkitab
| Param | In | Type | Required | Description |
|---|---|---|---|---|
rest |
path | string | yes |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/dev/v1/lalkitab/${rest}' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/dev/v1/lalkitab/{rest}¶
Forward Lalkitab
| Param | In | Type | Required | Description |
|---|---|---|---|---|
rest |
path | string | yes |
Response 422 — HTTPValidationError
Example
curl -X GET 'https://api.example.com/api/dev/v1/lalkitab/${rest}' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/dev/v1/ping¶
Ping
Example
curl -X GET 'https://api.example.com/api/dev/v1/ping' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/dev/v1/prashna/{rest}¶
Forward Prashna
| Param | In | Type | Required | Description |
|---|---|---|---|---|
rest |
path | string | yes |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/dev/v1/prashna/${rest}' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/dev/v1/prashna/{rest}¶
Forward Prashna
| Param | In | Type | Required | Description |
|---|---|---|---|---|
rest |
path | string | yes |
Response 422 — HTTPValidationError
Example
curl -X GET 'https://api.example.com/api/dev/v1/prashna/${rest}' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/dev/v1/pricing¶
Pricing
Public price list — credits charged per tool (1 credit = ₹1).
Example
curl -X GET 'https://api.example.com/api/dev/v1/pricing' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/dev/v1/request-access¶
Request Access
🔒 Authentication required — send
Authorization: Bearer <API_KEY>
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
message |
any |
no | Optional note: what you're building. |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/dev/v1/request-access' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/dev/v1/vedic/{rest}¶
Forward Vedic
Native vedic tools (kundali, karma, dhana, matching, timing, …). Forwarded to the localhost-only internal mount with the internal secret; @require_premium is bypassed there because the gateway charges credits instead.
| Param | In | Type | Required | Description |
|---|---|---|---|---|
rest |
path | string | yes |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/dev/v1/vedic/${rest}' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/dev/v1/vedic/{rest}¶
Forward Vedic
Native vedic tools (kundali, karma, dhana, matching, timing, …). Forwarded to the localhost-only internal mount with the internal secret; @require_premium is bypassed there because the gateway charges credits instead.
| Param | In | Type | Required | Description |
|---|---|---|---|---|
rest |
path | string | yes |
Response 422 — HTTPValidationError
Example
curl -X GET 'https://api.example.com/api/dev/v1/vedic/${rest}' \
-H 'Authorization: Bearer <API_KEY>'