Youngster: book a senior into a free tech-help session

Find the Youngster venues (libraries, community centres) nearest to a place in Australia, nearest first, each with its next session date. With no place given, lists venues with the soonest sessions first.

{
  "type": "object",
  "properties": {
    "near": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "A suburb, postcode or street address in Australia, e.g. \"Frankston VIC\" or \"3199\"."
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Instead of near: latitude of the point to search from."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Instead of near: longitude of the point to search from."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5,
      "description": "How many venues to return (default 5)."
    }
  },
  "additionalProperties": false
}

List a venue's upcoming sessions, each with its slots and how many seats are left in each. A slot with seats_left 0 is full. Times are local to the venue.

{
  "type": "object",
  "properties": {
    "venue_id": {
      "type": "string",
      "pattern": "^\\d{13}x\\d{18}$",
      "description": "A venue_id from find_venues."
    },
    "from_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional. Earliest date to include, YYYY-MM-DD, venue local time."
    },
    "to_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional. Latest date to include, YYYY-MM-DD, venue local time."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 15,
      "default": 6,
      "description": "How many sessions to return (default 6)."
    }
  },
  "required": [
    "venue_id"
  ],
  "additionalProperties": false
}

Book one senior into one slot of a session. Only with the senior's agreement. The reply is the confirmation (booked: true, with the venue, address, date and time to tell the person). Bookings cannot be changed or cancelled here; to change or cancel, call Youngster on 1300 774 711.

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "pattern": "^\\d{13}x\\d{18}$",
      "description": "A session_id from list_sessions."
    },
    "slot_id": {
      "type": "string",
      "pattern": "^\\d{13}x\\d{18}$",
      "description": "A slot_id from that same session in list_sessions."
    },
    "senior_first_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "First name of the senior who will attend. Letters, spaces, hyphens and apostrophes only."
    },
    "senior_last_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "Last name of the senior who will attend. Letters, spaces, hyphens and apostrophes only."
    },
    "senior_phone": {
      "type": "string",
      "minLength": 8,
      "maxLength": 20,
      "description": "The senior's Australian phone number, e.g. \"0412 345 678\". A mobile gets reminder texts."
    },
    "senior_agreed": {
      "type": "boolean",
      "description": "Must be true: only book a senior who asked for or agreed to this booking."
    },
    "booker_name": {
      "type": "string",
      "minLength": 0,
      "maxLength": 40,
      "description": "Optional. Name of the person arranging this, if not the senior. Letters, spaces, hyphens and apostrophes only."
    },
    "booker_relationship": {
      "type": "string",
      "maxLength": 30,
      "description": "Optional. How the booker knows the senior, e.g. \"daughter\", \"carer\", \"self\"."
    }
  },
  "required": [
    "session_id",
    "slot_id",
    "senior_first_name",
    "senior_last_name",
    "senior_phone",
    "senior_agreed"
  ],
  "additionalProperties": false
}