Ticket Validation API

// POST /v1/tickets/validate
// Validates a ticket without checking in

Request:
{
  "ticket_id": "TKT-ABC123-XYZ",
  "event_id": "evt_abc123"     // Optional, for faster lookup
}

Response (200 OK):
{
  "valid": true,
  "ticket": {
    "id": "TKT-ABC123-XYZ",
    "type": "General Admission",
    "attendee_name": "Jane Doe",
    "checked_in": false,
    "checked_in_at": null
  }
}

Response (400 Bad Request):
{
  "valid": false,
  "error": "ALREADY_CHECKED_IN",
  "checked_in_at": "2025-07-15T09:15:00Z"
}

// POST /v1/tickets/checkin
// Validates AND marks ticket as checked in

Request:
{
  "ticket_id": "TKT-ABC123-XYZ",
  "scanner_id": "entrance_main",  // Optional: tracking
  "location": {                   // Optional: GPS
    "lat": 34.8697,
    "lng": -111.7610
  }
}

Response (200 OK):
{
  "success": true,
  "ticket": {
    "id": "TKT-ABC123-XYZ",
    "type": "General Admission",
    "attendee_name": "Jane Doe",
    "checked_in": true,
    "checked_in_at": "2025-07-15T09:30:00Z"
  }
}