Quickstart
API keys are not issued publicly. To get one, contact support@yoursouschef.com. The same address registers the webhook url we deliver to. The key is shown once; store it as a secret.
Examples call production, https://api.yoursouschef.com. The sandbox is https://api.dev.yoursouschef.com: same paths, same headers, its own keys.
1. List your stores
POST https://api.yoursouschef.com/ordering/stores/fetchStores
x-api-key: otk_…
content-type: application/json
{ "limit": 100 }
Each store carries a code. That code is what every other operation takes as storeCode.
2. Read a store's menu
POST https://api.yoursouschef.com/ordering/menus/fetchMenu
{ "storeCode": "<code>" }
Item and modifier ids in the reply are what createOrder takes.
3. Send an order
POST https://api.yoursouschef.com/ordering/orders/createOrder
{
"storeCode": "<code>",
"platformOrderId": "your-order-123",
"fulfillment": "pickup",
"items": [
{ "itemId": "<MenuItem.id>", "name": "Margherita", "quantity": 1, "unitPrice": 1250, "totalPrice": 1250 }
],
"subtotal": 1250,
"total": 1250
}
200 means we queued the order. The restaurant's decision arrives as an order.created or order.rejected webhook at your registered url (order.created is not sent yet, coming before sandbox access). See Concepts → Order intake.