API Overview

Base URL: https://api.foodsave.kz
API versioning: v1 in path /api/v1/ — future versions will use /api/v2/.
Content-Type: application/json for request/response bodies unless otherwise noted (multipart for file uploads).

Errors

All errors follow this JSON structure:

{
  "code": "BAD_REQUEST",
  "message": "Human readable message",
  "details": { }
}

Common error codes:

HTTP	Code	Meaning
400	BAD_REQUEST	Validation or malformed payload
401	UNAUTHORIZED	Missing or invalid token
403	FORBIDDEN	Insufficient permissions
404	NOT_FOUND	Resource not found
429	RATE_LIMIT	Too many requests
500	INTERNAL_ERROR	Server error — contact support

Default: 60 requests/min per API key for admin endpoints; 300 requests/min for public read endpoints. If you need higher throughput, contact support to request a quota increase.

Where endpoints create resources (orders, campaigns), an Idempotency-Key header may be accepted to prevent duplicate creation.

Idempotency-Key: <uuid>