cf-signed-request

CLI for signed requests to cf-api

Installation

npm install -g cf-signed-request

Usage

    cf-req --api-key=KEY --api-id=ID --url=URL [options]
    cf-req --login [login-url]

  Options:

    -h, --help           output usage information
    -V, --version        output the version number
    --api-key <key>      API key
    --api-id <id>        API ID
    --url <url>          URL
    --method <method>    Request method
    --login <login-url>  Login and get API key & ID
    -H, --header         HTTP header
    --compressed         Unsupported cURL command
    -o, --output <file>  Output to a file instead of stdout
    -d, --data <data>    POST data

###To login:

cf-req --login=[login-url]

The login url must be where the authentication happens, eg:

cf-req --login=http://localhost:3832/auth

This will ask for the users email and password, and returns the API key and ID.

###To perform requests:

cf-req --api-key=[api-key] --api-id=[api-id] --url=[api-url] [options]

Will perform a request of the specified type (defaults to GET) to the specified URL and displays the body of the response. Custom headers can be passed and will override any existing ones.

##Arguments

| Argument | Usage | Example| |----------|-------|--------| |-h, --help| Display help |cf-req -h| |-V, --version| Display version |cf-req -V| |--api-key <key>| The API key |See --url| |--api-id <id>| The API ID |See --url| |--url <url>| The API urlMust include protocol |cf-req --api-key XYZ --api-id ABC --url http://localhost:3832/api| |--login <url>| The URL where user credentials are authenticated and API key/ID is returned.Credentials are given in a friendly copy-paste format.| cf-req --login http://localhost:3831/auth | | -H, --header '<header>' | Supply additional headers.Multiple headers may eb given, and will override application defaults. | cf-req --api-key XYZ --api-id ABC --url http://localhost:3832/api -H 'cf-keep-data:true' |

Credits

Jack Burgess

License

ISC