# Melba API

> Restaurant management API for FoodMeUp / Melba.
> Recipes, stocks, orders, sales, production, hygiene.

## API specification

- [OpenAPI 3.1 specification (canonical)](https://api.melba.io/openapi.json)
- [LLM-tuned variant — $refs inlined, x-llm-hint per operation](https://api.melba.io/openapi.llm.json)

## Documentation

- [Interactive reference (Scalar)](https://melba.io/docs/reference)
- The whole documentation ships inside the OpenAPI document: `info.description` carries the Guides (introduction, authentication, errors, predicates, inclusions, multisite, composition, recompute, test), the Cookbook recipes, the Types catalogue and the Errors catalogue; each resource concept lives on its own `tags[].description`.

## Authentication

- Header `X-API-KEY` (per-organization key).
- OAuth 2.0 Authorization Code + PKCE (planned — see backend OAuth provider milestone).
- Token generation: `POST /users/api-key` while authenticated, or — without a paid API subscription — by burning credits (2 credits per 100 calls).

## Pricing

- API subscription Simple (€59/mo for 1 000 calls) and Pro (€109/mo + €1/1 000 overage), or 2 credits per batch of 100 calls without subscription.