Skip to content

Latest commit

 

History

History
62 lines (35 loc) · 1.42 KB

README.rdoc

File metadata and controls

62 lines (35 loc) · 1.42 KB
Raw

Help Scout Docs ↑

This limited (read-only) Help Scout Docs API integration provides functionality for extracting existing documentation content

See: developer.helpscout.net/docs-api/

Interfacing with the API directly ↑

Configuration ↑

In your initializer:

HelpScoutDocs.configure do |config|
  config.api_key  = "api-key"
end

Or set ENV

Create client ↑

client = HelpScoutDocs::Client.new({api_key: "api-key"})

Articles ↑

Supported methods: get, list (by_category, by_collection), related, revisions, get_revision

HelpScoutDocs::Article.new.get(1)
  => HelpScoutDoc::Result #response=>{article: {id: 1, number: "6239e556e4b0cf4cd3254852"} ...}

Categories ↑

Supported methods: list, get

HelpScoutDocs::Category.new.list(1)
HelpScoutDocs::Category.new.get(1)

Collections ↑

Supported methods: list, get

HelpScoutDocs::Collection.new.list
HelpScoutDocs::Collection.new.get(1)

Sites ↑

Supported methods: list, get

HelpScoutDocs::Collection.new.list
HelpScoutDocs::Collection.new.get(1)

Passing parameters ↑

Additional parameters are supported for each request (as well as ids in place of numbers), for example:

HelpScoutDocs::Collection.new.list("123", { siteId: 1, page: 2 })

TODO ↑

  • Add objects for returned types (Asset, Article, Category, Collection, Site) and collections

  • Add write methods (create, update etc.)

  • Handle all error response codes