Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
outlinetrue

Get Facets

GET https://topicsquirro-api.squirro.comendpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/facets

...

Create Facet

POST https://topicsquirro-api.squirro.comendpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/facets

...

Parameters:
  • tenant – User tenant.
  • project_id – Project identifier.
JSON Data:

Data is passed in as a JSON object.

Valid object keys:

  • name – The name of the facet. This is the name with which the facet is referenced in an item's keyword list.
  • display_name – The name with which that facet is displayed to the user.
  • data_type – The facet's data type. See the section Data Types below for the available data types.
  • visible – Boolean indicating whether the facet is visible to the user.
  • group_name – The group under which this facet is displayed.

Only the name key is required. All other keys are optional.

Example request body:

Code Block
js
js
{
    "display_name": "Comment Count",
    "name": "comment_count",
    "data_type": "int",
    "group_name": "Metadata",
    "visible": true
}
Headers:See Common Headers.
Status Codes:
  • 201 – Facet created.
  • 409 – A facet with the same name already exists.

See also Common Status Codes.

Returns:

The created facet.

Code Block
languagejs
{
    "display_name": "Comment Count",
    "name": "comment_count",
    "data_type": "int",
    "group_name": "Metadata",
    "visible": true,
    "id": "a665d30abd88e397251bce536664bcdbfb8163c874459eebc813b42d7fc36def"
}

Get Facet

GET https://topicsquirro-api.squirro.comendpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/facets/(id: facet_id)

...

Parameters:
  • tenant – User tenant.
  • project_id – Project identifier.
  • facet_id – Facet identifier.
Headers:See Common Headers.
Status Codes:
  • 200 – Facet returned.

See also Common Status Codes.

Returns:

The facet.

Code Block
js
js
{
    "display_name": "comment_count",
    "name": "comment_count",
    "data_type": "int",
    "group_name": "By field",
    "visible": true,
    "id": "a665d30abd88e397251bce536664bcdbfb8163c874459eebc813b42d7fc36def"
}

Update Facet

PUT https://topicsquirro-api.squirro.comendpoint/api/topic/v0/(string: tenant)/projects/(id: project_id)/facets/(id: facet_id)

...