8 Commits

Author SHA1 Message Date
e7e2093054 Add 'm' key for 'mode' to be set only when the service is a Ship or Bus.
All checks were successful
Generate and Release Protos / release (push) Successful in 39s
2026-05-10 19:29:14 +01:00
12db4b79fd Fix formatting
All checks were successful
Generate and Release Protos / release (push) Successful in 41s
2026-05-08 19:06:41 +01:00
eb6d90bbb8 Add service data for 'False Destination' and 'Via text'.
Add envelope support for PUBLIC/STAFF enum for display decisions
2026-05-08 19:06:14 +01:00
5918cc54a8 Extend board to include passing times
All checks were successful
Generate and Release Protos / release (push) Successful in 39s
2026-05-07 14:11:53 +01:00
3b1a9a2be1 Reorganise the board JSON response
All checks were successful
Generate and Release Protos / release (push) Successful in 38s
2026-05-07 13:02:51 +01:00
b8c773c3c9 Add type for departure board data
All checks were successful
Generate and Release Protos / release (push) Successful in 40s
2026-05-06 19:47:33 +01:00
a7fe008fee Ensure required fields exist...
All checks were successful
Generate and Release Protos / release (push) Successful in 37s
2026-05-03 10:20:32 +01:00
6cfc12b538 Remove unused fields from TrainDetails response 2026-05-03 10:20:09 +01:00
3 changed files with 316 additions and 18 deletions

View File

@@ -10,6 +10,12 @@
"minimum": 0, "minimum": 0,
"description": "Unix timestamp showing when the data was generated, or the time the error was encountered" "description": "Unix timestamp showing when the data was generated, or the time the error was encountered"
}, },
"p": {
"type": "string",
"title": "Privilege Type",
"description": "Whether the data is public or staff, omitted where no differences",
"enum": ["public", "staff"]
},
"d": { "d": {
"description": "Payload data. Type depends on request endpoint, typically an array of the response type" "description": "Payload data. Type depends on request endpoint, typically an array of the response type"
}, },

View File

@@ -0,0 +1,309 @@
{
"$id": "https://schema.owlboard.info/api/stations/board.schema.json",
"$schema": "https://json-schema.org/draft-07/schema#",
"title": "StationsBoard",
"description": "Arr/Dep/Pass Board",
"type": "object",
"properties": {
"d": {
"title": "Metadata",
"type": "object",
"$ref": "#/definitions/metadata"
},
"s": {
"title": "Services",
"type": "array",
"items": {
"$ref": "#/definitions/boardService"
}
},
"m": {
"type": "array",
"title": "messages",
"items": {
"$ref": "#/definitions/boardMsgs"
}
}
},
"required": [
"n"
],
"definitions": {
"metadata": {
"type": "object",
"required": [
"n",
"o"
],
"properties": {
"n": {
"type": "string",
"title": "Location Name",
"description": "The name of the location"
},
"o": {
"type": "string",
"title": "Station Operator",
"description": "The operator of the station (not present for location)"
}
}
},
"boardService": {
"type": "object",
"required": [
"r",
"o",
"ip",
"og",
"dt"
],
"properties": {
"r": {
"type": "string",
"title": "RID",
"description": "Services RID"
},
"m": {
"type": "string",
"title": "mode",
"description": "Transport mode, default value: Train",
"enum": ["SHIP", "BUS"]
},
"o": {
"type": "string",
"title": "TOC",
"description": "The services operator code"
},
"ip": {
"type": "boolean",
"title": "isPassenger",
"description": "Whether this is a passenger service"
},
"og": {
"type": "object",
"title": "Origin",
"description": "The services origin",
"required": [
"t",
"n"
],
"properties": {
"t": {
"type": "string",
"title": "TIPLOC",
"description": "The Origin TIPLOC"
},
"n": {
"type": "string",
"title": "Name",
"description": "The Origin Name"
}
}
},
"dt": {
"type": "object",
"title": "Destination",
"description": "The services destination",
"required": [
"t",
"n"
],
"properties": {
"t": {
"type": "string",
"title": "TIPLOC",
"description": "The Destination TIPLOC"
},
"n": {
"type": "string",
"title": "Name",
"description": "The Destination Name"
}
}
},
"h": {
"type": "string",
"title": "Headcode",
"description": "The headcode of the service"
},
"fd": {
"type": "object",
"title": "False Destination",
"description": "False destination should be preferred on public boards",
"required": [
"t",
"n"
],
"properties": {
"t": {
"type": "string",
"title": "TIPLOC",
"description": "The Destination TIPLOC"
},
"n": {
"type": "string",
"title": "Name",
"description": "The Destination Name"
}
}
},
"v": {
"type": "string",
"title": "via Text",
"description": "via text that should be displayed if present"
},
"sta": {
"type": "string",
"format": "date-time",
"title": "Scheduled Arrival",
"description": "The scheduled arrival time of the service (public or working)"
},
"ata": {
"type": "string",
"format": "date-time",
"title": "Actual Arrival",
"description": "The actual arrival time of the service"
},
"eta": {
"type": "string",
"format": "date-time",
"title": "Estimated Arrival",
"description": "The estimated arrival time of the service"
},
"std": {
"type": "string",
"format": "date-time",
"title": "Scheduled Departure",
"description": "The scheduled departure time of the service (public or working)"
},
"atd": {
"type": "string",
"format": "date-time",
"title": "Actual Departure",
"description": "The actual departure time of the service"
},
"etd": {
"type": "string",
"format": "date-time",
"title": "Estimated Departure",
"description": "The estimated departure time of the service"
},
"wtp": {
"type": "string",
"format": "date-time",
"title": "Scheduled Pass",
"description": "The scheduled pass time of the service"
},
"atp": {
"type": "string",
"format": "date-time",
"title": "Actual Pass",
"description": "The actual pass time of the service"
},
"etp": {
"type": "string",
"format": "date-time",
"title": "Estimated Pass",
"description": "The estimated pass time of the service"
},
"p": {
"type": "string",
"title": "Platform",
"description": "The platform for this service"
},
"pc": {
"type": "boolean",
"title": "Platform Changed",
"description": "Whether the platform has changed (alteration)"
},
"ps": {
"type": "boolean",
"title": "Platform suppressed",
"description": "Whether the platform number is suppressed"
},
"c": {
"type": "boolean",
"title": "Cancelled",
"description": "Whether the service is cancelled at this location"
},
"da": {
"type": "boolean",
"title": "Delayed Arrival",
"description": "Whether to show the service as delayed arrival"
},
"dd": {
"type": "boolean",
"title": "Delayed Departure",
"description": "Whether to show the service as delayed departure"
},
"cr": {
"$ref": "#/definitions/reason"
},
"dr": {
"$ref": "#/definitions/reason"
},
"act": {
"type": "string",
"title": "Activities",
"description": "Activities at this location"
},
"f": {
"$ref": "#/definitions/formation"
}
}
},
"reason": {
"type": "object",
"properties": {
"r": {
"type": "string",
"title": "Reason",
"description": "The textual reason"
},
"l": {
"type": "string",
"title": "Location",
"description": "The location the reason occurred"
},
"n": {
"type": "boolean",
"title": "Near",
"description": "Whether the reason occured NEAR LOCATION (else AT LOCATION)"
}
}
},
"formation": {
"type": "object",
"properties": {
"fid": {
"type": "string",
"title": "FID",
"description": "The serviced FID at this location"
}
}
},
"boardMsgs": {
"type": "object",
"required": [
"t"
],
"properties": {
"t": {
"type": "string",
"title": "Text",
"description": "The message text"
},
"l": {
"type": "string",
"title": "Link",
"description": "The NRE Link to the incident page"
},
"lt": {
"type": "string",
"title": "Link Text",
"description": "The text to display as the link"
}
}
}
}
}

View File

@@ -128,23 +128,6 @@
"type": "object", "type": "object",
"additionalProperties": false, "additionalProperties": false,
"properties": { "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": { "h": {
"title": "train_id", "title": "train_id",
"description": "Headcode", "description": "Headcode",
@@ -208,7 +191,7 @@
"type": "string" "type": "string"
} }
}, },
"required": ["r", "s", "h", "t", "ip", "ic"] "required": ["h", "t", "ip", "ic"]
}, },
"locations": { "locations": {
"type": "array", "type": "array",