Skip to content

Rosepetal API Documentation

Welcome to the Rosepetal API documentation. This API provides endpoints for managing computer vision datasets, images, and monitoring sessions.

Overview

The Rosepetal API is built with Firebase and provides the following main functionalities:

  • Dataset Management: Read and query dataset information
  • Image Operations: Retrieve and analyze images
  • Session Monitoring: Track monitoring sessions and real-time data

Base URL

All API endpoints are relative to your Firebase project's Cloud Functions URL:

https://your-region-your-project.cloudfunctions.net/api/

Authentication

The API uses Firebase Authentication. Include your authentication token in the request headers:

Authorization: Bearer <your-firebase-token>

Quick Start

  1. Datasets - Learn how to query datasets and their metadata
  2. Images - Understand image retrieval and analysis endpoints
  3. Sessions - Monitor real-time sessions and data flows

API Structure

ResourceDescription
/dataset/Dataset information and CSV generation
/image/Image operations and analysis
/monitor/Session monitoring and control

Response Format

All API responses follow this standard format:

json
{
  "data": {
    "error": false,
    "result": "response data or success message"
  }
}

Error responses include additional error information:

json
{
  "data": {
    "error": true,
    "result": "Error description"
  }
}

Rate Limits

  • Standard endpoints: 1000 requests per minute
  • Heavy operations (CSV generation, ZIP downloads): 10 requests per minute