Getting Started

Learn how to integrate the Bassode API into your application in just a few minutes.

Step 1: Create an Account

First, you need a Bassode account to generate API keys:

Visit bassode.com/account/register to create an account
Verify your email address
Sign in to your account

Step 2: Generate API Keys

Once you're signed in:

Go to Account → API Keys
Click "Create New API Key"
Give your key a descriptive name (e.g., "My Audio App")
Select the scopes you need (see Scopes documentation)
Save both your API Key and API Secret securely

Important: Your API Secret is only shown once. Store it securely - you won't be able to see it again. If you lose it, you'll need to generate a new key.

Step 3: Make Your First Request

Test your API keys with a simple request:

cURL Example

curl https://api.bassode.com/api/speakers \
  -H "X-Api-Key: bsk_live_xxxxxxxxxxxxxx" \
  -H "X-Api-Secret: your_secret_here"

C# Example

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "bsk_live_xxxxxxxxxxxxxx");
client.DefaultRequestHeaders.Add("X-Api-Secret", "your_secret_here");

var response = await client.GetAsync("https://api.bassode.com/api/speakers");
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);

JavaScript Example

fetch('https://api.bassode.com/api/speakers', {
  headers: {
    'X-Api-Key': 'bsk_live_xxxxxxxxxxxxxx',
    'X-Api-Secret': 'your_secret_here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Python Example

import requests

headers = {
    'X-Api-Key': 'bsk_live_xxxxxxxxxxxxxx',
    'X-Api-Secret': 'your_secret_here'
}

response = requests.get('https://api.bassode.com/api/speakers', headers=headers)
print(response.json())

Step 4: Handle the Response

Successful requests return JSON data:

{
  "speakers": [
    {
      "id": "1",
      "brand": "Example Brand",
      "model": "Model X1",
      "type": "Bookshelf",
      "price": 299.99
      // ... more fields
    }
    // ... more speakers
  ],
  "pagination": {
    "page": 1,
    "pageSize": 50,
    "totalCount": 150
  }
}

Step 5: Explore More Endpoints

Now that you've made your first request, explore what else you can do:

Best Practices

Never expose your API Secret - Keep it in environment variables or secure configuration
Use HTTPS only - The API only accepts secure connections
Handle errors gracefully - Check HTTP status codes and parse error messages
Respect rate limits - Implement exponential backoff for retries
Cache responses - Don't fetch the same data repeatedly when it hasn't changed

Next Steps

Learn about Authentication → Explore API Endpoints →