Streaming Software Integration

{
  "streamKey": "live_abc123xyz789",
  "rtmpUrl": "rtmp://ingest.velora.tv:1935/live",
  "srtUrl": "srt://ingest.velora.tv:9999",
  "whipUrl": "https://ingest.velora.tv:3334/live/live_abc123xyz789/whip",
  "ingestServer": "ingest.velora.tv"
}

{
  "title": "Building an awesome project!",
  "categoryName": "Software & Game Development",
  "categorySlug": "software-and-game-development",
  "isLive": true,
  "viewerCount": 142,
  "startedAt": "2026-01-19T02:30:00.000Z"
}

{
  "success": true,
  "message": "Stream info updated"
}

{
  "categories": [
    {
      "slug": "just-chatting",
      "name": "Just Chatting",
      "imageUrl": "https://assets.velora.tv/categories/just-chatting.jpg"
    },
    {
      "slug": "software-and-game-development",
      "name": "Software & Game Development",
      "imageUrl": "https://assets.velora.tv/categories/dev.jpg"
    },
    {
      "slug": "music",
      "name": "Music",
      "imageUrl": null
    }
  ]
}

{
  "streamKey": "live_newkey456def"
}

// Velora Streaming API Client Example

const VELORA_API = 'https://api.velora.tv/api/integrations/oauth';

class VeloraStreamClient {
  constructor(accessToken) {
    this.accessToken = accessToken;
  }

  async request(endpoint, options = {}) {
    const response = await fetch(`${VELORA_API}${endpoint}`, {
      ...options,
      headers: {
        'Authorization': `Bearer ${this.accessToken}`,
        'Content-Type': 'application/json',
        ...options.headers,
      },
    });

    if (!response.ok) {
      const error = await response.json();
      throw new Error(error.message || 'API request failed');
    }

    return response.json();
  }

  // Get stream key and ingest URLs
  async getStreamSetup() {
    return this.request('/stream/setup');
  }

  // Get current stream info
  async getStreamInfo() {
    return this.request('/stream/info');
  }

  // Update stream title and category
  async updateStreamInfo({ title, categorySlug, tags }) {
    return this.request('/stream/info', {
      method: 'PUT',
      body: JSON.stringify({ title, categorySlug, tags }),
    });
  }

  // Get available categories
  async getCategories() {
    return this.request('/stream/categories');
  }

  // Regenerate stream key
  async regenerateStreamKey() {
    return this.request('/stream/key/regenerate');
  }
}

// Usage
const client = new VeloraStreamClient('your_access_token');

// Configure OBS with Velora credentials
async function configureOBS() {
  const setup = await client.getStreamSetup();

  console.log('Configure OBS with these settings:');
  console.log('Server:', setup.rtmpUrl);
  console.log('Stream Key:', setup.streamKey);

  return setup;
}

// Update stream before going live
async function prepareStream(title, category) {
  await client.updateStreamInfo({
    title,
    categorySlug: category,
  });

  console.log('Stream info updated!');
}

// Example: Set up a coding stream
configureOBS().then(setup => {
  prepareStream(
    'Building a Velora integration!',
    'software-and-game-development'
  );
});