Quickstart

Make your first Nishadil API request

Create an app, configure OAuth, subscribe to an API product, generate a subscription key, and monitor logs.

Create app

Create an app

Use the Developer Console app workspace as the project boundary.

Configure OAuth consent

Add display name, verified domain, legal URLs and redirect URIs.

Subscribe to an API product

Choose Flow, OAuth or another published API product.

Generate subscription keys

Copy secrets once and rotate with primary/secondary keys.

Test in demo mode

Use demo endpoints before live production traffic.

Monitor logs and quotas

Review request logs, latency, errors and quota limits.

API keys

Server-to-server request

curl "https://api.nishadil.com/live/v1/flow/catalog" \
  -H "Accept: application/json" \
  -H "X-Nishadil-Key: ndev_pk_your_public_key" \
  -H "X-Nishadil-Secret: ndev_sk_your_secret"

Create keys from a product subscription. Restrict them by environment, IP, origin, or referrer before production traffic.

OAuth PKCE

User-consented request

GET /live/v1/oauth/authorize
  ?response_type=code
  &client_id=YOUR_CLIENT_ID
  &redirect_uri=https://app.example/callback
  &scope=openid profile
  &code_challenge=BASE64URL_SHA256_VERIFIER
  &code_challenge_method=S256

curl "https://api.nishadil.com/live/v1/flow/catalog" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN"

Use OAuth for account-linked actions. The app still needs an active API product subscription for the API path being called.

JavaScript

Fetch with subscription keys

const response = await fetch('https://api.nishadil.com/live/v1/flow/catalog', {
  headers: {
    'Accept': 'application/json',
    'X-Nishadil-Key': 'ndev_pk_your_public_key',
    'X-Nishadil-Secret': 'ndev_sk_your_secret'
  }
});

const data = await response.json();

Use restricted keys for browser-based requests. Prefer server-to-server calls for secret-bearing traffic.

PHP

Backend request

$ch = curl_init('https://api.nishadil.com/live/v1/flow/catalog');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'X-Nishadil-Key: ndev_pk_your_public_key',
    'X-Nishadil-Secret: ndev_sk_your_secret',
  ],
]);

$body = curl_exec($ch);

Keep subscription secrets on the server and rotate primary/secondary keys without downtime.