Authentication

Overview

NisaStack uses API tokens to authenticate requests. You can create and manage your API tokens from your organization's dashboard.

Getting Your API Token

1. 1
   Sign in to your account

   Navigate to https://nisastack.com/login

2. 2
   Select your organization

   Choose the organization you want to create a token for

3. 3
   Go to API Tokens

   Click "API Tokens" in the sidebar navigation

4. 4
   Create a new token

   Click "Create New Token" and give it a descriptive name

5. 5
   Copy your token

   Copy the token immediately - you won't be able to see it again!

Using Your Token

Include your API token in the Authorization header of every request using the Bearer scheme:

curl -X POST https://api.nisastack.com/api/utilities/http-request \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "method": "GET"
  }'

const response = await fetch('https://api.nisastack.com/api/utilities/http-request', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://example.com',
    method: 'GET'
  })
});

const data = await response.json();

use Illuminate\Support\Facades\Http;

$response = Http::withToken('YOUR_API_TOKEN')
    ->post('https://api.nisastack.com/api/utilities/http-request', [
        'url' => 'https://example.com',
        'method' => 'GET'
    ]);

$data = $response->json();

Rate Limits

API requests are rate limited to prevent abuse:

If you exceed the rate limit, you'll receive a 429 Too Many Requests response. Check the Retry-After header to know when you can retry.

Security Best Practices

# .env file
NISASTACK_API_TOKEN=your_actual_token_here

// Node.js
const apiToken = process.env.NISASTACK_API_TOKEN;

fetch('https://api.nisastack.com/api/...', {
  headers: {
    'Authorization': `Bearer ${apiToken}`
  }
});

Next Steps

Now that you're authenticated, explore the available tools: