KB User's Guide - API - Site Banners

This document provides information for the Site Banners API for the KnowledgeBase.

Title

Get Site Banners

Calls externally-published Site Banners for a specified site domain.

** APIs are not enabled for institution subsites unless specifically requested. Please contact the KB team if you would like to request an API for your subsite(s).

Collection Endpoint

This API does not have a collection response.

Entity Endpoint

https://[KB site domain]/api/v1/site-banners/[siteId]

Example: https://kb.wisc.edu/api/v1/site-banners/2

** You can find your siteId by reviewing the URI Components in the Group Spaces API, please review KB User's Guide - API - Group Spaces for details. Your siteId will be listed as an integer in the extSiteId value.

Entity Sample Response

{
"siteId": "2",
"header": null,
"headerActivation": "2018-07-27 23:15:35",
"headerExpiration": "2018-08-18 13:00:00",
"_links": {
"self": {
"href": "https://kb.wisc.edu/api/v1/site-banners/2"
}
}
}

Success Response

Code: 200 OK
Content: Content-type: application/hal+json

Error Response

Code: 404 Page Not Found
Content: { error : "Page not found." }

OR

Code: 405 Method Not Allowed
Content: { error : None }

Notes





Keywords:restapi method url data params parameters success errors responses sample calls notes service   Doc ID:86187
Owner:Teresa A.Group:KB User's Guide
Created:2018-10-02 10:01 CSTUpdated:2018-10-09 15:38 CST
Sites:KB User's Guide
Feedback:  0   0