Foundationv1Get started

Quickstart: your first governed request

Build a safe placeholder request and prove scope and idempotency before connecting an environment.

Last reviewed: July 16, 2026
Audience: backend · integration
Contract state: Foundation

Before you begin

Obtain an environment URL issued by FoodTech and a credential scoped to that same environment. Never move a sandbox key to staging or production, and never embed it in a client application or Git repository.

An authorized business identifier.
An authorized branch when the contract is branch-scoped.
A key or short-lived token as required by the contract.
A fresh idempotency key for every logical operation.

Request template

This is an educational template and does not certify a production path or header. Replace placeholders only from a verified API contract.

curl --request POST '<environment-base-url>/<verified-path>' \
  --header 'Authorization: Bearer <server-side-token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <uuid-v4>' \
  --data '{"business_id":"<authorized-business>","branch_id":"<authorized-branch>"}'

Verify the result

An HTTP success code alone does not prove integration success. Match the correlation_id, replay the same idempotency key, and confirm that no duplicate business effect was created.