@apimatic/cli

@apimatic/cli

The official CLI for APIMatic.

• Usage
• Commands

Usage

$ npm install -g @apimatic/cli
$ apimatic COMMAND
running command...
$ apimatic (-v|--version|version)
@apimatic/cli/1.0.1-alpha.1 linux-x64 node-v14.18.1
$ apimatic --help [COMMAND]
USAGE
  $ apimatic COMMAND
...

Commands

• apimatic api
• apimatic api:transform
• apimatic api:validate
• apimatic auth
• apimatic auth:login
• apimatic auth:logout
• apimatic auth:status
• apimatic autocomplete [SHELL]
• apimatic help [COMMAND]
• apimatic portal
• apimatic portal:generate
• apimatic sdk
• apimatic sdk:generate

apimatic api

lists all commands related to the APIMatic API.

USAGE
  $ apimatic api

EXAMPLE
  $ apimatic api --help

See code: src/commands/api/index.ts

apimatic api:transform

Transforms your API specification to any supported format of your choice from amongst10+ different formats.

USAGE
  $ apimatic api:transform

OPTIONS
  --auth-key=auth-key        override current auth-key

  --destination=destination  [default: /home/runner/work/apimatic-cli/apimatic-cli/cli/src/commands/api] path to
                             transformed file

  --file=file                path to the API specification file to transform

  --format=format            (required) specification format to transform API specification into
                             (OpenApi3Json|OpenApi3Yaml|APIMATIC|WADL2009|WADL2006|WSDL|
                             Swagger10|Swagger20|SwaggerYaml|RAML|RAML10|Postman10|Postman20)

  --url=url                  URL to the API specification file to transform

EXAMPLE
  $ apimatic api:transform --format="OpenApi3Json" --file="./specs/sample.json" --destination="D:/"
  Success! Your transformed file is located at D:/Transformed_OpenApi3Json.json

See code: src/commands/api/transform.ts

apimatic api:validate

Validates the provided API specification file for any syntactical and semantic errors

USAGE
  $ apimatic api:validate

OPTIONS
  --auth-key=auth-key  override current auth-key
  --file=file          path to the API specification file to validate
  --url=url            URL to the specification file to validate

EXAMPLE
  $ apimatic api:validate --file="./specs/sample.json"
  Specification file provided is valid

See code: src/commands/api/validate.ts

apimatic auth

invokes subcommands related to authentication.

USAGE
  $ apimatic auth

EXAMPLE
  $ apimatic auth --help

See code: src/commands/auth/index.ts

apimatic auth:login

login to your APIMatic account

USAGE
  $ apimatic auth:login

OPTIONS
  --auth-key=auth-key  Set authentication key for all commands

EXAMPLE
  $ apimatic auth:login
  Please enter your registered email: [e-mail]
  Please enter your password: *********

  You have successfully logged into APIMatic

See code: src/commands/auth/login.ts

apimatic auth:logout

logout of APIMatic

USAGE
  $ apimatic auth:logout

EXAMPLE
  $ apimatic auth:logout
  Logged out

See code: src/commands/auth/logout.ts

apimatic auth:status

checks current logged-in account

USAGE
  $ apimatic auth:status

EXAMPLE
  $ apimatic auth:status
  Currently logged in as [e-mail]

See code: src/commands/auth/status.ts

apimatic autocomplete [SHELL]

display autocomplete installation instructions

USAGE
  $ apimatic autocomplete [SHELL]

ARGUMENTS
  SHELL  shell type

OPTIONS
  -r, --refresh-cache  Refresh cache (ignores displaying instructions)

EXAMPLES
  $ apimatic autocomplete
  $ apimatic autocomplete bash
  $ apimatic autocomplete zsh
  $ apimatic autocomplete --refresh-cache

See code: @oclif/plugin-autocomplete

apimatic help [COMMAND]

display help for apimatic

USAGE
  $ apimatic help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI

See code: @oclif/plugin-help

apimatic portal

invokes subcommands related to the API Portal.

USAGE
  $ apimatic portal

EXAMPLE
  $apimatic portal --help

See code: src/commands/portal/index.ts

apimatic portal:generate

Generate static docs portal on premise

USAGE
  $ apimatic portal:generate

OPTIONS
  --auth-key=auth-key        override current auth-key
  --destination=destination  [default: ./] path to the downloaded portal
  --folder=folder            folder to generate the portal with
  --zip                      zip the portal

EXAMPLE
  $ apimatic portal:generate --folder="./portal/" --destination="D:/"
  Your portal has been generated at D:/

See code: src/commands/portal/generate.ts

apimatic sdk

invokes subcommands related to your SDKs.

USAGE
  $ apimatic sdk

EXAMPLE
  $apimatic sdk --help

See code: src/commands/sdk/index.ts

apimatic sdk:generate

Generate SDK for your APIs

USAGE
  $ apimatic sdk:generate

OPTIONS
  --auth-key=auth-key        override current auth-key
  --destination=destination  [default: ./] path to downloaded SDK (used with download flag)
  --file=file                path to the API specification to generate SDK

  --platform=platform        (required) language platform for sdk
                             Simple: CSHARP|JAVA|PYTHON|RUBY|PHP|TYPESCRIPT
                             Legacy: CS_NET_STANDARD_LIB|CS_PORTABLE_NET_LIB|CS_UNIVERSAL_WINDOWS_PLATFORM_LIB|
                             JAVA_ECLIPSE_JRE_LIB|PHP_GENERIC_LIB|PYTHON_GENERIC_LIB|RUBY_GENERIC_LIB|
                             TS_GENERIC_LIB

  --url=url                  URL to the API specification to generate SDK

  --zip                      zip the SDK (used with download flag)

EXAMPLE
  $ apimatic sdk:generate --platform="CSHARP" --file="./specs/sample.json"
  SDK generated successfully

See code: src/commands/sdk/generate.ts

Changelog

1.0.1-alpha.1 (2021-11-26)

Bug Fixes

• release: add lock file to gitignore restore check_build workflow (2eb959a)