Add train details type

schemas/api/envelope.json

@@ -11,7 +11,7 @@
             "description": "Unix timestamp showing when the data was generated, or the time the error was encountered"
         },
         "d": {
-            "description": "Payload data.  Type depends on request endpoint"
+            "description": "Payload data.  Type depends on request endpoint, typically an array of the response type"
         },
         "e": {
             "type": "object",

schemas/api/location-filter.json

@@ -0,0 +1,31 @@
+{
+    "$id": "https://schema.owlboard.info/api/location-filter.schema.json",
+    "$schema": "https://json-schema.org/draft-07/schema#",
+    "title": "LocationFilterObject",
+    "description": "Location filter API Response.  Provides a location's data for filtering on the frontend",
+    "type": "object",
+    "required": ["n", "s"],
+    "additionalProperties": false,
+    "properties": {
+        "n": {
+            "type": "string",
+            "name": "Name",
+            "description": "Name of the location"
+        },
+        "t": {
+            "type": "string",
+            "name": "TIPLOC",
+            "description": "TIPLOC of the location"
+        },
+        "c": {
+            "type": "string",
+            "name": "CRS",
+            "description": "CRS of the location"
+        },
+        "s": {
+            "type": "string",
+            "name": "searchString",
+            "description": "Generated string for efficient filtering"
+        }
+    }
+}

schemas/api/stations/nearest-stations.json

@@ -0,0 +1,19 @@
+{
+    "$id": "https://schema.owlboard.info/api/stations/nearestStations.schema.json",
+    "$schema": "https://json-schema.org/draft-07/schema#",
+    "title": "StationsNearestStations",
+    "description": "Nearest Stations API Resonse. Returned as an Array of the object.  Response array will be sorted - nearest first",
+    "type": "object",
+    "properties": {
+        "c": {
+            "type": "string",
+            "name": "CRS"
+        },
+        "n": {
+            "type": "string",
+            "name": "Station Name"
+        }
+    },
+    "required": ["c", "n"],
+    "additionalProperties": false
+}

schemas/api/trains/TrainByHeadcode.json

@@ -0,0 +1,41 @@
+{
+    "$schema": "https://json-schema.org/draft-07/schema#",
+    "title": "TrainByHeadcodeResponse",
+    "type": "object",
+    "required": ["r", "ot", "od", "dt", "o"],
+    "additionalProperties": false,
+    "properties": {
+        "r": {
+            "type": "string",
+            "name": "rid",
+            "description": "The RID of the service described"
+        },
+        "ot": {
+            "type": "string",
+            "name": "Origin TIPLOC",
+            "description": "The TIPLOC at which the service originates",
+            "minLength": 4,
+            "maxLength": 7
+        },
+        "od": {
+            "type": "string",
+            "name": "Origin Departure",
+            "format": "date-time",
+            "description": "The time that the service departs the originating location"
+        },
+        "dt": {
+            "type": "string",
+            "name": "Destination TIPLOC",
+            "description": "The TIPLOC at which the service terminates",
+            "minimum": 4,
+            "maximum": 7
+        },
+        "o": {
+            "type": "string",
+            "name": "Operator (TOC)",
+            "description": "The TOC operating the service",
+            "minLength": 2,
+            "maxLength": 2
+        }
+    }
+}

schemas/api/trains/TrainDetails.json

@@ -0,0 +1,215 @@
+{
+    "$schema": "https://json-schema.org/draft-07/schema#",
+    "title": "TrainByHeadcodeResponse",
+    "$defs": {
+        "DateTimeTZ": {
+            "type": "string",
+            "format": "date-time",
+            "description": "An ISO-8601 timestamp"
+        },
+        "ServiceLocation": {
+            "type": "object",
+            "description": "A specific location along the services journey",
+            "additionalProperties": false,
+            "properties": {
+                "t": {
+                    "type": "string",
+                    "title": "TIPLOC",
+                    "description": "The TIPLOC of the location"
+                },
+                "r": {
+                    "type": "string",
+                    "enum": ["ORIG", "CALL", "PASS", "DEST"],
+                    "title": "Location Role",
+                    "description": "The role of this location in the journey"
+                },
+                "s": {
+                    "type": "integer",
+                    "title": "Sequence Number",
+                    "description": "The sequence at which this location sits in the schedule"
+                },
+                "act": {
+                    "title": "activities",
+                    "description": "Activities carried out at this location",
+                    "type": "string"
+                },
+                "p": {
+                    "title": "Platform",
+                    "type": "string",
+                    "description": "The platform that this event takes place"
+                },
+                "pc": {
+                    "title": "Platform Changed",
+                    "type": "boolean"
+                },
+                "pcn": {
+                    "title": "Platform Confirmed",
+                    "type": "boolean"
+                },
+                "ps": {
+                    "title": "Platform Surpressed",
+                    "description": "Whether platform data is surpressed",
+                    "type": "boolean"
+                },
+                "can": {
+                    "title": "Cancelled",
+                    "description": "Whether this location is cancelled in the journey",
+                    "type": "boolean"
+                },
+                "al": {
+                    "type": "integer",
+                    "title": "Average Loading",
+                    "description": "The average loading at this location"
+                },
+                "fid": {
+                    "type": "string",
+                    "title": "Formation ID",
+                    "description": "The formation ID at this location"
+                },
+                "pta": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Public time of arrival"
+                },
+                "wta": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Working time of arrival"
+                },
+                "wtp": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Working time of pass"
+                },
+                "ptd": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Public time of departure"
+                },
+                "wtd": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Working time of departure"
+                },
+                "eta": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Estimated time of arrival"
+                },
+                "etd": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Estimated time of departure"
+                },
+                "etp": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Estimated time of pass"
+                },
+                "ata": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Actual time of arrival"
+                },
+                "atd": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Actual time of departure"
+                },
+                "atp": {
+                    "$ref": "#/$defs/DateTimeTZ",
+                    "title": "Actual time of pass"
+                }
+            },
+            "required": ["t", "r", "s", "act"]
+        }
+    },
+    "type": "object",
+    "required": ["header", "locations"],
+    "additionalProperties": false,
+    "properties": {
+        "header": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "r": {
+                    "type": "string",
+                    "title": "RID",
+                    "description": "The RID of the service",
+                    "maxLength": 16
+                },
+                "u": {
+                    "title": "UID",
+                    "description": "The UID of the service",
+                    "type": "string"
+                },
+                "s": {
+                    "title": "SSD",
+                    "description": "The SSD of the service",
+                    "type": "string",
+                    "format": "date"
+                },
+                "h": {
+                    "title": "train_id",
+                    "description": "Headcode",
+                    "maxLength": 4,
+                    "minLength": 4,
+                    "type": "string"
+                },
+                "t": {
+                    "title": "TOC",
+                    "description": "The TOC operating the service",
+                    "type": "string",
+                    "maxLength": 3,
+                    "minLength": 2
+                },
+                "st": {
+                    "title": "Status",
+                    "description": "Train status",
+                    "type": "string"
+                },
+                "cr": {
+                    "title": "Cancel Reason",
+                    "type": "integer"
+                },
+                "cl": {
+                    "title": "Cancel Location",
+                    "type": "string",
+                    "maxLength": 7
+                },
+                "cn": {
+                    "title": "Cancel Near",
+                    "description": "Whether the train was cancelled NEAR the 'cancel_loation', else at the 'cancel_location'",
+                    "type": "boolean"
+                },
+                "dr": {
+                    "title": "Delay Reason",
+                    "type": "integer"
+                },
+                "dl": {
+                    "title": "Delay Location",
+                    "type": "string",
+                    "maxLength": 7
+                },
+                "dn": {
+                    "title": "Delay Near",
+                    "description": "Whether the train was delayed NEAR the 'delay_loation', else at the 'delay_location'",
+                    "type": "boolean"
+                },
+                "ip": {
+                    "title": "is_passenger",
+                    "description": "Whether this is a passenger service",
+                    "type": "boolean"
+                },
+                "ic": {
+                    "title": "is_charter",
+                    "description": "Whether this is a charter service",
+                    "type": "boolean"
+                },
+                "rs": {
+                    "title": "RSID",
+                    "description": "Retail Service ID",
+                    "type": "string"
+                }
+            },
+            "required": ["r", "s", "h", "t", "ip", "ic"]
+        },
+        "locations": {
+            "type": "array",
+            "additionalItems": false,
+            "items": {
+                "$ref": "#/$defs/ServiceLocation"
+            }
+        }
+    }
+}