Where Observability
meets Structure

The only observability tool to build API behaviour models, Akita enables API-centric system monitoring and allows users to automatically detect breaking changes.

More about how Akita works

With Proxies

You can use mitmproxy to generate a HTTP Archive format (HAR) file for encrypted HTTPS traffic. Akita can then convert the HAR file into an API spec.

Convert HAR File to API Spec

All you need is a single command to convert a HAR file into an API spec:

akita apispec --traces path/to/trace.har \
  --out akita://myService:spec:mySpec

Learn more about the apispec command here.

Generate HAR File using mitmdump

In this example, we're going to generate a HAR file for encrypted traffic using mitmdump, which is part of the mitmproxy ecosystem.

Step 1: Download the official HAR conversion script.

You can find the python script for converting mitmdump to HAR file on GitHub (link).

wget https://raw.githubusercontent.com/mitmproxy/mitmproxy/master/examples/contrib/har_dump.py

Step 2: Start mitmdump to dump HAR file

mitmdump -s ./har_dump.py --set hardump=./dump.har

Step 3: Direct some traffic through the proxy.

You can configure your browser or system to use the local proxy started by mitmdump. Here we demonstrate an example using curl.

curl -D - -k --proxy localhost:8080 https://www.google.com

Generate HAR file using Charles Proxy

In this example, we're going to generate a HAR file for encrypted traffic using Charles Proxy.

Step 1: Enable SSL Proxy for All Hosts

Under Proxy > SSL Proxying Settings:

  • Make sure "Enable SSL Proxying" is checked
  • Add a new Host * to enable SSL proxying for all requests.

Step 2: Direct some traffic through the proxy.

You can configure your browser or system to use the local proxy started by mitmdump. Here we demonstrate an example using curl.

curl -D - -k --proxy localhost:8888 https://www.google.com

Step 3: Export a HAR file

Under File > Export Session, select HTTP Archive (.har) as the Filter.

Updated 2 months ago


With Proxies


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.