API — getting started
Five-minute primer so you can make your first API call.
Base URL + environments
- Production —
https://api.restora360.com(or your tenant's subdomain, depending on the endpoint) - Local dev —
http://localhost:3000
Most endpoints live under /api/.... Tenant-scoped endpoints use /api/tenant/[tenantId]/...; public endpoints (no auth) use /api/public/[tenantId]/....
Authentication
Restora 360 uses HTTP-only session cookies (platform_session) signed with HS256 JWT. There are four cookie types:
platform_session— tenants, designers, agentsadmin_session— super-admin (separate cookie to avoid collisions)customer_session— customer accounts (per-tenant)
API key auth is coming in Phase 3 (see Developer docs). For now, integration scenarios are limited to first-party server-to-server via the cookie.
Your first call
Get the menu of a tenant (public endpoint, no auth):
curl https://api.restora360.com/api/public/luigi/menuReturns JSON with categories + products. See the full API reference (coming soon) for every endpoint.
Rate limits
Public endpoints: 60 requests / minute / IP. Authenticated tenant endpoints: 600 / minute / tenant. Exceeding returns HTTP 429 with a Retry-After header. Increase via your Enterprise contract.
Errors
Standard envelope:
{ "error": "human-readable message", "code": "OPTIONAL_CODE", "detail": "optional extra context" }HTTP status codes follow REST conventions (200, 201, 400, 401, 403, 404, 409, 422, 429, 500).
Frequently asked
- Coming in Phase 3 alongside a downloadable Postman collection.
- Authenticated endpoints require the session cookie, which is HTTP-only — JS can't set it. Use these from a server. Public endpoints are CORS-enabled for browser use.