Back to all solutionsBooking solution

Mobile API

Mobile booking API: OpenAPI for native apps

Ranovu mobile booking API documented in docs/openapi/public-api.json covering public booking and provider ops. Bearer JWT auth, Zod schema CI gates, contract tests, and codegen. Native app rollout aligned with FEATURE_OPENAPI_NATIVE_MOBILE_PLAN.

Key features

  • OpenAPI 3.1 catalog

    Public booking endpoints: availability, services, and appointments.

  • Bearer auth

    Provider routes accept Authorization Bearer; cookies for web.

  • Zod contract CI

    docs:openapi + validate:openapi block schema drift.

  • Rate limits

    Public IP buckets; provider 300/min global Redis.

Why API for mobile?

Web /randevu works in browser; native apps want push and shell.

Same backend via documented REST.

Public endpoints

GET /api/public/availability, POST appointments, services.

Turnstile and limits apply to mobile too.

Provider endpoints

/api/provider/* for mobile dashboard parity.

Bearer token from Supabase session.

Codegen

npm run codegen:openapi emits TypeScript types.

Contract tests

139 integration tests assertOpenApiResponseData parity.

Out of scope

Webhooks and background jobs are not in OpenAPI.

See ROUTE_COVERAGE.md.

Start with API

Download public-api.json. Run codegen.

Probe public availability with test provider.

Easy setup steps

From the free plan to a live booking page-often done within about an hour.

  1. Free signup

    Create your account with no credit card and open the dashboard.

  2. Roon AI setup

    Generate profession-fit site copy and section structure.

  3. Services and availability

    Set pricing, duration, and weekly availability templates.

  4. Publish your site

    Go live on your subdomain with a working booking page.

  5. Share the booking link

    Post it on Instagram, WhatsApp, or your existing website.

  6. Approve the first booking

    Confirm from the panel and test WhatsApp confirmation and reminders.

Product documentation (help center)

Vs scraping web

HTML scrape breaks on deploy. OpenAPI stable contract.

Frequently asked questions

Official app?
Native app planned; API production-ready.
API key public?
Public routes IP rate limited; no API key.
OAuth server?
Supabase JWT; no separate OAuth2.
Webhooks mobile?
HMAC provider webhooks separate from push.
Sandbox?
Staging shares DB; test carefully.
GraphQL?
REST/OpenAPI only.
Appointment platform overview by professionHomePricing

Get started with Ranovu

Create a free account and publish your booking site in minutes.

Start freeDownload the app