0.01
No commit activity in last 3 years
No release in over 3 years
This limited (read-only) Help Scout Docs API integration provides functionality for extracting existing documentation content
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.1
~> 3.0
~> 2.9
~> 1.15

Runtime

 Project Readme

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