Skip to content

Latest commit

 

History

History
34 lines (24 loc) · 1.47 KB

Get Topics.md

File metadata and controls

34 lines (24 loc) · 1.47 KB

Get Topics

Topics are a way to organize Metrics and other content into thematic groups.

This example assumes you have configured your Wikirate REST client. Instructions on how to configure a client can be found in examples/Configurations.md

The get_topics method take as an input a Hash where the user can define the parameters of their request. More specifically, we could divide our params in two different types of parameters, the endpoint parameters and the filter parameters. The endpoint parameters help us to iterate through our query's results and the filter parameters allow us to restrict our results based on specific given input.

endpoint params:
  • limit: default value 20, the maximum number of entries to return. If the value exceeds the maximum, then the maximum value will be used.
  • offset: default value 0, the (zero-based) offset of the first item in the collection to return

filter params:

  • name: returns topics that contain in their name the given string

  • bookmark: returns the topics you have bookmarked, allowed parameter values:

    • 'bookmark'
    • 'nobookmark'

In the example below, we are looking for topics that contain on their name the string environment.

topics = client.get_topics({ 'name' => 'environment' })
puts topics