user-site

Get

/v1/Categories/{categoryId}/content/{langCode}

Security

API Key

Header parameter nameapi_token

Enter REST API key. To generate a key, go to Settings → Knowledge base portal → API tokens

Path parameters

categoryId

string Required

The ID of the category

langCode

string Required

Language code of the category

Query parameters

isForDisplay

boolean

Set this to true, if you are displaying the category to the end-user. If true, the content of snippets or variables appears in the category. Note: If the value is true, ensure that the article content is not passed for update category endpoints.

isPublished

boolean

To get latest published article, set isPublished as true.

Responses

200

Success

Success Response

This is an example for get category page succes response. \n Here you can view diffrent data included with multiple Authors associated with a category page.

{
  "category": {
    "id": "5b291e6b-fa40-4ab9-941e-f8fffc23b376",
    "title": "IndexPage",
    "content": "Content is the information contained within communication media. This includes internet, cinema, television, radio, audio CDs, books, magazines, physical art, and live event content. It’s directed at an end-user or audience in the sectors of publishing, art, and communication",
    "html_content": "Content is the information contained within communication media. This includes internet, cinema, television, radio, audio CDs, books, magazines, physical art, and live event content. It’s directed at an end-user or audience in the sectors of publishing, art, and communication\n",
    "block_content": null,
    "parent_category_id": null,
    "project_document_version_id": "46f48bc7-760f-4b07-b2d2-fce4aa8ba234",
    "version_number": 1,
    "public_version": 1,
    "latest_version": 1,
    "enable_rtl": true,
    "hidden": false,
    "status": 2,
    "created_by": "f11efc6f-e968-4e95-82eb-85ad61559de8",
    "authors": [
      {
        "id": "f11efc6f-e968-4e95-82eb-85ad61559de8",
        "first_name": "peter",
        "last_name": "jone",
        "email_id": "peterjone@mail.com",
        "profile_logo_url": "https://www.gravatar.com/avatar/FE29D578CBEC3945FC88BF4F10906A3E",
        "user_role": 7,
        "last_login_at": "2023-03-08T10:40:05.3858129Z",
        "unique_user_name": "peter-jone",
        "sso_user_type": 0,
        "is_sso_user": false
      }
    ],
    "created_at": "2023-03-08T10:40:05.3858103Z",
    "modified_at": "2023-03-08T10:40:05.3858117Z",
    "slug": "indexpage",
    "is_fall_back_content": true,
    "stale_status": {
      "article_stale_status": 0,
      "stale_reason": "",
      "expired_at": "2023-03-08T10:40:05.3858139Z"
    },
    "content_type": "Markdown"
  },
  "extension_data": null,
  "success": true,
  "errors": [],
  "warnings": [],
  "information": []
}

Expand All

object

category

object

string

The ID of the category

title

string

Category title

content

string

Category page content

html_content

string

Category page HTML content

block_content

string

parent_category_id

string

Parent category Id

project_document_version_id

string

project document version id

version_number

integer

The currently fetched version number of this category page

public_version

integer

The version number that is currently published

latest_version

integer

The latest version number(revision) of this category page.

enable_rtl

boolean

Indicates if Right to Left alignment is enabled for the category page language

hidden

boolean

Indicates if the category page is visible on the site

status

integer

Valid values[0,1,2,3,4,5]

created_by

string

The ID of the user that created the category page

authors

Array of object

The list of authors that contributed to this category page

object

string

first_name

string

last_name

string

email_id

string

profile_logo_url

string

user_role

integer

Valid values[1,2,3,4,7]

last_login_at

string

unique_user_name

string

sso_user_type

integer

Valid values[0,1,2]

is_sso_user

boolean

created_at

string

The date the category page was created

modified_at

string

The date the category page was last modified

slug

string

The slug of the category page

is_fall_back_content

boolean

Indicates whether the category page content is a fallback of the default language content or not

stale_status

object

article_stale_status

integer

Valid values[0,1]

stale_reason

string

expired_at

string

content_type

string

extension_data

object

success

boolean

Status indication for customer Api response

errors

Array of object

Errors in the customer Api response

object

extension_data

stack_trace

string

Stack trace for error response message

description

string

Description for error cause

error_code

string

Error code for Api resonse

custom_data

object

warnings

Array of object

Warning in the customer Api response

object

extension_data

description

string

Warning description

warning_code

string

warning code for customer Api base response

information

Array of object

Information passed by the customer Api response

object

extension_data

description

string

status description for customer Api response information

400

Bad Request

Category not found

Kindly verify the Categotry Id, version Number and Langauage code, and peroform the task again.

{
  "category": null,
  "extension_data": null,
  "success": false,
  "errors": [
    {
      "extension_data": null,
      "stack_trace": null,
      "description": "Category not found",
      "error_code": "400",
      "custom_data": null
    }
  ],
  "warnings": [],
  "information": []
}

Version not found

Kindly verify the version Number and language code, and peroform the task again.

{
  "category": null,
  "extension_data": null,
  "success": false,
  "errors": [
    {
      "extension_data": null,
      "stack_trace": null,
      "description": "Category with Id ad6ef117-1e8f-4817-800b-6ed8e2304bf2 with the language code en does not contain version 2",
      "error_code": "400",
      "custom_data": null
    }
  ],
  "warnings": [],
  "information": []
}

Expand All

object