Cafe Shop Documentation

Authenticate admin user. Returns a JWT token valid for 30 days.

Request Body

{
  "email": "admin@example.com",
  "password": "yourPassword"
}

Response

{
  "success": true,
  "code": 200,
  "message": "Login successful",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

Returns the authenticated admin's profile object.

Change admin password.

Request Body

{
  "oldPassword": "currentPassword",
  "newPassword": "newSecurePassword",
  "confirmPassword": "newSecurePassword"
}

Returns all active banners sorted by position.

Paginated list of all banners. Query params: page, limit, search.

Create a new banner. Body is multipart/form-data.

Fields: tagline, heading, shortDesc, theme (1–4), image (file)

Get a single banner by ID.

Update banner. Optionally replace the image. Body is multipart/form-data.

Delete banner and remove its image from Cloudinary.

Update display order.

{
  "sortedIds": [
    "64f1a2b3c4d5e6f7a8b9c0d1",
    "64f1a2b3c4d5e6f7a8b9c0d2",
    "64f1a2b3c4d5e6f7a8b9c0d3"
  ]
}

Toggle banner active status.

{
  "status": true
}

Paginated categories with product counts. Query: page, limit, search.

Create a category.

{
  "name": "Hot Coffee",
  "slug": "hot-coffee"
}

Update category name and/or slug.

Delete category. Also removes associated products.

Reorder categories.

{
  "sortedIds": [
    "64f1a2b3c4d5e6f7a8b9c0d1",
    "64f1a2b3c4d5e6f7a8b9c0d2"
  ]
}

Toggle category visibility.

{
  "status": false
}

Get featured products. Query: limit.

Get most-loved products. Query: limit.

Get new arrival products. Query: limit.

Paginated products. Query: page, limit, search, tag (featured | mostLoved).

Create a product. Body is multipart/form-data.

Fields: name, shortDesc, price, category (ID), status, mostLoved, featured, new, image (file)

Update product fields. Optionally replace image.

Delete product and its Cloudinary image.

Toggle product active status.

{
  "status": true
}

Paginated gallery items (active only). Query: page, limit.

Featured gallery items for homepage display. Query: limit.

All gallery items with pagination.

Upload gallery image. Body is multipart/form-data. Fields: tagline, capturedBy, image (file).

Update gallery item metadata or replace image.

Delete gallery item and its Cloudinary image.

Update gallery display order.

{
  "sortedIds": [
    "64f1a2b3c4d5e6f7a8b9c0d1",
    "64f1a2b3c4d5e6f7a8b9c0d2"
  ]
}

Toggle gallery item visibility or featured flag.

Get all active chefs sorted by position.

All chefs for admin management.

Create chef profile. Body is multipart/form-data. Fields: name, tagline, gender, dialCode, phone, image (file).

Update chef details or replace image.

Delete chef and remove image from Cloudinary.

Reorder chefs.

{
  "sortedIds": [
    "64f1a2b3c4d5e6f7a8b9c0d1",
    "64f1a2b3c4d5e6f7a8b9c0d2"
  ]
}

Get all active outlets with contact info and image URLs.

All outlets for admin management.

Create outlet. Body is multipart/form-data. Fields: name, location, googleMapLink, dialCode, phone, image (file).

Update outlet details or replace image.

Delete outlet and its Cloudinary image.

Toggle outlet active status.

{
  "status": false
}

All active categories with their products. Response is server-cached (cache key: MENU). Cache invalidates automatically on product/category changes.

Products for a specific category by its slug. Param: slug.

Submit a table reservation request. Validates outlet exists. Rejects if the same email already has a pending booking.

Request Body

{
  "outlet": "64f1a2b3c4d5e6f7a8b9c0d1",
  "reason": "Birthday Celebration",
  "name": "John Doe",
  "email": "john@example.com",
  "dialCode": "+1",
  "phone": "5551234567",
  "reservedAt": "2024-12-25T19:00:00.000Z",
  "numOfPeople": 4,
  "message": "Please arrange a cake"
}

Paginated reservations. Query: page, limit, search, status (pending | confirmed | cancelled).

Update reservation status. Accepted values: "pending", "confirmed", "cancelled".

{
  "status": "confirmed"
}

Returns full site settings (general info, business hours, metadata, etc.). Used by the frontend to render dynamic content.

Update general settings. Body is multipart/form-data — includes companyName, companyPhone, companyAddress, supportEmail, facebook, instagram, twitter, youtube, homeView, logo and favicon (files).

Update business hours for all 7 days. openTime and closeTime are minutes from midnight (e.g. 540 = 9:00 AM, 1320 = 10:00 PM).

{
  "businessHours": [
    { "dayOfWeek": 0, "openTime": 540, "closeTime": 1320, "isClosed": false },
    { "dayOfWeek": 1, "openTime": 540, "closeTime": 1320, "isClosed": false },
    { "dayOfWeek": 2, "openTime": 540, "closeTime": 1320, "isClosed": false },
    { "dayOfWeek": 3, "openTime": 540, "closeTime": 1320, "isClosed": false },
    { "dayOfWeek": 4, "openTime": 540, "closeTime": 1320, "isClosed": false },
    { "dayOfWeek": 5, "openTime": 540, "closeTime": 1320, "isClosed": false },
    { "dayOfWeek": 6, "openTime": 540, "closeTime": 1320, "isClosed": true }
  ]
}

Update page hero images. Body is multipart/form-data with files: menu, location, gallery, reserveTable.

Update Cloudinary credentials.

{
  "cloudName": "your-cloud-name",
  "apiKey": "123456789012345",
  "apiSecret": "abcdefghijklmnopqrstuvwxyz",
  "folder": "cafe-shop",
  "secureUrlBase": "https://res.cloudinary.com"
}

Update SEO metadata.

{
  "title": "Cafe Shop — Best Coffee in Town",
  "applicationName": "Cafe Shop",
  "description": "Artisan coffee and handcrafted pastries.",
  "keywords": ["cafe", "coffee", "pastries", "restaurant"],
  "openGraphImage": "https://res.cloudinary.com/your-cloud/image/upload/og.jpg"
}

Update Terms and Privacy Policy. Both fields accept HTML generated by the rich-text editor.

{
  "terms": "<h2>Terms of Service</h2><p>...</p>",
  "policy": "<h2>Privacy Policy</h2><p>...</p>"
}

Get shop/cafe highlight section data.

Get company story section including values list.

Get special offer section with linked products and deadline.

Get reservation CTA data including current business hours.

Update shop showcase. Body is multipart/form-data. Fields: heading, shortDesc, coffeeLovers, tagline, imageOne, imageTwo, imageThree (files).

Update story showcase. Body is multipart/form-data. Fields: heading, shortDesc, story, tagline, values (JSON string), 3 image files.

Update offer showcase. Body is multipart/form-data. Fields: heading, tagline, deadline (ISO date), image (file), products (comma-separated IDs).

Update reservation CTA. Body is multipart/form-data. Fields: cta, heading, tagline, darkImage, lightImage (files).

Overview statistics.

{
  "success": true,
  "data": {
    "totalProducts": 48,
    "totalCategories": 6,
    "totalOutlets": 3,
    "reservations": {
      "total": 120,
      "pending": 14,
      "confirmed": 98,
      "cancelled": 8
    }
  }
}

Returns current cache statistics (keys, hit rates, memory usage).

Flush all server-side cache. Forces fresh data on the next request.