{"note":"OpenAPI conversion -- returning structured metadata","name":"gov-bc-ca-news","description":"BC Gov News API Service 1.0","version":"1.0","base_url":"https://news.api.gov.bc.ca/","endpoints":27,"raw":"@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"}