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