Content

Get a category

Reads one category in one language, with its own content as markdown. To change a category, edit it in its source and sync; this API does not write content.

GET
/sites/{site_id}/categories/{category_id}
cURL
curl --request GET \
  --url 'https://api.notiondesk.so/sites/{site_id}/categories/{category_id}' \
  --header 'Authorization: Bearer <token>'

Ủy quyền

  • Authorizationstringheader

    api_key · http · bearer

    read
  • Authorizationstringheader

    oauth · oauth2

    read

Tham số đường dẫn

  • site_idstringbắt buộc

    The id of a site from List sites.

  • category_idstringbắt buộc

    The id of a category from List categories.

Tham số truy vấn

  • localestring

    The language to read. Defaults to the site's default_locale; an empty value reads the default.

Tiêu đề

  • nd-versionstring

    The contract version your integration was written against. Without it, the request uses the current version. An unknown value answers 400 invalid_version.

Phản hồi

The category.

Tiêu đề

  • nd-versionstring

    The contract version that answered the request.

  • X-RateLimit-Limitinteger

    Requests allowed per minute: 120 for GET, 20 for writes, per key or OAuth grant.

  • X-RateLimit-Remaininginteger

    Requests left in the current window.

  • Retry-Afterinteger

    Seconds until the next request is accepted; 0 while requests remain.

  • idstringbắt buộc

    The category identifier.

  • typestringbắt buộc
  • titlestring | nullbắt buộc

    The category name.

  • slugstring | nullbắt buộc

    The category's path segment on the site.

  • textstringbắt buộc

    The category's own content as markdown, empty when it has none.

  • urlstring | nullbắt buộc

    The category's public address.

  • localestringbắt buộc

    The language of this response.

  • last_updatedstring | nullbắt buộc

    When the category last changed.

  • statusstring | nullbắt buộc

    The category's publication status, for example published.

  • content_availablebooleanbắt buộc

    Whether Notiondesk holds content for this language yet.

  • truncatedbooleanbắt buộc

    true when text was cut at the 200,000-byte ceiling; the cut always falls on a whole character.

  • sync_in_progressbooleanbắt buộc

    Whether a sync of this category is running.

  • sync_timeoutbooleanbắt buộc

    Whether the last sync of this category timed out.

  • sync_failedbooleanbắt buộc

    Whether the last sync of this category failed.

  • sync_error_codestring | nullbắt buộc

    Why the last sync failed.