🚧 About Midaz CLI (under development)
The Midaz CLI (Command Line Interface) is a powerful tool for interacting with the Midaz platform's services and APIs via the command line. It supports operations like creating, listing, editing, and deleting entities such as Ledgers, Organizations, and Divisions, providing users with efficient control over their workflows.
Designed with functionality and simplicity in mind, the CLI is self-documenting. By using the --help flag, you can instantly access a list of available commands and their usage, ensuring an intuitive user experience.
How can I use Midaz CLI?
Midaz CLI is still under development. For more information, contact us.
Color and Type Formatting
Midaz CLI uses an intuitive visual system to enhance readability and support users with varying levels of CLI experience. These conventions include the following:
- Entities and IDs
- The types of entities (Ledger, Organization, and Divisions) are displayed in blue and bold.
- The IDs are displayed in pink and bold.
- HTTP Methods
- POST: Displayed in yellow and bold.
- DELETE: Displayed in red and bold.
- PUT and PATCH: Displayed in blue and bold.
- GET: Displayed in green and bold.
Example
Figure 1. An example of an Organization created using Midaz CLI.
Spacing
All text displayed follows single-spacing to ensure a clean presentation.
Iconography
- ✔: Indicates a successful operation.
- ✕: Indicates a failed operation.
Usage Modes
The Midaz CLI supports three primary usage modes:
Single-line Commands
If you want to use single-line commands, you can pass all required parameters directly in the command (figure 2).
Figure 2. Example of a single-line command.
Interactive Mode
In interactive mode, you will complete the request as if it were a form. The required parameters will be requested one at a time (figure 3).
Figure 3. Example of the interactive mode.
Attention
In iteractive mode, only the required fields will be requested. If you want to use the optional fields, use the single-line command.
Help Mode
If you need assistance with any command or subcommand, you can use the --help or -h options at the end of the command. This will display information such as a description, examples, and available options for that command (figure 4).
Figure 4. Example of the help mode.
Midaz CLI Configuration
If needed, you can use the mdz configure command to define the following parameters according to the values you use for your operations:
| Parameter | Command | Description |
|---|---|---|
| client-id | --client-id <string> | The unique client identifier used for authentication. |
| client-secret | --client-secret <string> | The secret key used to validate the client's identity. |
| url-api-auth | --url-api-auth <string> | The URL of the authentication service. |
| url-api-ledger | --url-api-ledger <string> | The URL of the service responsible for the ledger. |
Updated 14 days ago