Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

🖥️ reqmd CLI

reqmd is a terminal application which acts as both a parser of properly formatted documents and a runner of the HTTP requests contained within those documents. This tool is designed to be used in a variety of ways, from a simple http client to a more complex part of a CI/CD pipeline, and also serves as a reference implementation for API documentation written in the ReqMd format.


The tl;dr is to be able to take a document like this:

Sample document:

Sample Document

And run commands like this:


List requests found in the document:

List Requests


Note

The server in the example is an echo server that replies with the information it was sent. What you are seeing returned is the response of that echo server. This helps demonstrate what the details were in the requests this tool sent.


Send first request in the document:

Send First Request


Adds header to request with environment variable:

Environment Headers


Can set timeouts ( Examples: 50ms, 2sec, 5min )

Error Timeout


Run by request found at a line number:

Run Line 18


Dump requests to JSON:

Dump to JSON