openapi: 3.0.3 info: title: Multi-Format Data Converter & Encryption API description: | 🚀 Universal data format converter supporting 20+ formats with military-grade encryption. ## 🎯 Key Features - **20+ Format Support**: JSON, XML, CSV, YAML, TOML, INI, Properties, ENV, Base64, BSON, MessagePack, Markdown, HTML, Hex - **DevOps Tools** *(PRO+ Plans)*: Docker Compose ↔ Kubernetes, GitHub Actions ↔ GitLab CI, Terraform HCL - **Security**: AES-256-GCM encryption with zero data retention - **Developer-Friendly**: Auto-format detection, bidirectional conversion - **Fast**: <100ms average conversion time ## 💼 Use Cases - 🐳 Migrate Docker Compose to Kubernetes - 🔄 Convert CI/CD pipelines between platforms - 📊 Transform API responses between formats - 🔐 Secure data transmission with encryption - ⚙️ Configuration file management ## 📊 Pricing Tiers ### 🆓 BASIC (Free) - 100 requests/month - 1 MB file size limit - All format conversions - Basic encryption - ❌ No DevOps conversions ### ⭐ PRO ($9.99/mo) - 10,000 requests/month - 10 MB file size limit - ✅ DevOps conversions (Docker, K8s, CI/CD) - Priority support ### 🚀 ULTRA ($49.99/mo) - 50,000 requests/month - 100 MB file size limit - Everything in PRO - 99.9% SLA ### 💎 MEGA ($199.99/mo) - 500,000 requests/month - 1 GB file size limit - Everything in ULTRA - Dedicated support - 99.99% SLA version: 2.0.0 contact: name: API Support url: https://github.com/your-repo/multiformat-converter email: support@example.com license: name: MIT url: https://opensource.org/licenses/MIT termsOfService: https://example.com/terms x-logo: url: 'https://example.com/logo.png' altText: 'Multi-Format Converter Logo' servers: - url: https://multiformat-converter.vercel.app description: Production API tags: - name: Health & Info description: System status and API information - name: Data Formats description: Convert between JSON, XML, CSV, YAML, etc. - name: Config Files description: Convert TOML, INI, ENV, Properties files - name: Binary & Encoding description: Base64, BSON, MessagePack, Hex encoding - name: Documents description: Markdown, HTML conversions - name: DevOps (PRO+) description: Docker, Kubernetes, CI/CD conversions (PRO plan required) - name: Encryption description: AES-256-GCM encryption and decryption - name: Utilities description: Password generation and other utilities paths: /health: get: tags: - Health & Info summary: Health Check description: Check if the API is running. No authentication required. operationId: healthCheck security: [] # No auth required responses: '200': description: API is healthy content: application/json: schema: type: object properties: status: type: string example: ok timestamp: type: string format: date-time example: '2024-01-15T10:30:00Z' /: get: tags: - Health & Info summary: Get API Information description: Returns API metadata, supported formats, pricing tiers, and available endpoints operationId: getApiInfo security: [] # No auth required responses: '200': description: API information content: application/json: schema: $ref: '#/components/schemas/ApiInfo' /api/convert: post: tags: - Data Formats summary: Convert Data Between Formats description: | Convert data from one format to another. Supports 20+ formats. ## ✅ All Plans Support: - **Data**: JSON, XML, CSV, YAML, TOML, INI, Properties, ENV - **Binary**: BSON, MessagePack, Base64, Hex - **Documents**: Markdown, HTML ## 🔒 PRO+ Plans Only: - **DevOps**: Docker Compose ↔ Kubernetes - **CI/CD**: GitHub Actions ↔ GitLab CI - **IaC**: Terraform HCL ↔ JSON Free tier users will receive 403 Forbidden for PRO+ conversions. operationId: convertData security: - RapidAPIAuth: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ConversionRequest' examples: jsonToYaml: summary: JSON to YAML (All Plans) description: Convert JSON object to YAML format value: from: json to: yaml data: '{"name": "MyApp", "version": "1.0.0", "port": 3000}' yamlToJson: summary: YAML to JSON (All Plans) description: Convert YAML to JSON value: from: yaml to: json data: | name: MyApp version: 1.0.0 database: host: localhost port: 5432 csvToJson: summary: CSV to JSON (All Plans) description: Convert CSV with headers to JSON array value: from: csv to: json data: | id,name,email,department 1,John Doe,john@example.com,Engineering 2,Jane Smith,jane@example.com,Marketing options: headers: true jsonToCsv: summary: JSON to CSV (All Plans) description: Convert JSON array to CSV format value: from: json to: csv data: '[{"name":"Alice","age":28,"city":"NYC"},{"name":"Bob","age":32,"city":"LA"}]' xmlToJson: summary: XML to JSON (All Plans) description: Parse XML to JSON structure value: from: xml to: json data: | 12345 John Doe john@example.com jsonToXml: summary: JSON to XML (All Plans) description: Convert JSON to XML value: from: json to: xml data: '{"order":{"id":"ORD-001","customer":"Alice","total":999.99}}' jsonToToml: summary: JSON to TOML (All Plans) description: Convert JSON to TOML config format value: from: json to: toml data: '{"database":{"host":"localhost","port":5432},"cache":{"ttl":3600}}' tomlToJson: summary: TOML to JSON (All Plans) description: Parse TOML config to JSON value: from: toml to: json data: | [database] host = "localhost" port = 5432 [cache] ttl = 3600 jsonToIni: summary: JSON to INI (All Plans) description: Convert JSON to INI format value: from: json to: ini data: '{"database":{"host":"localhost","port":"3306"},"cache":{"enabled":"true"}}' jsonToEnv: summary: JSON to ENV (All Plans) description: Generate .env file from JSON value: from: json to: env data: '{"NODE_ENV":"production","API_URL":"https://api.example.com","DB_PORT":"5432"}' envToJson: summary: ENV to JSON (All Plans) description: Parse .env file to JSON value: from: env to: json data: | # Database config DB_HOST=localhost DB_PORT=5432 DB_NAME=myapp jsonToProperties: summary: JSON to Properties (All Plans) description: Convert to Java .properties format value: from: json to: properties data: '{"app.name":"MyApp","app.version":"1.0.0","server.port":"8080"}' jsonToBase64: summary: JSON to Base64 (All Plans) description: Encode JSON as Base64 value: from: json to: base64 data: '{"userId":"12345","apiKey":"sk_test_abc123"}' base64ToJson: summary: Base64 to JSON (All Plans) description: Decode Base64 to JSON value: from: base64 to: json data: 'eyJ1c2VySWQiOiIxMjM0NSJ9' jsonToBson: summary: JSON to BSON (All Plans) description: Convert to MongoDB BSON format value: from: json to: bson data: '{"_id":"507f1f77bcf86cd799439011","name":"MongoDB Doc","count":42}' jsonToMsgpack: summary: JSON to MessagePack (All Plans) description: Encode to MessagePack binary format value: from: json to: msgpack data: '{"type":"telemetry","timestamp":1705320000,"metrics":{"cpu":45.2}}' markdownToHtml: summary: Markdown to HTML (All Plans) description: Convert Markdown to HTML value: from: markdown to: html data: | # Hello World This is **bold** and this is *italic*. - Item 1 - Item 2 csvToHtml: summary: CSV to HTML Table (All Plans) description: Convert CSV to HTML table value: from: csv to: html data: | Product,Price,Stock Laptop,999.99,15 Mouse,29.99,50 dockerToKubernetes: summary: Docker Compose → Kubernetes (PRO+ ONLY) description: ⭐ Convert Docker Compose to K8s manifests. Requires PRO, ULTRA, or MEGA plan. value: from: docker-compose to: kubernetes data: | version: '3.8' services: nginx: image: nginx:1.21-alpine ports: - '80:80' - '443:443' environment: - NGINX_HOST=example.com restart: always dockerMultiServiceToK8s: summary: Multi-Service Docker → K8s (PRO+ ONLY) description: ⭐ Convert full-stack app to Kubernetes value: from: docker-compose to: kubernetes data: | version: '3.8' services: frontend: image: myapp/frontend:latest ports: ['3000:3000'] environment: - REACT_APP_API_URL=http://backend:8080 depends_on: - backend backend: image: myapp/backend:latest ports: ['8080:8080'] environment: - DATABASE_URL=postgresql://postgres:5432/myapp depends_on: - postgres postgres: image: postgres:14-alpine environment: - POSTGRES_DB=myapp - POSTGRES_PASSWORD=secret volumes: - postgres_data:/var/lib/postgresql/data volumes: postgres_data: kubernetesToDocker: summary: Kubernetes → Docker Compose (PRO+ ONLY) description: ⭐ Convert K8s Deployment to Docker Compose value: from: kubernetes to: docker-compose data: | apiVersion: apps/v1 kind: Deployment metadata: name: webapp spec: replicas: 3 selector: matchLabels: app: webapp template: metadata: labels: app: webapp spec: containers: - name: webapp image: nginx:1.21 ports: - containerPort: 80 env: - name: ENV value: production githubToGitlab: summary: GitHub Actions → GitLab CI (PRO+ ONLY) description: ⭐ Migrate GitHub workflow to GitLab pipeline value: from: github-actions to: gitlab-ci data: | name: Node.js CI on: push: branches: [main] pull_request: branches: [main] jobs: test: runs-on: ubuntu-latest strategy: matrix: node-version: [16.x, 18.x, 20.x] steps: - uses: actions/checkout@v3 - name: Use Node.js uses: actions/setup-node@v3 with: node-version: ${{ matrix.node-version }} - run: npm ci - run: npm test - run: npm run build gitlabToGithub: summary: GitLab CI → GitHub Actions (PRO+ ONLY) description: ⭐ Convert GitLab pipeline to GitHub workflow value: from: gitlab-ci to: github-actions data: | stages: - build - test - deploy build-job: stage: build script: - npm install - npm run build test-job: stage: test script: - npm test deploy-job: stage: deploy script: - npm run deploy only: - main autoDetect: summary: Auto-Detect Format description: Let the API detect the source format automatically value: from: auto to: yaml data: '{"name":"test","value":123}' complexK8sToYaml: summary: Complex JSON to YAML description: Convert complex nested JSON to readable YAML value: from: json to: yaml data: '{"apiVersion":"v1","kind":"Service","metadata":{"name":"my-service"},"spec":{"selector":{"app":"MyApp"},"ports":[{"protocol":"TCP","port":80,"targetPort":9376}]}}' responses: '200': description: Conversion successful content: application/json: schema: $ref: '#/components/schemas/ConversionResponse' examples: jsonToYaml: summary: JSON to YAML result value: success: true data: | name: MyApp version: 1.0.0 port: 3000 metadata: format: yaml size: 38 conversionTime: 12 '400': description: Bad request - Invalid input data or unsupported format content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalidJson: summary: Invalid JSON syntax value: error: Conversion failed message: Invalid JSON syntax at line 5 unsupportedFormat: summary: Unsupported format value: error: Bad request message: 'Format "pdf" is not supported. Supported formats: json, xml, csv, yaml...' '403': description: Forbidden - Feature requires PRO+ plan content: application/json: schema: $ref: '#/components/schemas/Error' examples: devopsBlocked: summary: DevOps conversion blocked on BASIC plan value: error: Forbidden message: 'DevOps conversions (Docker Compose, Kubernetes, CI/CD) require PRO plan or higher' upgrade: currentPlan: BASIC requiredPlan: PRO upgradeUrl: 'https://rapidapi.com/your-api/pricing' pricing: PRO: '$9.99/month' ULTRA: '$49.99/month' '413': description: Payload Too Large - File size exceeds plan limit content: application/json: schema: $ref: '#/components/schemas/Error' examples: fileTooLarge: summary: File exceeds plan limit value: error: Payload Too Large message: 'File size (5.2 MB) exceeds BASIC plan limit (1 MB)' currentPlan: BASIC fileSize: 5452345 limit: 1048576 upgrade: PRO: '10 MB limit for $9.99/month' ULTRA: '100 MB limit for $49.99/month' '429': description: Too Many Requests - Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/Error' examples: rateLimitExceeded: summary: Monthly quota exceeded value: error: Too Many Requests message: 'Monthly quota exceeded (100/100 requests used)' resetDate: '2024-02-01T00:00:00Z' upgrade: 'Upgrade to PRO for 10,000 requests/month' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' /api/encrypt: post: tags: - Encryption summary: Encrypt Data description: | Encrypt data using AES-256-GCM with PBKDF2 key derivation (100,000 iterations). **Security Features:** - AES-256-GCM authenticated encryption - PBKDF2 key derivation - Cryptographically secure random IV - Zero data retention (no logs) Returns both separate fields and combined string for easy transport. operationId: encryptData security: - RapidAPIAuth: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EncryptionRequest' examples: simpleText: summary: Encrypt text value: data: 'My secret API key: sk_live_1234567890' password: 'MySecurePassword123!' jsonConfig: summary: Encrypt JSON configuration value: data: '{"aws_access_key":"AKIA...","aws_secret":"secret123","db_password":"pass456"}' password: 'ConfigEncryptionKey2024' envFile: summary: Encrypt .env file value: data: | DB_HOST=localhost DB_PASSWORD=SuperSecret123 API_KEY=sk_live_abc123 JWT_SECRET=mysupersecret password: 'EnvFilePassword' responses: '200': description: Encryption successful content: application/json: schema: $ref: '#/components/schemas/EncryptionResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/Error' /api/decrypt: post: tags: - Encryption summary: Decrypt Data description: | Decrypt AES-256-GCM encrypted data from /api/encrypt endpoint. Supports two input methods: - **encryptedString**: Combined string (easiest) - **Separate fields**: encrypted + iv + authTag operationId: decryptData security: - RapidAPIAuth: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DecryptionRequest' examples: withString: summary: Decrypt using encryptedString value: encryptedString: 'eyJlIjoiYmFzZTY0ZW5jcnlwdGVkZGF0YSIsImkiOiJiYXNlNjRpdiIsImEiOiJiYXNlNjRhdXRodGFnIn0=' password: 'MySecurePassword123!' responses: '200': description: Decryption successful content: application/json: schema: $ref: '#/components/schemas/DecryptionResponse' '400': description: Bad request or wrong password content: application/json: schema: $ref: '#/components/schemas/Error' /api/encrypt-convert: post: tags: - Encryption - Data Formats summary: Convert and Encrypt Data description: | **Combo endpoint:** Convert format AND encrypt in one API call. Perfect for secure config file transformations. operationId: encryptConvert security: - RapidAPIAuth: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EncryptConvertRequest' examples: jsonToYamlEncrypted: summary: Convert JSON to YAML and encrypt value: data: '{"api_keys":{"stripe":"sk_live_123","sendgrid":"SG.abc"}}' from: json to: yaml password: 'MasterPassword2024!' envToJsonEncrypted: summary: Convert .env to JSON and encrypt value: data: | DB_HOST=localhost DB_PASSWORD=secret123 API_KEY=sk_live_abc from: env to: json password: 'SecurePass123!' responses: '200': description: Conversion and encryption successful content: application/json: schema: type: object properties: success: type: boolean encrypted: type: string metadata: type: object /api/generate-password: get: tags: - Utilities summary: Generate Secure Password description: | Generate cryptographically secure random password using crypto.randomBytes(). **Features:** - Uppercase letters (A-Z) - Lowercase letters (a-z) - Numbers (0-9) - Special characters (!@#$%^&*) - Cryptographically secure (not Math.random) operationId: generatePassword security: - RapidAPIAuth: [] parameters: - name: length in: query description: Password length (8-128 characters) required: false schema: type: integer minimum: 8 maximum: 128 default: 32 examples: default: summary: Default (32 chars) value: 32 long: summary: Long (64 chars) value: 64 apiKey: summary: API Key (128 chars) value: 128 responses: '200': description: Password generated successfully content: application/json: schema: type: object properties: success: type: boolean example: true password: type: string example: 'aB3$fG7!kL9@pQ2#xY5&zW8%mN1^' length: type: integer example: 32 components: securitySchemes: RapidAPIAuth: type: apiKey in: header name: x-rapidapi-proxy-secret description: | RapidAPI automatically injects authentication headers. Users don't need to configure this manually - RapidAPI handles it based on their subscription. schemas: ApiInfo: type: object properties: name: type: string example: Multi-Format Data Converter API version: type: string example: '2.0.0' supportedFormats: type: object properties: allPlans: type: array items: type: string example: ['JSON', 'XML', 'CSV', 'YAML', 'TOML', 'INI', 'Base64', 'BSON'] paidPlansOnly: type: array items: type: string example: ['Docker Compose', 'Kubernetes', 'GitHub Actions', 'GitLab CI'] endpoints: type: object pricingTiers: type: object ConversionRequest: type: object required: - to - data properties: from: type: string description: Source format (auto-detect if not specified) enum: - auto - json - xml - csv - yaml - toml - ini - properties - env - base64 - hex - bson - msgpack - markdown - html - docker-compose - kubernetes - github-actions - gitlab-ci - circleci - hcl default: auto to: type: string description: Target format enum: - json - xml - csv - yaml - toml - ini - properties - env - base64 - hex - bson - msgpack - markdown - html - docker-compose - kubernetes - github-actions - gitlab-ci - circleci - hcl data: type: string description: Data to convert (string format) options: type: object description: Conversion options properties: prettyPrint: type: boolean headers: type: boolean delimiter: type: string flatten: type: boolean indent: type: integer ConversionResponse: type: object properties: success: type: boolean example: true data: oneOf: - type: string - type: object description: Converted data metadata: type: object properties: format: type: string size: type: integer conversionTime: type: number EncryptionRequest: type: object required: - data - password properties: data: type: string description: Data to encrypt password: type: string description: Encryption password (min 8 characters) minLength: 8 EncryptionResponse: type: object properties: success: type: boolean result: type: object properties: encrypted: type: string iv: type: string authTag: type: string encryptedString: type: string algorithm: type: string example: AES-256-GCM DecryptionRequest: type: object required: - password properties: encryptedString: type: string encrypted: type: string iv: type: string authTag: type: string password: type: string DecryptionResponse: type: object properties: success: type: boolean decrypted: type: string EncryptConvertRequest: type: object required: - data - to - password properties: data: type: string from: type: string default: auto to: type: string password: type: string minLength: 8 options: type: object Error: type: object properties: error: type: string description: Error type message: type: string description: Detailed error message upgrade: type: object description: Upgrade information (for plan restrictions) security: - RapidAPIAuth: [] x-rapidapi-config: gateway: type: proxy ratelimit: BASIC: limit: 100 period: month PRO: limit: 10000 period: month ULTRA: limit: 50000 period: month MEGA: limit: 500000 period: month