Topics Map > Advanced HTML
Topics Map > API Documentation

KB User's Guide - API - Articles

This document provides information in the Articles API for the KnowledgeBase.

Title

Get External Documents

Calls externally-published document content for the specified site domain.

Collection Endpoint

https://[KB site domain]/[subsite (optional)]/api/v1/articles

Example: https://kb.wisc.edu/api/v1/articles or https://kb.wisc.edu/helpdesk/api/v1/articles

** 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).

Method

GET

URL Params

Note: All URL params are optional.

parametertypedescription
querytext stringone or more search terms, separated by a plus sign (plus sign)
catIdintegerID number of an active topic
audIdintegerID number of an active audience
exactinteger0 or undefined = fuzzy search (default)
1 = verbatim search
sortinteger

If both sort and query are undefined, results will be sorted first by search priority, then by updated date (descending).

If query is supplied but sort is undefined, results will be sorted first by search priority, then by title match (descending), keywords match (descending), and summary match (descending). This default sort order for queries is referred to as "relevance".

1 = sort by id, ascending
2 = sort by id, descending
3 = sort by title, ascending
4 = sort by title, descending
5 = sort by updated date, ascending
6 = sort by updated date, descending
7 = sort by created date, ascending
8 = sort by created date, descending
9 = sort by reviewed date, ascending
10 = sort by reviewed date, descending
11 = sort by activation date, ascending
12 = sort by activation date, descending
13 = sort by expiration date, ascending
14 = sort by expiration date, descending
15 = sort by view count, ascending
16 = sort by view count, descending
17 = sort by owner group, ascending
18 = sort by owner group, descending
modeinteger0 or undefined = Keywords search (default)
1 = Fulltext search
2 = Attachments search
3 = Keywords plus Attachments search
4 = Fulltext plus Attachments search
ownerGroupstring

If ownerGroup is undefined, results will include all documents available to the current group.

this = filter to docs owned by current group
other = filter to docs shared by other groups

Collection Sample Response

{
  "_links": {
    "self": {
      "href": "https://kb.wisc.edu/api/v1/articles?page=1"
    },
    "first": {
      "href": "https://kb.wisc.edu/api/v1/articles"
    },
    "last": {
      "href": "https://kb.wisc.edu/api/v1/articles?page=428"
    },
    "next": {
      "href": "https://kb.wisc.edu/api/v1/articles?page=2"
    }
  },
  "_embedded": {
    "article": [
      {
        "id": "5278",
        "title": "D2L - Getting Started",
        "keywords": "learn@uw learnuw desire2learn d2l tutorial manual introduction content navbar tool pedagogy",
        "summary": "The following narrated tutorials will help instructors and other course owners get started with a course in D2L at UW-Madison. Some components include click-along exercises, but you can also follow along when indicated below. The entire tutorial takes approximately 17 minutes (if this time commitment is too large, please use the printed \"Quick Reference\" or \"online checklist\" linked below).",
        "updated": "2017-03-16 18:03:20",
        "created": "2007-01-10 00:00:00",
        "reviewed": "2017-03-04 15:58:36",
        "activation": "2007-01-10 00:00:00",
        "expiration": "3000-01-01 00:00:00",
        "searchPriority": "1",
        "ownerGroup": "Learn@UW Mad",
        "views": "74300",
        "_links": {
          "self": {
            "href": "https://kb.wisc.edu/api/v1/articles/5278"
          }
        }
      },
      {
        "id": "1",
        "title": "Get Help from DoIT",
        "keywords": "DoIT help desk missions statement support policies statistics stats employment jobs satellite service desk hours operation walk in chat email walkin walk-in wihd dayton computer sciences comp sci hslc east campus mall up contacting us more information HD sd online helponline \"Level 2\" HDL2",
        "summary": "The DoIT Help Desk and Tech Store provide support to students, faculty, and staff at UW-Madison on general computing issues and various UW applications. The Help Desk provides support via phone, email and live chat. The Tech Store provides help in person at three service desk locations on campus.",
        "updated": "2017-03-08 22:02:58",
        "created": "2000-07-13 00:00:00",
        "reviewed": "2017-03-08 22:02:58",
        "activation": "2006-07-17 00:00:00",
        "expiration": "2017-09-08 22:03:10",
        "searchPriority": "1",
        "ownerGroup": "DoIT Help Desk",
        "views": "739561",
        "_links": {
          "self": {
            "href": "https://kb.wisc.edu/api/v1/articles/1"
          }
        }
      },

      ...

      }
    ]
  },
  "page_count": 428,
  "page_size": 25,
  "total_items": 10677,
  "page": 1
}

Entity Endpoint

/api/v1/articles/[doc_id]

Example: /api/v1/articles/69510

URL Params

Note: All URL params are optional.

parametertypedescription
doms
text string
allows consumer to specify the desired dom to be displayed in the response output

Entity Sample Response

URL
https://kb.wisc.edu/helpdesk/api/v1/articles/1?doms=nav
title"Get Help from DoIT"
keywords"DoIT help desk missions statement support policies statistics stats employment jobs satellite service desk hours operation walk in chat email walkin walk-in wihd dayton computer sciences comp sci hslc east campus mall up contacting us more information HD sd online helponline \"Level 2\" HDL2 techstore tech store"
header""
summary"The DoIT Help Desk provides support to students, faculty, and staff at UW-Madison on general computing issues and various UW applications. The Help Desk provides remote support via phone, email, and live chat. The Help Desk also provides in-person support at our walk-in location in the Computer Sciences building. "
body"<a class=\"nav\" href=\"#help\">Remote Help</a> <a class=\"nav\" href=\"#wihd\">Walk-In Help</a> <a class=\"nav\" href=\"#wihd\"></a> <a class=\"nav\" href=\"#wihd\">&nbsp;</a> "
seeAlso""
footer""
owner"Steven S."
updater"Dana G."
created"2000-07-13 00:00:00"
updated"2019-12-03 16:39:13"
activation"2019-02-01 03:00:00"
expiration"2020-06-02 17:27:55"
ownerGroup"DoIT Help Desk"
instAccess"0"
disableFeedbackfalse
up""
previous""
next""
pageUrl"https://kb.wisc.edu/helpdesk/1"
_links
self
href"https://kb.wisc.edu/helpdesk/api/v1/articles/1"

Success Response

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

Error Response

Code: 403 Forbidden
Content: {"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html","title":"Forbidden","status":403,"detail":"Forbidden"}

OR

Code: 404 Page Not Found
Content: Page not found.

OR

Code: 405 Method Not Allowed
Content: None

OR

Code: 500 Unexpected error
Content: { error : "Error producing an iterator" }

Notes

N/A

See Also:




Keywords:restapi method url data params parameters success errors responses sample calls notes service documents docs active external   Doc ID:69510
Owner:Leah S.Group:KB User's Guide
Created:2016-12-15 14:01 CSTUpdated:2019-12-04 13:25 CST
Sites:KB User's Guide
Feedback:  0   0