{"files":{"SKILL.md":"---\nname: drivebcs-open511-api\ndescription: \"DriveBC's Open511 API skill. Use when working with DriveBC's Open511 for events, jurisdiction, jurisdictiongeography. Covers 4 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# DriveBC's Open511 API\nAPI version: 1.0.0\n\n## Auth\nNo authentication required.\n\n## Base URL\nhttp://api.open511.gov.bc.ca/\n\n## Setup\n1. No auth setup needed\n2. GET /events -- lists road events\n3. Explore available endpoints below\n\n## Endpoints\n4 endpoints across 4 groups. See references/api-spec.lap for full details.\n\n### Events\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /events | Lists road events |\n\n### Jurisdiction\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /jurisdiction | Lists the jurisdictions publishing data through this Open511 API implementation |\n\n### Jurisdictiongeography\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /jurisdictiongeography | Provides the geographical boundaries for all the jurisdictions. |\n\n### Areas\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /areas | Lists the geographical areas (e.g. districts) that can be used to filter events. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all events?\" -> GET /events\n- \"List all jurisdiction?\" -> GET /jurisdiction\n- \"List all jurisdictiongeography?\" -> GET /jurisdictiongeography\n- \"List all areas?\" -> GET /areas\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api DriveBC's Open511 API\n@base http://api.open511.gov.bc.ca/\n@version 1.0.0\n@endpoints 4\n@toc events(1), jurisdiction(1), jurisdictiongeography(1), areas(1)\n\n@group events\n@endpoint GET /events\n@desc Lists road events\n@optional {format: str(json/xml)=json # The format of the response, status: str(ALL/ACTIVE/ARCHIVED)=ALL # Limits the response to events having a given status., severity: str=MAJOR # Limits the response to events tagged with one of the listed severity values. The possible values are: [MINOR, MODERATE, MAJOR].  Multiple values may be listed, and should be separated by a comma. The default is to return events of any severity., jurisdiction: str=drivebc.ca # Limits the response to events reported by a given jurisdiction. The value given must be specified as the ID of a jurisdiction returned by the /jurisdiction resource. The default is to return events from all jurisdictions., event_type: str(CONSTRUCTION/SPECIAL_EVENT/INCIDENT/WEATHER_CONDITION/ROAD_CONDITION)=INCIDENT # Limits the response to events tagged with one of the listed event types.  The possible values include: [CONSTRUCTION, INCIDENT, SPECIAL_EVENT, WEATHER_CONDITION].  Multiple values may be listed, and should be separated by a comma. The default is to return events of all types., created: str=>2015-09-01T12:00:00Z # Limits the response to events based on the date and time that the event was created (first recorded). The date/time must be specified in ISO 8601 format, and may be prefixed by one of the following operators [, >=] to indicate 'before', 'before or equal to', 'after' or 'after or equal to' respectively.  For example, >2013-12-01T12:00:00Z requests all events create after Dec. 1, 2015 at 12pm (noon) Coordinated Universal Time.  The default is to return events with any creation time., updated: str=>2015-09-01T12:00:00Z # Limits the response to events based on the date and time that the event was last updated. The date/time must be specified in ISO 8601 format, and may be prefixed by one of the following operators [, >=] to indicate 'before', 'before or equal to', 'after' or 'after or equal to' respectively.  For example, >2013-12-01T12:00:00Z requests all events updated after Dec. 1, 2015 at 12pm (noon) Coordinated Universal Time. The default is to return events with any update time, road_name: str=Highway 99 # Limits the response to events on a given road as specified by the road name.  An example of a valid road name is 'Highway 1'. The default is to return events on all roads., area_id: str=drivebc.ca/1 # Limits the response to events within one of the specified areas.  An area must be specified as the ID of an item returned by the /areas resource. For example: an area_id of 'drivebc.ca/1' limits events to those within the Lower Mainland District.  The default is to return events in all areas., bbox: str=-130,48,-116,60 # Limits the response to events that fall within the specified geographical bounding box.  The bbox format must be '[min longitude],[min latitude],[max longitude],[max latitude]' with WGS84 coordinates.  For example: -123.45,48.99,-122.45,49.49.  The default is to return events in all geographical locations.}\n@returns(200) List of packages\n\n@endgroup\n\n@group jurisdiction\n@endpoint GET /jurisdiction\n@desc Lists the jurisdictions publishing data through this Open511 API implementation\n@optional {format: str(json/xml)=json # The format of the response}\n@returns(200) List of packages\n\n@endgroup\n\n@group jurisdictiongeography\n@endpoint GET /jurisdictiongeography\n@desc Provides the geographical boundaries for all the jurisdictions.\n@optional {format: str(json/xml)=json # The format of the response}\n@returns(200) List of packages\n\n@endgroup\n\n@group areas\n@endpoint GET /areas\n@desc Lists the geographical areas (e.g. districts) that can be used to filter events.\n@optional {format: str(json/xml)=json # The format of the response}\n@returns(200) List of packages\n\n@endgroup\n\n@end\n"}}