GET community/get-categories?community_short_name={community_short_name}

Gets the list of categories of a community.

Request Information

Headers

HTTP_AUTHORIZATION: Required. OAuth 1.0 parameters with the OAuth signature of the url you are going to request. The consumer keys and access token can be obtained from the community administration.

Sample:
        HTTP_AUTHORIZATION:
            OAuth oauth_token="CObXqjfOisVh9%2F2GjC7NNd8BCzY%3D",
            oauth_consumer_key="clGACsiGaMp%2FD%2BUwkSvRBxA1k50%3D",
            oauth_nonce="VqKza6d5x1HpPQWFe08spbdOnkTQpfaLfD9Oeuyg",
            oauth_signature_method="HMAC-SHA1",
            oauth_timestamp="1462882011",
            oauth_signature="RH5aKKKJaEvK5cIsZZzXtFh7cCk%3D"
    

URI Parameters

NameDescriptionTypeAdditional information
community_short_name

Short name of the community

string

Required

Request Formats

application/x-www-form-urlencoded

Sample:
community_short_name=developers

Response Information

Resource Description

NameDescriptionTypeAdditional information
category_id

Category identificator

globally unique identifier

Required

category_name

Category name

string

Required

parent_category_id

Parent category identificator

globally unique identifier

Optional

Response Formats

application/json, text/json

Sample:
[
  {
    "category_id": "303d6b2c-ba60-4aef-a76f-e624095f3d69",
    "category_name": "Educative applications",
    "parent_category_id": "00000000-0000-0000-0000-000000000000"
  },
  {
    "category_id": "87753183-683b-4d7b-98fc-1a04dec8882a",
    "category_name": "Mobile applications",
    "parent_category_id": "00000000-0000-0000-0000-000000000000"
  }
]

Response HTTP status code

On success, the response contains 200 code.

On fail, throws a WebException with code:

  • 401 Unauthorized if the OAuth signature is invalid
  • 400 Bad Request if the params are invalid
  • 500 Internal server error if something goes wrong...