mics CLI

The platform is built using an API first approach. You can manage nearly anything using our API. Unfortunately, some actions can require you to use a combination of different APIs, and you'll have to handle authentication for every request.

Using mediarithmics Command Line Interface, you can simplify some actions and you won't have to add authentication headers in every request.

Installation

The CLI for mediarithmics is distributed as an NPM package. To use it, install it globally using

npm install -g @mediarithmics-ps/mics-cli

You need access to mediarithmics private packages to run this command. Contact us if required.

Getting started

On a fresh install, any command will prompt you for your authentication token. You won't have to enter it anymore.

You can use a command like mics-cli config:list to trigger this prompt.

# Run this command on a fresh install
mics-cli config:list
# The prompt will ask you for MICS API Token
# Simply copy/paste it and press enter
# The token will be saved and your command will be executed
Please enter a value for authToken (MICS API token) : *******

Creating an alias

The invoke command is mics-cli. If you prefer something else because it's shorter or just before you want, you can use

# Creates an alias for the mics-cli invoke command
alias mics="mics-cli"

# From now, all mics-cli commands can be called with mics
mics config:list

Config commands

The mics CLI has a set of config commands. They are particularly useful to manage your authentication token.

Lists all your configuration variables.

mics-cli config:list

Get the value of a configuration variable

# mics-cli config:get <VARIABLE>
mics-cli config:get authToken

Set the value of a configuration variable

# mics-cli config:set <VARIABLE> <VALUE>
# Will prompt for the value if empty
mics-cli config:set authToken

Help command

Shows all available commands, and other useful information.

mics-cli help

Whoami command

Retrieves user information based on the authentication token

# The output can be very large, 
# you may want to save it to a file
mics-cli whoami > whoami.txt

GET /v1/connected_user
{
    "id": "<USER_ID>",
    "first_name": "<USER_FIRSTNAME>",
    "last_name": "<USER_LASTNAME>",
    "email": "<USER_EMAIL>",
    "locale": null,
    "workspaces": [
     {
            "organisation_id": "<ORG_ID>",
            "customer_type": "ENTERPRISE",
            "organisation_name": "<ORG_NAME>",
            "administrator": false,
            "role": "CUSTOMER_ADMIN",
            "community_id": "<COMMUNITY_ID>",
            "administrator_id": null,
            "datamarts": [
                {
                    "id": "<DATAMART_ID>",
                    "name": "<DATAMART_NAME>",
                    "organisation_id": "<ORG_ID>",
                    "token": "<TOKEN>",
                    "creation_date": 1582031749723,
                    "time_zone": "Europe/Paris",
                    "type": "DATAMART",
                    "datafarm": "<DATAFARM>",
                    "storage_model_version": "v201709",
                    "user_point_system_version": "v201901",
                    "region": "EUROPE",
                    "archived": false,
                    "audience_segment_metrics": [...]
                }
            ]
        }
        ...
    ]
    ...
}

Autocomplete

Autocomplete installation instructions can be displayed based on your shell using the autocomplete command.

USAGE
  $ mics-cli autocomplete [SHELL]

ARGUMENTS
  SHELL  shell type

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

EXAMPLES
  $ mics-cli autocomplete
  $ mics-cli autocomplete bash
  $ mics-cli autocomplete zsh
  $ mics-cli autocomplete --refresh-cache