Getting Started

Learn how to integrate with BizKitHub APIs in just a few minutes. This guide will walk you through authentication, making your first API call, and handling responses.

1. Get Your API Key

Before you can start making API calls, you'll need to obtain an API key from your BizKitHub dashboard. Learn more about API keys →

📝 Note

Keep your API key secure and never expose it in client-side code. Always use it on your server or in secure environments.

2. Make Your First API Call

Here's how to make a simple GET request to retrieve users:

curl -X GET "https://api.bizkithub.com/v1/users" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

JavaScript Example

const response = await fetch('https://api.bizkithub.com/v1/users', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Python Example

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.bizkithub.com/v1/users', headers=headers)
data = response.json()
print(data)

3. Handle the Response

All API responses follow a consistent format:

{
  "data": [
    {
      "id": "user_123",
      "email": "john@example.com",
      "name": "John Doe",
      "created_at": "2025-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "pages": 5
  }
}

4. Error Handling

Always check for errors in your API responses:

const response = await fetch('https://api.bizkithub.com/v1/users', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

if (!response.ok) {
  const error = await response.json();
  console.error('API Error:', error.message);
  return;
}

const data = await response.json();
console.log(data);

5. Next Steps

Now that you've made your first API call, here are some recommended next steps:

🎉 Congratulations!

You've successfully made your first API call. You're now ready to start building amazing applications with BizKitHub APIs.