Adapters Overview

Adapters convert traffic from various sources to the IR format.

Available Adapters

Adapter	Source	Request Body	Response Body	Setup
HAR	Browser DevTools, proxies	Yes	Yes	Low
Postman	Postman Collections	Yes	Yes	Low
Browser	Playwright, Cypress	Yes	Yes	Low
LoggingTransport	Go http.Client	Yes	Yes	Low
Proxy Captures	mitmproxy, Charles	Yes	Yes	Low-Medium

Choosing an Adapter

For Development/Testing

• HAR files: Export from browser DevTools
• Postman collections: Convert existing API documentation
• LoggingTransport: Capture from Go http.Client
• Playwright/Cypress: Capture during E2E tests

For Production Traffic

• Proxy captures: mitmproxy, Charles Proxy
• LoggingTransport: Wrap production http.Client

For Quick Discovery

• HAR files: Quick export from browser DevTools
• Postman collections: Import existing API definitions
• Playwright: Automated test traffic capture

Fidelity Comparison

Feature	HAR	Postman	Playwright	LoggingTransport	Proxy
Request Headers	Yes	Yes	Yes	Yes	Yes
Request Body	Yes	Yes	Yes	Yes	Yes
Response Headers	Yes	Yes	Yes	Yes	Yes
Response Body	Yes	Yes	Yes	Yes	Yes
Query Params	Yes	Yes	Yes	Yes	Yes
Timing	Yes	No	Yes	Yes	Yes
Documentation	No	Yes	No	No	No
Tags/Folders	No	Yes	No	No	No
Variables	No	Yes	No	No	No

Common Workflow

1. Capture: Use an adapter to capture HTTP traffic
2. Convert: Convert to IR format (NDJSON)
3. Analyze: Run inference engine
4. Generate: Create OpenAPI spec

# Example with HAR
traffic2openapi convert har -i recording.har -o traffic.ndjson
traffic2openapi generate -i traffic.ndjson -o openapi.yaml

# Example with Postman
traffic2openapi convert postman -i collection.json -o traffic.ndjson
traffic2openapi generate -i traffic.ndjson -o openapi.yaml

Custom Adapters

You can create custom adapters by implementing the IR record format:

// Convert your traffic format to IR records
func ConvertToIR(yourData YourFormat) *ir.IRRecord {
    return ir.NewRecord(
        ir.RequestMethod(yourData.Method),
        yourData.Path,
        yourData.StatusCode,
    ).
        SetHost(yourData.Host).
        SetRequestBody(yourData.RequestBody).
        SetResponseBody(yourData.ResponseBody)
}

// Write to IR file
provider := ir.NDJSON()
writer, _ := provider.NewWriter(ctx, "output.ndjson")
for _, data := range yourTraffic {
    writer.Write(ConvertToIR(data))
}
writer.Close()