Developer Documentation

The PizzaStack API is TomatoPy's core product. It lets you virtually acquire, prepare, cook, and assemble pizzas programmatically.

Base URL

https://api.tomatopy.pizza/v1

Pipeline

Making a pizza with the PizzaStack API follows a specific pipeline. Each step produces an object whose ID is used in the next step:

1. Acquire a tomato → returns a raw tomato object

2. Slice the tomato → returns a sliced object (required before cooking)

3. Simmer the sliced tomato into a sauce → returns a sauce object

4. Create a base → returns a pizza base object

5. Assemble the pizza from base + sauce + toppings → returns an assembled pizza object

6. Bake the assembled pizza → returns a baked pizza with quality metrics

Each step depends on the previous one. Skipping or misordering steps will not always return an error — instead, quality degrades silently. See Quality Scoring for details.

Sections

• Authentication — API key and session ID setup

• Pipeline Overview — End-to-end flow with dependency diagram

• Quality Scoring — How the quality score is computed