# API Contract for Krishna Industrial Services

## 1. Authentication (Mobile App)
All endpoints require `Accept: application/json`.

### Login
`POST /api/login`
**Request:**
```json
{
  "mobile_number": "9876543210",
  "password": "password123"
}
```
**Response (200 OK):**
```json
{
  "token": "1|abc123def456...",
  "user": {
    "id": 1,
    "name": "User Name",
    "mobile_number": "9876543210"
  }
}
```

### Register
`POST /api/register`
**Request:**
```json
{
  "name": "User Name",
  "mobile_number": "9876543210",
  "organisation": "Optional Company",
  "password": "password123",
  "password_confirmation": "password123"
}
```
**Response (201 Created):**
```json
{
  "token": "2|abc123def456...",
  "user": { ... }
}
```

## 2. Catalog
### List Categories (Nested)
`GET /api/categories`
**Response (200 OK):**
```json
[
  {
    "id": 1,
    "name": "3M Water",
    "image_url": "https://res.cloudinary.com/...",
    "subcategories": [ ... ]
  }
]
```

### List Products by Category
`GET /api/categories/{id}/products?page=1`
**Response (200 OK):**
```json
{
  "data": [
    {
      "id": 101,
      "name": "3M Back Wash Filter",
      "description": "...",
      "image_url": "https://res.cloudinary.com/..."
    }
  ],
  "links": { ... }
}
```

### Get Product Details
`GET /api/products/{id}`
**Response (200 OK):**
```json
{
  "id": 101,
  "name": "3M Back Wash Filter",
  "description": "...",
  "benefits": ["High dirt holding capacity", "..."],
  "variants": [
    {
      "id": 201,
      "sku": "BWS 1.0",
      "name": "Systems - BWS 1.0"
    }
  ]
}
```

## 3. Enquiries
`POST /api/enquiries`
**Headers:** `Authorization: Bearer {token}`
**Request:**
```json
{
  "name": "User Name",
  "mobile_number": "9876543210",
  "organisation_name": "Optional",
  "product_id": 101,
  "variant_id": 201
}
```
**Response (201 Created):**
```json
{
  "message": "Enquiry submitted successfully"
}
```

## 4. Videos
`GET /api/videos?type=Video`
**Response (200 OK):**
```json
{
  "data": [
    {
      "id": 1,
      "youtube_video_id": "abc123xyz",
      "title": "Training Session at Chennai",
      "thumbnail_url": "https://img.youtube.com/vi/abc123xyz/0.jpg",
      "type": "Video",
      "published_at": "2026-07-20T10:00:00Z"
    }
  ]
}
```