Home / Docs / Quick Start

Quick Start Guide

Send your first event to BizDone in under 5 minutes.

1. Get Your API Key

Log in to the Client Portal, navigate to Settings → API Keys, and generate a new key. Your key will look like bd_live_a1b2c3d4e5f6...

2. Install the SDK

# Python
pip install bizdone-sdk

# Node.js
npm install @bizdone/sdk

# Go
go get github.com/bizdone/sdk-go

3. Send Your First Event

Using the REST API (simplest approach):

curl -X POST https://api.bizdone.ru/v2/ingest \
  -H "Authorization: Bearer bd_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "stream": "demo-events",
    "data": {
      "sensor_id": "temp-001",
      "value": 23.5,
      "unit": "celsius",
      "timestamp": "2026-03-15T10:30:00Z"
    }
  }'

4. Subscribe to a Stream

For real-time data consumption, use the WebSocket API:

# Connect to the streaming endpoint
wscat -c "wss://api.bizdone.ru/v2/stream?api_key=YOUR_KEY&topics=demo-events"

# Or with the Python SDK
import asyncio
from bizdone import Client

async def main():
    client = Client(api_key="bd_live_YOUR_KEY")
    
    async for event in client.subscribe("demo-events"):
        print(f"[{event.timestamp}] {event.data}")

asyncio.run(main())

Next Steps