apiaryio

Apiary.io CLI

Install

install gem (required)

gem install apiaryio

setup APIARY.io credentials (required for publish and fetch command only)

Retrieve APIKEY on https://login.apiary.io/tokens
Save it to your environment variables :

export APIARY_API_KEY=<your_token_retrieved_on_step_1>

Description

The Apiary CLI gem is a command line tool for developing and previewing API Blueprint documents locally. It can also be used for pushing updated documents to and fetching existing documents from Apiary.io.

Please see the full documentation for an in-depth look in how to use this tool.

Usage

$ apiary help

Usage: apiary command [options]
Try 'apiary help' for more information.

Currently available apiary commands are:

  preview                                     Show API documentation in default browser
  preview --browser [chrome|safari|firefox]   Show API documentation in specified browser
  preview --output [FILE]                     Write generated HTML into specified file
  preview --path [PATH]                       Specify path to blueprint file
  preview --api_host [HOST]                   Specify apiary host
  preview --server                            Start standalone web server on port 8080
  preview --server --port [PORT]              Start standalone web server on specified port
  publish --api-name [API_NAME]               Publish apiary.apib on docs.API_NAME.apiary.io
  publish --api-name [API_NAME] \
          --message [COMMIT_MESSAGE]          Publish with custom commit message
  fetch   --api-name [API_NAME]               Fetch apiary.apib from API_NAME.apiary.io
          --output [FILE]                     Write apiary.apib into specified file
  help                                        Show this help
  version                                     Show version