Services API

Overview

The Services API allows you to manage service listings, bookings, availability schedules, categories, and media. All Services API endpoints require admin authentication.

Service Listings

List Services

From /src/pages/api/admin/services/services.ts:20-112:

curl "https://your-domain.com/api/admin/services/services?status=active&page=1" \
  -H "Authorization: Bearer <token>"

{
  "services": [
    {
      "id": "svc_123",
      "slug": "web-development",
      "categoryId": "cat_001",
      "status": "active",
      "basePrice": "150.00",
      "priceType": "hourly",
      "currency": "EUR",
      "durationMinutes": 60,
      "isMobile": false,
      "isFeatured": true,
      "displayInHome": true,
      "translations": [
        {
          "inLanguage": "fr",
          "title": "Développement Web"
        }
      ],
      "category": {
        "id": "cat_001",
        "name": { "fr": "Développement" },
        "slug": "development"
      }
    }
  ],
  "total": 45,
  "page": 1,
  "perPage": 20,
  "totalPages": 3
}

Query Parameters

integer

default:"1"

Page number

integer

default:"20"

Items per page (max: 100)

string

Search by slug

string

Filter by status: draft, active, suspended, archived

boolean

Filter featured services

boolean

Filter services displayed on homepage

string

Filter by category ID

string

Filter by organization ID

string

Fetch single service with full details (translations, media)

Create Service

From /src/pages/api/admin/services/services.ts:136-206:

curl -X POST "https://your-domain.com/api/admin/services/services" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d @service.json

{
  "action": "create",
  "slug": "web-development",
  "categoryId": "cat_001",
  "providerId": "usr_123",
  "organizationId": "org_456",
  "status": "draft",
  "basePrice": "150.00",
  "priceType": "hourly",
  "currency": "EUR",
  "durationMinutes": 60,
  "isMobile": false,
  "maxParticipants": 1,
  "bookingAdvanceHours": 24,
  "cancellationHours": 12,
  "isFeatured": false,
  "displayInHome": true,
  "allowReviews": true,
  "inLanguage": "fr",
  "translations": [
    {
      "inLanguage": "fr",
      "title": "Développement Web",
      "description": "Services de développement web professionnel",
      "shortDescription": "Dev web",
      "seoTitle": "Développement Web Pro",
      "seoDescription": "Services de dev web"
    }
  ],
  "media": [
    {
      "mediaId": "media_789",
      "type": "cover",
      "position": 0
    }
  ]
}

{
  "id": "svc_999",
  "slug": "web-development"
}

Request Body

string

required

Must be "create"

string

required

URL-friendly service slug

string

Category ID (nullable)

string

required

User ID of service provider

string

Organization ID (nullable)

string

default:"draft"

Service status: draft, active, suspended, archived

string

Service price (decimal string, e.g., “150.00”)

string

Pricing model: hourly, fixed, per_session, custom

string

default:"EUR"

ISO currency code (EUR, USD, etc.)

number

Service duration in minutes

boolean

default:"false"

Service available at customer location

number

Maximum participants per booking

number

Minimum hours required before booking

number

Hours before booking when cancellation is allowed

boolean

default:"false"

Mark as featured

boolean

default:"false"

Show on homepage

boolean

default:"true"

Enable customer reviews

array

Array of translation objects with inLanguage, title, description, etc.

array

Array of media objects with mediaId, type (cover/gallery), position

Update Service

From /src/pages/api/admin/services/services.ts:208-286:

{
  "action": "update",
  "id": "svc_999",
  "slug": "professional-web-dev",
  "status": "active",
  "basePrice": "175.00",
  "isFeatured": true,
  "translations": [...],
  "media": [...]
}

Updates replace translations and media (full replacement strategy).

Other Service Actions

From /src/pages/api/admin/services/services.ts:288-371:

{
  "action": "delete",
  "id": "svc_999"
}

{
  "action": "activate",
  "id": "svc_999"
}

{
  "action": "deactivate",
  "id": "svc_999"
}

{
  "action": "duplicate",
  "id": "svc_999"
}

Duplicating creates a copy with status: "draft" and unique slug.

Service Categories

From /src/pages/api/admin/services/categories.ts:19-99:

GET /api/admin/services/categories?all=true

Query Parameters

string

Fetch single category by ID (includes service count)

boolean

Return all categories for selectors

string

Filter by parent ID (use "root" for top-level)

boolean

Filter featured categories

boolean

Filter categories displayed on homepage

Filter categories shown in menu

Create Category

From /src/pages/api/admin/services/categories.ts:124-155:

{
  "action": "create",
  "slug": "development",
  "name": { "fr": "Développement", "en": "Development" },
  "description": { "fr": "Services de développement" },
  "icon": "code",
  "parentId": null,
  "sortOrder": 0,
  "displayInHome": true,
  "displayInMenu": true,
  "isActive": true,
  "isFeatured": false
}

Update/Delete Category

From /src/pages/api/admin/services/categories.ts:157-216:

{
  "action": "update",
  "id": "cat_001",
  "name": { "fr": "Nouveau nom" },
  "sortOrder": 10
}

{
  "action": "delete",
  "id": "cat_001"
}

Deleting a category unlinks all services (sets categoryId to null).

Availability

List Availability Slots

From /src/pages/api/admin/services/availability.ts:13-30:

GET /api/admin/services/availability?serviceId=svc_123

Response

{
  "slots": [
    {
      "id": "slot_001",
      "serviceId": "svc_123",
      "dayOfWeek": 1,
      "startTime": "09:00",
      "endTime": "17:00",
      "isAvailable": true
    },
    {
      "dayOfWeek": 2,
      "startTime": "09:00",
      "endTime": "17:00",
      "isAvailable": true
    }
  ]
}

Day of Week: 0 = Sunday, 1 = Monday, …, 6 = Saturday

Manage Availability

From /src/pages/api/admin/services/availability.ts:36-127:

{
  "action": "create",
  "serviceId": "svc_123",
  "dayOfWeek": 1,
  "startTime": "09:00",
  "endTime": "17:00",
  "isAvailable": true
}

{
  "action": "update",
  "id": "slot_001",
  "startTime": "10:00",
  "endTime": "18:00"
}

{
  "action": "delete",
  "id": "slot_001"
}

{
  "action": "bulkSet",
  "serviceId": "svc_123",
  "slots": [
    { "dayOfWeek": 1, "startTime": "09:00", "endTime": "17:00" },
    { "dayOfWeek": 2, "startTime": "09:00", "endTime": "17:00" },
    { "dayOfWeek": 3, "startTime": "09:00", "endTime": "17:00" }
  ]
}

Bookings

List Bookings

From /src/pages/api/admin/services/bookings.ts:14-96:

GET /api/admin/services/bookings?status=confirmed&page=1

Query Parameters

string

Filter by status: pending, confirmed, cancelled_by_customer, cancelled_by_provider, completed, no_show

string

Filter by service ID

string

Search in customer messages

string

Filter bookings from date (ISO 8601)

string

Filter bookings to date (ISO 8601)

Response

{
  "bookings": [
    {
      "id": "book_001",
      "serviceId": "svc_123",
      "customerId": "usr_456",
      "status": "confirmed",
      "bookingDate": "2024-03-15",
      "bookingTime": "14:00",
      "customerMessage": "Looking forward to it!",
      "providerResponse": "Confirmed. See you then!",
      "serviceSlug": "web-development",
      "serviceTitle": "Développement Web",
      "customerName": "Jane Smith",
      "customerEmail": "jane@example.com",
      "customerImage": "https://example.com/avatar.jpg"
    }
  ],
  "total": 25,
  "page": 1,
  "perPage": 20,
  "totalPages": 2
}

Update Booking Status

From /src/pages/api/admin/services/bookings.ts:102-154:

{
  "id": "book_001",
  "action": "confirm"
}

{
  "id": "book_001",
  "action": "cancel"
}

{
  "id": "book_001",
  "action": "complete"
}

{
  "id": "book_001",
  "action": "no_show"
}

{
  "id": "book_001",
  "action": "respond",
  "providerResponse": "Thanks for booking! See you at 2pm."
}

Method: PATCH /api/admin/services/bookings

Service Media

List Service Media

From /src/pages/api/admin/services/media.ts:20-51:

GET /api/admin/services/media?type=image&page=1

Upload Service Media

From /src/pages/api/admin/services/media.ts:57-208:

curl -X POST "https://your-domain.com/api/admin/services/media" \
  -H "Authorization: Bearer <token>" \
  -F "file=@service-image.jpg" \
  -F "alt=Service image" \
  -F "customName=web-dev-service"

{
  "ok": true,
  "id": "media_333",
  "url": "/uploads/services/web-dev-service.jpg"
}

Configuration

Upload directory: public/uploads/services
Max file size: 10 MB
Allowed types: JPEG, PNG, WebP, AVIF, GIF, SVG

Update/Delete Service Media

{
  "action": "update",
  "id": "media_333",
  "caption": { "fr": "Image du service" },
  "alt": { "fr": "Photo de service web" }
}

{
  "action": "delete",
  "id": "media_333"
}

Common Response Codes

Code	Description
200	Success
201	Created
400	Invalid request
403	Not admin (forbidden)
404	Resource not found
500	Server error

Audit Logging

All Services API actions are logged:

service.create
service.update
service.delete
service.duplicate
service_category.create
service_category.update
service_category.delete
services.media.upload
services.media.delete

Blog API

Manage blog content

Organizations API

Organization management

Architecture

Database

API

Overview

Service Listings

List Services

Query Parameters

Create Service

Request Body

Update Service

Other Service Actions

Service Categories

Query Parameters

Create Category

Update/Delete Category

Availability

List Availability Slots

Response

Manage Availability

Bookings

List Bookings

Query Parameters

Response

Update Booking Status

Service Media

List Service Media

Upload Service Media

Configuration

Update/Delete Service Media

Common Response Codes

Audit Logging

Blog API

Organizations API

​Overview

​Service Listings

​List Services

​Query Parameters

​Create Service

​Request Body

​Update Service

​Other Service Actions

​Service Categories

​List Categories

​Query Parameters

​Create Category

​Update/Delete Category

​Availability

​List Availability Slots

​Response

​Manage Availability

​Bookings

​List Bookings

​Query Parameters

​Response

​Update Booking Status

​Service Media

​List Service Media

​Upload Service Media

​Configuration

​Update/Delete Service Media

​Common Response Codes

​Audit Logging

​Related Resources

Blog API

Organizations API

Overview

Service Listings

List Services

Query Parameters

Create Service

Request Body

Update Service

Other Service Actions

Service Categories

List Categories

Query Parameters

Create Category

Update/Delete Category

Availability

List Availability Slots

Response

Manage Availability

Bookings

List Bookings

Query Parameters

Response

Update Booking Status

Service Media

List Service Media

Upload Service Media

Configuration

Update/Delete Service Media

Common Response Codes

Audit Logging

Related Resources