Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.foodsave.kz/llms.txt

Use this file to discover all available pages before exploring further.

Ads API

Base path: /api/v1/ads

Overview

Read endpoints are public; admin endpoints require a bearer token with advertising permissions.
Responses are cached for 5 seconds for performance. Use the If-Modified-Since header for conditional fetching.

GET /api/v1/ads/banners

Return active banners filtered by placement, locale and city.
curl --request GET \
  --url "https://api.foodsave.kz/api/v1/ads/banners?placement=home&locale=ru-KZ" \
  -H "Authorization: Bearer $FOODSAVE_API_KEY" \
  -H 'Accept: application/json'
[
  {
    "id": "123",
    "imageUrl": "https://cdn.foodsave.kz/ads/abc.jpg",
    "link": "/partner/42",
    "placement": "home",
    "startsAt": "2026-05-01T00:00:00Z",
    "endsAt": "2026-06-01T00:00:00Z"
  }
]
id
string
imageUrl
string
placement
string

Errors

CodeMeaningHow to fix
400BAD_REQUESTCheck query parameters
401UNAUTHORIZEDProvide a valid API key
429RATE_LIMITBack off or request quota increase