{"files":{"SKILL.md":"---\nname: bc-gov-news-api-service-10\ndescription: \"BC Gov News API Service 1.0 API skill. Use when working with BC Gov News API Service 1.0 for api. Covers 27 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# BC Gov News API Service 1.0\nAPI version: 1.0\n\n## Auth\nDetected auth parameter: `key` (found in parameter)\n\n## Base URL\nhttps://news.api.gov.bc.ca/\n\n## Setup\n1. Set the `key` parameter for authentication\n2. GET /api/FacebookPosts/ByUri -- get a facebook post based on a uri\n3. Explore available endpoints below\n\n## Endpoints\n27 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Api\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /api/FacebookPosts/ByUri | Get a Facebook post based on a Uri |\n| GET | /api/Home | Returns the top level content for the home page |\n| GET | /api/Ministries | Get all ministries |\n| GET | /api/Ministries/{key} | Get the Ministry associated with the ministry key |\n| GET | /api/Ministries/{key}/Minister | Get the Minister associated with the ministry key |\n| GET | /api/Newsletters | Get all newsletters |\n| GET | /api/Newsletters/{newsletterKey} | Get a specific newsletter |\n| GET | /api/Newsletters/{newsletterKey}/Editions/{editionKey} | Returns a specific edition of a newsletter |\n| GET | /api/Newsletters/{newsletterKey}/Editions/{editionKey}/Articles/{articleKey} | Get an article belonging to a Newsletter edition |\n| GET | /api/Newsletters/Images/{guid} | Get the image object reference by of a Newsletter Edition associated with the image guid |\n| GET | /api/Posts/{key} | Get the post associated with the key |\n| GET | /api/Posts | Get the posts associated with the keys in the list passed in. |\n| GET | /api/Posts/Latest/{indexKind}/{indexKey} | Get the latest posts of postKind for the specified index (default or category) |\n| GET | /api/Posts/Keys/{indexKind}/{indexKey} | Get all keys for the specified index (newsroom or category) |\n| GET | /api/Posts/Keys/{reference} | Get the post key associated with the reference. |\n| GET | /api/Posts/LatestMediaUri/{mediaType} | Gets the latest Social Media post for the social media type passed in. |\n| GET | /api/ResourceLinks | Get all resource links |\n| GET | /api/Sectors | Get all Sectors |\n| GET | /api/Sectors/{key} | Get the sector associated with the key |\n| GET | /api/Services | Get all Services |\n| GET | /api/Services/{key} | Get the service associated with the passed key |\n| GET | /api/Slides/{id} | Get the slide associated to the id |\n| GET | /api/Slides | Get all Slides |\n| GET | /api/Tags | Get all Tags |\n| GET | /api/Tags/{key} | Get the Tag associated with the key |\n| GET | /api/Themes | Get all Themes |\n| GET | /api/Themes/{key} | Get the Theme associated with the key |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all ByUri?\" -> GET /api/FacebookPosts/ByUri\n- \"List all Home?\" -> GET /api/Home\n- \"List all Ministries?\" -> GET /api/Ministries\n- \"Get Ministry details?\" -> GET /api/Ministries/{key}\n- \"List all Minister?\" -> GET /api/Ministries/{key}/Minister\n- \"List all Newsletters?\" -> GET /api/Newsletters\n- \"Get Newsletter details?\" -> GET /api/Newsletters/{newsletterKey}\n- \"Get Edition details?\" -> GET /api/Newsletters/{newsletterKey}/Editions/{editionKey}\n- \"Get Article details?\" -> GET /api/Newsletters/{newsletterKey}/Editions/{editionKey}/Articles/{articleKey}\n- \"Get Image details?\" -> GET /api/Newsletters/Images/{guid}\n- \"Get Post details?\" -> GET /api/Posts/{key}\n- \"List all Posts?\" -> GET /api/Posts\n- \"Get Latest details?\" -> GET /api/Posts/Latest/{indexKind}/{indexKey}\n- \"Get Key details?\" -> GET /api/Posts/Keys/{indexKind}/{indexKey}\n- \"Get LatestMediaUri details?\" -> GET /api/Posts/LatestMediaUri/{mediaType}\n- \"List all ResourceLinks?\" -> GET /api/ResourceLinks\n- \"List all Sectors?\" -> GET /api/Sectors\n- \"Get Sector details?\" -> GET /api/Sectors/{key}\n- \"List all Services?\" -> GET /api/Services\n- \"Get Service details?\" -> GET /api/Services/{key}\n- \"Get Slide details?\" -> GET /api/Slides/{id}\n- \"List all Slides?\" -> GET /api/Slides\n- \"List all Tags?\" -> GET /api/Tags\n- \"Get Tag details?\" -> GET /api/Tags/{key}\n- \"List all Themes?\" -> GET /api/Themes\n- \"Get Theme details?\" -> GET /api/Themes/{key}\n- \"How to authenticate?\" -> See Auth section above\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 BC Gov News API Service 1.0\n@base https://news.api.gov.bc.ca/\n@version 1.0\n@common_fields {api-version: str=1.0 # The requested API version}\n@endpoints 27\n@hint download_for_search\n@toc api(27)\n\n@endpoint GET /api/FacebookPosts/ByUri\n@desc Get a Facebook post based on a Uri\n@optional {uri: str=}\n@returns(200) {poster: str, posterLogo: str, posterSubtitle: str, posterLikes: int(int32), content: str, postLikes: int(int32), postComments: int(int32), postShares: int(int32), facebookObjectId: int(int32), type: str, pictureUri: str} # Success\n\n@endpoint GET /api/Home\n@desc Returns the top level content for the home page\n@returns(200) {liveWebcastFlashMediaManifestUrl: str, liveWebcastM3uPlaylist: str, name: str, topPostKey: str, featurePostKey: str} # Success\n\n@endpoint GET /api/Ministries\n@desc Get all ministries\n@returns(200) Success\n\n@endpoint GET /api/Ministries/{key}\n@desc Get the Ministry associated with the ministry key\n@required {key: str}\n@returns(200) {childMinistryKey: str, parentMinistryKey: str, ministryUrl: str, displayAdditionalName: str, topicLinks: [map], serviceLinks: [map], newsletterLinks: [map], ministerName: str, contactUser: map{fullName: str, phoneNumber: str, mobileNumber: str, emailAddress: str}, secondContactUser: map{fullName: str, phoneNumber: str, mobileNumber: str, emailAddress: str}, weekendContactNumber: str, twitterFeedUsername: str, flickrUri: str, youtubeUri: str, audioUri: str, isActive: bool, name: str, topPostKey: str, featurePostKey: str} # Success\n\n@endpoint GET /api/Ministries/{key}/Minister\n@desc Get the Minister associated with the ministry key\n@required {key: str}\n@returns(200) {headline: str, summary: str, details: str, emailHtml: str, photo: str, post: str} # Success\n\n@endpoint GET /api/Newsletters\n@desc Get all newsletters\n@returns(200) Success\n\n@endpoint GET /api/Newsletters/{newsletterKey}\n@desc Get a specific newsletter\n@required {newsletterKey: str}\n@returns(200) {name: str, ministryName: str, description: str, editions: [map]} # Success\n\n@endpoint GET /api/Newsletters/{newsletterKey}/Editions/{editionKey}\n@desc Returns a specific edition of a newsletter\n@required {newsletterKey: str, editionKey: str}\n@returns(200) {name: str, htmlBody: str} # Success\n\n@endpoint GET /api/Newsletters/{newsletterKey}/Editions/{editionKey}/Articles/{articleKey}\n@desc Get an article belonging to a Newsletter edition\n@required {newsletterKey: str, editionKey: str, articleKey: str}\n@returns(200) {editionName: str, htmlBody: str} # Success\n\n@endpoint GET /api/Newsletters/Images/{guid}\n@desc Get the image object reference by of a Newsletter Edition associated with the image guid\n@required {guid: str}\n@returns(200) {fileName: str, imageBytes: str(byte), imageType: str} # Success\n\n@endpoint GET /api/Posts/{key}\n@desc Get the post associated with the key\n@required {key: str}\n@returns(200) {kind: str, atomId: str, summary: str, socialMediaSummary: str, socialMediaHeadline: str, keywords: str, publishDate: str(date-time), leadMinistryKey: str, hasMediaAssets: bool, isNewsOnDemand: bool, assetUrl: str, location: str, documents: [map], reference: str, redirectUri: str, ministryKeys: [str], sectorKeys: [str], serviceKeys: [str], facebookPictureUri: str, azureAssets: [map]} # Success\n\n@endpoint GET /api/Posts\n@desc Get the posts associated with the keys in the list passed in.\n@optional {postKeys: [str]=}\n@returns(200) Success\n\n@endpoint GET /api/Posts/Latest/{indexKind}/{indexKey}\n@desc Get the latest posts of postKind for the specified index (default or category)\n@required {indexKind: str # home or one of categories, indexKey: str # default or one key of the categories (ministries, sectors, services, tags, themes)}\n@optional {postKind: str= # One of: releases, stories, factsheets, updates or default (releases+stories except top/feature), count: int(int32)= # number of posts to return, skip: int(int32)= # number of posts to skip}\n@returns(200) Success\n\n@endpoint GET /api/Posts/Keys/{indexKind}/{indexKey}\n@desc Get all keys for the specified index (newsroom or category)\n@required {indexKind: str # home or one of categories, indexKey: str # default or one key of the categories (ministries, sectors, services, tags, themes)}\n@optional {postKind: str= # One of: releases, stories, factsheets, updates or default (releases+stories+factsheets), count: int(int32)= # number of posts to return, skip: int(int32)= # number of posts to skip}\n@returns(200) Success\n\n@endpoint GET /api/Posts/Keys/{reference}\n@desc Get the post key associated with the reference.\n@required {reference: str}\n@returns(200) {key: str, value: str} # Success\n\n@endpoint GET /api/Posts/LatestMediaUri/{mediaType}\n@desc Gets the latest Social Media post for the social media type passed in.\n@required {mediaType: str}\n@returns(200) Success\n\n@endpoint GET /api/ResourceLinks\n@desc Get all resource links\n@returns(200) Success\n\n@endpoint GET /api/Sectors\n@desc Get all Sectors\n@returns(200) Success\n\n@endpoint GET /api/Sectors/{key}\n@desc Get the sector associated with the key\n@required {key: str}\n@returns(200) {twitterFeedUsername: str, flickrUri: str, youtubeUri: str, audioUri: str, isActive: bool, name: str, topPostKey: str, featurePostKey: str} # Success\n\n@endpoint GET /api/Services\n@desc Get all Services\n@returns(200) Success\n\n@endpoint GET /api/Services/{key}\n@desc Get the service associated with the passed key\n@required {key: str}\n@returns(200) {twitterFeedUsername: str, flickrUri: str, youtubeUri: str, audioUri: str, isActive: bool, name: str, topPostKey: str, featurePostKey: str} # Success\n\n@endpoint GET /api/Slides/{id}\n@desc Get the slide associated to the id\n@required {id: str}\n@returns(200) {slideId: str(uuid), headline: str, summary: str, actionLabel: str, actionUri: str, image: str(byte), facebookPostUri: str, justify: str, imageType: str} # Success\n\n@endpoint GET /api/Slides\n@desc Get all Slides\n@returns(200) Success\n\n@endpoint GET /api/Tags\n@desc Get all Tags\n@returns(200) Success\n\n@endpoint GET /api/Tags/{key}\n@desc Get the Tag associated with the key\n@required {key: str}\n@returns(200) {twitterFeedUsername: str, flickrUri: str, youtubeUri: str, audioUri: str, isActive: bool, name: str, topPostKey: str, featurePostKey: str} # Success\n\n@endpoint GET /api/Themes\n@desc Get all Themes\n@returns(200) Success\n\n@endpoint GET /api/Themes/{key}\n@desc Get the Theme associated with the key\n@required {key: str}\n@returns(200) {twitterFeedUsername: str, flickrUri: str, youtubeUri: str, audioUri: str, isActive: bool, name: str, topPostKey: str, featurePostKey: str} # Success\n\n@end\n"}}