POST /api/admin-reservations-status

POST /api/admin-reservations-status

Update the status and/or notes of a reservation.

Request

Method

POST

Headers

Body

{
  "id": "res_1706889600000-a1b2c3",
  "productSlug": "oxi-one-mk2",
  "status": "confirmed",
  "notes": "電話連絡済み 2/5"
}

Parameters

Response

Success (200)

{
  "success": true,
  "reservation": {
    "id": "res_1706889600000-a1b2c3",
    "name": "山田太郎",
    "email": "yamada@example.com",
    "productSlug": "oxi-one-mk2",
    "status": "confirmed",
    "notes": "電話連絡済み 2/5",
    "createdAt": "2024-02-02T10:00:00.000Z"
  }
}

Status Workflow

graph LR
    P[pending] --> C[confirmed]
    P --> X[cancelled]
    C --> F[fulfilled]
    C --> X
    C --> P
    F --> C
    X --> P

Not Found (404)

{
  "success": false,
  "error": "Reservation not found"
}

Validation Error (400)

{
  "success": false,
  "error": "Missing required fields: id, productSlug, status"
}

Unauthorized (401)

{
  "success": false,
  "error": "Unauthorized"
}

Example

cURL

# Confirm a reservation
curl -X POST https://takazudomodular.com/api/admin-reservations-status \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "res_1706889600000-a1b2c3",
    "productSlug": "oxi-one-mk2",
    "status": "confirmed"
  }'

# Update status with notes
curl -X POST https://takazudomodular.com/api/admin-reservations-status \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "res_1706889600000-a1b2c3",
    "productSlug": "oxi-one-mk2",
    "status": "fulfilled",
    "notes": "発送完了 追跡番号: 1234567890"
  }'

JavaScript (fetch)

const response = await fetch('/api/admin-reservations-status', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${ADMIN_API_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    id: 'res_1706889600000-a1b2c3',
    productSlug: 'oxi-one-mk2',
    status: 'confirmed',
    notes: '電話連絡済み',
  }),
});

const data = await response.json();

if (data.success) {
  console.log('Updated reservation:', data.reservation);
}

Implementation Details

Source File

netlify/functions/admin-reservations-status.ts

Behavior

1. Validates Bearer token authentication
2. Validates required fields (id, productSlug, status)
3. Fetches existing reservation from Netlify Blobs
4. Updates status field
5. Updates notes field if provided
6. Saves updated reservation
7. Returns the updated reservation object

Storage Key

Reservations are stored with the key format: reservations/{productSlug}/{id}

Notes Handling

• If notes is provided in the request, it replaces the existing notes
• If notes is omitted, the existing notes are preserved
• To clear notes, pass an empty string: "notes": ""

Related

• POST /api/admin-reservations-list - List reservations
• POST /api/reservation - Public reservation endpoint