Getting Started

Welcome to the Rollyy Data API! This guide will help you get up and running in minutes.

What is Rollyy API?

The Rollyy Data API provides unified access to parking and EV charging infrastructure data. Whether you're building a mobility app, managing municipal parking, or integrating autonomous parking operations, our API gives you real-time access to:

• 🚗 Parking Assets - Spots, garages, and street parking
• ⚡ EV Charging Stations - Charger locations and availability
• 📍 Geospatial Search - Find assets near any location
• 🔔 Real-time Availability - Live occupancy data
• 🤖 Autonomous Operations - Robot parking job management

Quick Start

1. Get Your API Key

Contact us at api@rollyy.com to request API access. You'll receive:

• API key for authentication
• Tenant ID for multi-tenant isolation
• Access to sandbox environment

2. Make Your First Request

curl -H "X-API-Key: your-api-key" \
  https://api.rollyy.com/v1/places

3. Explore the API

Try these common operations:

Search for parking near a location:

curl -H "X-API-Key: your-api-key" \
  "https://api.rollyy.com/v1/places/search?lat=60.1699&lon=24.9384&radius=1000"

Get charging station details:

curl -H "X-API-Key: your-api-key" \
  https://api.rollyy.com/v1/charging-assets/{asset_id}

Check availability:

curl -H "X-API-Key: your-api-key" \
  "https://api.rollyy.com/v1/availability?place_id={place_id}"

Base URL

Production: https://api.rollyy.com
Sandbox: https://api-sandbox.rollyy.com

Authentication

All API requests require an API key passed in the X-API-Key header:

X-API-Key: your-api-key-here

Rate Limits

• Free tier: 1,000 requests/day
• Pro tier: 100,000 requests/day
• Enterprise: Custom limits

Rate limit headers are included in every response:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1609459200

Response Format

All responses are JSON:

{
  "data": [...],
  "meta": {
    "total": 100,
    "page": 1,
    "per_page": 20
  }
}

Error Handling

Errors follow standard HTTP status codes:

Code	Meaning
200	Success
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
404	Not Found - Resource doesn't exist
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

Error response format:

{
  "error": {
    "code": "invalid_request",
    "message": "Missing required parameter: place_id"
  }
}

Next Steps

• Authentication Guide - Detailed auth setup
• Code Examples - Sample implementations
• Webhooks - Real-time event notifications

Support

• Email: support@rollyy.com
• GitHub: github.com/rollyycom/api
• Status: status.rollyy.com