🔗 API Integration Toolkit — Apify Actor

A Swiss-army knife for API developers. Convert between API formats with production-grade, well-documented output code.

🚀 What It Does

Conversion	Input	Output
Postman → Python	Postman Collection v2.1 JSON	Full Python module with requests.Session, retry logic, auth
cURL → Python	cURL command string	Clean requests code with error handling
cURL → JavaScript	cURL command string	Modern fetch() with async/await and AbortSignal
GraphQL → REST	GraphQL query/mutation JSON	REST-equivalent Python code with endpoint mapping
JSON → API Docs	Any JSON API response	Markdown documentation with field table, types, examples
Batch All	Uses built-in samples	Runs ALL 5 conversions and outputs each

⚡ Quick Start

1. Run with defaults — The actor ships with working sample data for every conversion type. Just click Start and it produces output immediately.

2. Paste your own data — Replace the input_data field with your Postman JSON, cURL command, GraphQL query, or JSON response.

3. Customize — Toggle error handling, type hints, docstrings, timeout values, and retry logic via the input form.

📥 Input Schema

Field	Type	Default	Description
conversion_type	enum	curl_to_python	Which conversion to run
input_data	string	(sample cURL)	Source data to convert
add_error_handling	boolean	true	Wrap code in try/except or try/catch
add_type_hints	boolean	true	Python type annotations
add_docstrings	boolean	true	Docstrings / JSDoc comments
timeout_seconds	integer	30	HTTP timeout in generated code
max_retries	integer	3	Retry attempts in generated code
base_url_override	string	""	Replace detected base URLs
output_format	enum	full	full / code_only / documented
save_to_key_value_store	boolean	true	Save as downloadable files

📤 Output

Dataset

Each conversion produces a record with:

• conversion_type — which conversion ran
• status — success or error
• output — the generated code
• output_language — python / javascript / markdown
• timestamp — ISO 8601
• settings — the options used (in full mode)

Key-Value Store

When save_to_key_value_store is enabled, each conversion saves a downloadable file:

• postman_to_python.py
• curl_to_python.py
• curl_to_javascript.js
• graphql_to_rest.py
• json_to_api_docs.md

🛠 Generated Code Features

The Python output includes:

• requests.Session with configurable retry via urllib3.Retry
• HTTPAdapter with exponential backoff
• Proper raise_for_status() handling
• Structured logging with logging module
• Full type hints (dict[str, Any], Optional, etc.)
• Google-style docstrings
• if __name__ == "__main__": execution blocks

The JavaScript output includes:

• Modern async/await with fetch()
• AbortSignal.timeout() for request timeouts
• Granular error classification (timeout, network, HTTP)
• JSDoc comments

📋 Example API Call

{
  "conversion_type": "curl_to_python",
  "input_data": "curl -X GET 'https://api.github.com/repos/apify/apify-sdk-python' -H 'Accept: application/vnd.github.v3+json'",
  "add_error_handling": true,
  "add_type_hints": true,
  "timeout_seconds": 15
}

📁 Project Structure

├── .actor/
│   └── actor.json          # Actor metadata & dataset views
├── src/
│   ├── __init__.py
│   ├── __main__.py          # Entry point
│   └── main.py              # All conversion engines + Actor logic
├── INPUT_SCHEMA.json        # Input form with defaults
├── Dockerfile
├── requirements.txt
└── README.md

License

ISC