{ "openapi": "3.0.3", "info": { "title": "Smart Super Tools API", "version": "1.0.0", "description": "40 developer utilities (web & SEO, security, data, content, generators, network) behind one key. All tool endpoints use POST with a JSON body and return { success, data, request_id }.", "contact": { "name": "Smart Super Tools", "url": "https://smartsupertools.com/api-docs" } }, "servers": [ { "url": "https://zyjkulwxstmtqjgvcvkb.supabase.co/functions/v1/supertools-api" } ], "tags": [ { "name": "Web & SEO" }, { "name": "Security" }, { "name": "Data" }, { "name": "Content" }, { "name": "Generators" }, { "name": "Network & System" }, { "name": "System" } ], "security": [ { "RapidAPIKey": [] } ], "paths": { "/v1/health": { "get": { "operationId": "health", "summary": "Health check", "tags": [ "System" ], "responses": { "200": { "description": "Service is up" } } } }, "/v1/opengraph": { "post": { "operationId": "opengraph", "summary": "OpenGraph Preview", "description": "Extract title, description, image and OpenGraph tags of a public page.", "tags": [ "Web & SEO" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "Public http(s) URL" } } }, "example": { "url": "https://example.com" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "title": "Example Domain", "description": null, "image": null }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/url-unshortener": { "post": { "operationId": "urlUnshortener", "summary": "URL Unshortener", "description": "Follow redirects safely and return the final destination and its status.", "tags": [ "Web & SEO" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "Short link" } } }, "example": { "url": "https://bit.ly/example" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "final_url": "https://example.com/", "redirects": 1, "final_status": 200 }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/robots-sitemap": { "post": { "operationId": "robotsSitemap", "summary": "Robots & Sitemap Checker", "description": "Read robots.txt rules and detect the sitemap of a domain.", "tags": [ "Web & SEO" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "Site URL" }, "user_agent": { "type": "string", "description": "Default Googlebot" } } }, "example": { "url": "https://example.com" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "robots_found": true, "sitemap_found": false }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/youtube-thumbnail": { "post": { "operationId": "youtubeThumbnail", "summary": "YouTube Thumbnail", "description": "Return thumbnail URLs for every resolution of a YouTube video.", "tags": [ "Web & SEO" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "YouTube video URL" } } }, "example": { "url": "https://youtu.be/dQw4w9WgXcQ" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "video_id": "dQw4w9WgXcQ", "thumbnails": { "maxres": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg" } }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/keyword-density": { "post": { "operationId": "keywordDensity", "summary": "Keyword Density", "description": "Count words and compute keyword density (top 100).", "tags": [ "Web & SEO" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string", "description": "Content to analyze" } } }, "example": { "text": "seo tools for seo experts" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "word_count": 5, "keywords": [ { "word": "seo", "count": 2, "density_percent": 40 } ] }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/readability": { "post": { "operationId": "readability", "summary": "Readability Score", "description": "Estimated Flesch reading ease and grade level for English text.", "tags": [ "Web & SEO" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string", "description": "English text" } } }, "example": { "text": "This is a simple sentence. It is easy to read." } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "flesch_reading_ease": 95.2, "flesch_kincaid_grade": 1.3, "estimated": true }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/utm-builder": { "post": { "operationId": "utmBuilder", "summary": "UTM Builder", "description": "Append UTM campaign parameters to a URL.", "tags": [ "Web & SEO" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url", "source", "medium", "campaign" ], "properties": { "url": { "type": "string", "description": "Landing URL" }, "source": { "type": "string", "description": "utm_source" }, "medium": { "type": "string", "description": "utm_medium" }, "campaign": { "type": "string", "description": "utm_campaign" }, "term": { "type": "string", "description": "utm_term" }, "content": { "type": "string", "description": "utm_content" } } }, "example": { "url": "https://example.com", "source": "newsletter", "medium": "email", "campaign": "launch" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "url": "https://example.com/?utm_source=newsletter&utm_medium=email&utm_campaign=launch" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/slug-generator": { "post": { "operationId": "slugGenerator", "summary": "Slug Generator", "description": "Create clean URL slugs from any text, including accents.", "tags": [ "Web & SEO" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string", "description": "Title" } } }, "example": { "text": "Héllo World 2026!" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "slug": "hello-world-2026" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/disposable-email": { "post": { "operationId": "disposableEmail", "summary": "Disposable Email Check", "description": "Detect temporary/disposable email domains.", "tags": [ "Security" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "description": "Email address" } } }, "example": { "email": "user@mailinator.com" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "disposable": true, "domain": "mailinator.com" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/password-strength": { "post": { "operationId": "passwordStrength", "summary": "Password Strength", "description": "Score a password and return improvement hints. Never stored.", "tags": [ "Security" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "password" ], "properties": { "password": { "type": "string", "description": "1–256 chars" } } }, "example": { "password": "Tr0ub4dor&3" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "score": 3, "label": "strong" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/jwt-decode": { "post": { "operationId": "jwtDecode", "summary": "JWT Decoder", "description": "Decode JWT header and payload (signature is not verified).", "tags": [ "Security" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "description": "JWT" } } }, "example": { "token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjMifQ.sig" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "header": { "alg": "HS256" }, "payload": { "sub": "123" }, "verified": false }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/hash-generator": { "post": { "operationId": "hashGenerator", "summary": "Hash Generator", "description": "MD5, SHA-1, SHA-256 or SHA-512 hex digest.", "tags": [ "Security" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string", "description": "Input" }, "algorithm": { "type": "string", "enum": [ "MD5", "SHA-1", "SHA-256", "SHA-512" ], "description": "Default SHA-256" } } }, "example": { "text": "hello", "algorithm": "SHA-256" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "hash": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/url-safety": { "post": { "operationId": "urlSafety", "summary": "URL Safety Audit", "description": "Heuristic checks for risky URL patterns (no external blacklist).", "tags": [ "Security" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "URL" } } }, "example": { "url": "http://paypa1-login.example.xyz" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "risk": "high", "findings": [ "Lookalike brand", "No HTTPS" ] }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/aes-encryption": { "post": { "operationId": "aesEncryption", "summary": "AES Encrypt / Decrypt", "description": "AES-GCM encryption with a password-derived key.", "tags": [ "Security" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "operation", "text", "password" ], "properties": { "operation": { "type": "string", "enum": [ "encrypt", "decrypt" ], "description": "Mode" }, "text": { "type": "string", "description": "Plain or cipher text" }, "password": { "type": "string", "description": "Min 8 chars" } } }, "example": { "operation": "encrypt", "text": "secret", "password": "my-strong-pass" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "result": "base64-ciphertext..." }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/exif-stripper": { "post": { "operationId": "exifStripper", "summary": "EXIF Stripper", "description": "Remove metadata from a small base64 JPEG/PNG image.", "tags": [ "Security" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "base64" ], "properties": { "base64": { "type": "string", "description": "Image as base64, max 50,000 chars" } } }, "example": { "base64": "/9j/4AAQSkZJRg..." } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "base64": "/9j/4AAQ...", "removed": true }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/csv-to-json": { "post": { "operationId": "csvToJson", "summary": "CSV to JSON", "description": "Parse CSV into JSON rows.", "tags": [ "Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "csv" ], "properties": { "csv": { "type": "string", "description": "CSV text" }, "header": { "type": "boolean", "description": "Default true" }, "delimiter": { "type": "string", "enum": [ ", ; \\t" ], "description": "Default ," } } }, "example": { "csv": "name,age\nAli,30" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "rows": [ { "name": "Ali", "age": "30" } ] }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/json-to-csv": { "post": { "operationId": "jsonToCsv", "summary": "JSON to CSV", "description": "Convert flat JSON rows to CSV (formula injection safe).", "tags": [ "Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "rows" ], "properties": { "rows": { "type": "array", "items": { "type": "object" }, "description": "Max 2000 rows" } } }, "example": { "rows": [ { "name": "Ali", "age": 30 } ] } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "csv": "name,age\r\nAli,30" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/markdown-to-html": { "post": { "operationId": "markdownToHtml", "summary": "Markdown to HTML", "description": "Render Markdown to sanitized HTML.", "tags": [ "Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "markdown" ], "properties": { "markdown": { "type": "string", "description": "Markdown" } } }, "example": { "markdown": "# Hello" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "html": "

Hello

" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/html-entities": { "post": { "operationId": "htmlEntities", "summary": "HTML Entities", "description": "Encode or decode HTML entities.", "tags": [ "Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string", "description": "Input" }, "operation": { "type": "string", "enum": [ "encode", "decode" ], "description": "Default encode" } } }, "example": { "text": "Hi" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "text": "<b>Hi</b>" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/yaml-to-json": { "post": { "operationId": "yamlToJson", "summary": "YAML to JSON", "description": "Parse YAML safely (no aliases or custom tags).", "tags": [ "Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "yaml" ], "properties": { "yaml": { "type": "string", "description": "YAML" } } }, "example": { "yaml": "name: Ali\nage: 30" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "data": { "name": "Ali", "age": 30 } }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/curl-to-code": { "post": { "operationId": "curlToCode", "summary": "cURL to Code", "description": "Convert a cURL command to fetch and axios code. Never executed.", "tags": [ "Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "command" ], "properties": { "command": { "type": "string", "description": "Single curl command" } } }, "example": { "command": "curl -X POST https://api.example.com -H 'Content-Type: application/json' -d '{\"a\":1}'" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "fetch": "fetch(...)", "axios": "axios(...)", "executed": false }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/json-to-typescript": { "post": { "operationId": "jsonToTypescript", "summary": "JSON to TypeScript", "description": "Generate a TypeScript type from sample JSON.", "tags": [ "Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "description": "Sample JSON" }, "name": { "type": "string", "description": "Type name, default Root" } } }, "example": { "data": { "id": 1, "tags": [ "a" ] }, "name": "User" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "typescript": "export type User = { \"id\": number; \"tags\": Array; };" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/data-cleaner": { "post": { "operationId": "dataCleaner", "summary": "Data Cleaner", "description": "Trim lines, remove empty lines and duplicates.", "tags": [ "Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string", "description": "Lines" }, "case_sensitive": { "type": "boolean", "description": "Default true" }, "remove_empty": { "type": "boolean", "description": "Default true" } } }, "example": { "text": "a\nA\n\na", "case_sensitive": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "text": "a", "line_count": 1 }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/json-diff": { "post": { "operationId": "jsonDiff", "summary": "JSON Diff", "description": "JSON-Pointer style differences between two values.", "tags": [ "Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "left", "right" ], "properties": { "left": { "description": "Original" }, "right": { "description": "Changed" } } }, "example": { "left": { "a": 1 }, "right": { "a": 2, "b": 3 } } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "changes": [ { "op": "replace", "path": "/a", "before": 1, "value": 2 }, { "op": "add", "path": "/b", "value": 3 } ] }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/sql-formatter": { "post": { "operationId": "sqlFormatter", "summary": "SQL Formatter", "description": "Pretty-print SQL for several dialects.", "tags": [ "Data" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "sql" ], "properties": { "sql": { "type": "string", "description": "SQL" }, "dialect": { "type": "string", "enum": [ "sql", "postgresql", "mysql", "sqlite", "transactsql" ], "description": "Default sql" } } }, "example": { "sql": "select id,name from users where id=1" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "sql": "select\n id,\n name\nfrom\n users\nwhere\n id = 1" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/vat-calculator": { "post": { "operationId": "vatCalculator", "summary": "VAT Calculator", "description": "Compute net, tax and gross amounts.", "tags": [ "Content" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "rate" ], "properties": { "amount": { "type": "number", "description": "≥ 0" }, "rate": { "type": "number", "description": "0–100 %" }, "included": { "type": "boolean", "description": "Amount already includes VAT" } } }, "example": { "amount": 100, "rate": 15 } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "net": 100, "tax": 15, "gross": 115, "rate": 15 }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/bionic-reading": { "post": { "operationId": "bionicReading", "summary": "Bionic Reading", "description": "Bold the first half of each word as safe HTML.", "tags": [ "Content" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string", "description": "Text" } } }, "example": { "text": "Read faster" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "html": "Read faster" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/number-to-words": { "post": { "operationId": "numberToWords", "summary": "Number to Words", "description": "Spell out integers in English.", "tags": [ "Content" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "number" ], "properties": { "number": { "type": "integer", "description": "±999,999,999,999" } } }, "example": { "number": 1250 } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "words": "one thousand, two hundred fifty" }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/currency-converter": { "post": { "operationId": "currencyConverter", "summary": "Currency Converter", "description": "Convert between ISO currencies using daily reference rates.", "tags": [ "Content" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "from", "to" ], "properties": { "amount": { "type": "number", "description": "Amount" }, "from": { "type": "string", "description": "ISO code e.g. USD" }, "to": { "type": "string", "description": "ISO code e.g. EUR" } } }, "example": { "amount": 10, "from": "USD", "to": "EUR" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "amount": 10, "from": "USD", "to": "EUR", "result": 9.2 }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/uuid-generator": { "post": { "operationId": "uuidGenerator", "summary": "UUID Generator", "description": "Generate 1–100 random UUID v4 values.", "tags": [ "Generators" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "count": { "type": "integer", "description": "Default 1" } } }, "example": { "count": 2 } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "uuids": [ "6f1c...", "a92b..." ] }, "request_id": "req_123" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Remote service error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/qr-code": { "post": { "operationId": "qrCode", "summary": "QR Code", "description": "Generate a QR code as SVG.", "tags": [ "Generators" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string", "description": "Max 2000 chars" }, "error_correction": { "type": "string", "enum": [ "L", "M", "Q", "H" ], "description": "Default M" } } }, "example": { "text": "https://smartsupertools.com" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Success" }, "example": { "success": true, "data": { "svg": "