openapi: 3.0.3 info: title: Developer Toolkit API description: | 37+ dev tools in one API: email validation, hash (MD5/SHA), QR codes, JWT decode, regex, JSON tools, UUID, validators & more. No per-endpoint fees. ## Why Developer Toolkit API? - **37+ endpoints** covering email, text, hashing, encoding, validation, generation, JSON/CSV, parsing, QR codes, and IP geolocation - **Ultra-fast**: Sub-50ms response times worldwide (Cloudflare edge, 300+ locations) - **One subscription** instead of paying for 10+ separate APIs - **Simple pricing**: No hidden overage fees, no per-endpoint charges ## Categories - Email Tools (4 endpoints) - Text Processing (7 endpoints) - Validators (4 endpoints) - Hashing & Crypto (4 endpoints) - Encoding / Decoding (3 endpoints) - JSON & Data (4 endpoints) - Generators (4 endpoints) - Parsers (3 endpoints) - QR Code (1 endpoint) - Convert (2 endpoints) - JWT (1 endpoint) - IP Geolocation (1 endpoint) version: 1.0.0 contact: name: Developer Toolkit API url: https://developer-toolkit-api.contactjccoaching.workers.dev license: name: Proprietary servers: - url: https://developer-toolkit-api.contactjccoaching.workers.dev description: Production server (Cloudflare Edge) tags: - name: Email description: Email validation, disposable detection, MX lookup, typo correction - name: Text description: Slugify, case conversion, word count, readability, extraction, similarity, markdown - name: Validators description: URL, credit card, IBAN, phone number validation - name: Hashing description: MD5, SHA-256, SHA-512, HMAC signature - name: Encoding description: Base64, URL encoding, HTML entities - name: JSON & Data description: JSON validate/diff, CSV to JSON, JSON to CSV - name: Generators description: UUID, password, Lorem Ipsum, placeholder image - name: Parsers description: Cron expression, regex tester, User-Agent parser - name: QR Code description: SVG QR code generation - name: Convert description: Color and datetime conversion - name: JWT description: JWT decode without verification - name: IP description: IP geolocation and network info paths: # ========================================== # EMAIL TOOLS # ========================================== /email/validate: get: summary: Validate Email description: Full email validation combining format check, MX record lookup, disposable domain detection, free provider detection, and typo suggestions. operationId: emailValidate tags: [Email] parameters: - name: email in: query required: true schema: type: string description: Email address to validate example: test@gmial.com responses: '200': description: Validation result content: application/json: schema: type: object properties: email: type: string valid_format: type: boolean mx_records: type: array items: type: object has_mx: type: boolean is_disposable: type: boolean is_free_provider: type: boolean typo_suggestion: type: string nullable: true score: type: number example: email: "test@gmial.com" valid_format: true mx_records: [] has_mx: false is_disposable: false is_free_provider: false typo_suggestion: "test@gmail.com" score: 0.5 /email/disposable: get: summary: Check Disposable Email description: Quick check if a domain is a disposable/temporary email provider. Database of 5,000+ known disposable domains. operationId: emailDisposable tags: [Email] parameters: - name: domain in: query required: true schema: type: string description: Domain to check example: guerrillamail.com responses: '200': description: Disposable check result content: application/json: schema: type: object properties: domain: type: string is_disposable: type: boolean example: domain: "guerrillamail.com" is_disposable: true /email/mx: get: summary: MX Record Lookup description: Look up MX (mail exchange) records for a domain via DNS. operationId: emailMx tags: [Email] parameters: - name: domain in: query required: true schema: type: string description: Domain to lookup example: gmail.com responses: '200': description: MX records content: application/json: schema: type: object properties: domain: type: string records: type: array items: type: object properties: priority: type: integer exchange: type: string has_mx: type: boolean example: domain: "gmail.com" records: - priority: 5 exchange: "gmail-smtp-in.l.google.com." - priority: 10 exchange: "alt1.gmail-smtp-in.l.google.com." - priority: 20 exchange: "alt2.gmail-smtp-in.l.google.com." has_mx: true /email/typo: get: summary: Email Typo Suggestion description: Suggest corrections for common email domain typos (gmial.com, yaho.com, etc.). operationId: emailTypo tags: [Email] parameters: - name: email in: query required: true schema: type: string description: Email to check for typos example: john@yaho.com responses: '200': description: Typo suggestion content: application/json: schema: type: object properties: email: type: string domain: type: string suggestion: type: string nullable: true suggested_email: type: string nullable: true example: email: "john@yaho.com" domain: "yaho.com" suggestion: "yahoo.com" suggested_email: "john@yahoo.com" # ========================================== # TEXT PROCESSING # ========================================== /text/slugify: get: summary: Slugify Text description: Convert text to a URL-safe slug. Unicode-safe, accent-aware. operationId: textSlugify tags: [Text] parameters: - name: text in: query required: true schema: type: string description: Text to slugify example: "Hello World élève" responses: '200': description: Slugified text content: application/json: schema: type: object properties: original: type: string slug: type: string example: original: "Hello World élève" slug: "hello-world-eleve" /text/case: get: summary: Convert Text Case description: Convert text between different cases (camelCase, PascalCase, snake_case, kebab-case, UPPER, lower, Title Case). operationId: textCase tags: [Text] parameters: - name: text in: query required: true schema: type: string description: Text to convert example: "hello world test" - name: to in: query required: false schema: type: string enum: [camel, pascal, snake, kebab, upper, lower, title] default: camel description: Target case responses: '200': description: Converted text content: application/json: schema: type: object properties: original: type: string converted: type: string case: type: string example: original: "hello world test" converted: "HelloWorldTest" case: "pascal" /text/count: get: summary: Word & Character Count description: Count words, characters, sentences, paragraphs and estimate reading time. operationId: textCount tags: [Text] parameters: - name: text in: query required: true schema: type: string description: Text to analyze example: "Hello world. This is a test." responses: '200': description: Text statistics content: application/json: schema: type: object properties: text: type: string characters: type: integer characters_no_spaces: type: integer words: type: integer sentences: type: integer paragraphs: type: integer reading_time_minutes: type: integer example: text: "Hello world. This is a test." characters: 27 characters_no_spaces: 23 words: 6 sentences: 2 paragraphs: 1 reading_time_minutes: 1 /text/readability: get: summary: Readability Analysis description: Analyze text readability using 5 standard formulas (Flesch-Kincaid, Gunning Fog, Coleman-Liau, SMOG, ARI). Minimum ~50 words recommended. operationId: textReadability tags: [Text] parameters: - name: text in: query required: true schema: type: string description: Text to analyze (min ~50 words recommended) responses: '200': description: Readability scores content: application/json: schema: type: object properties: words: type: integer sentences: type: integer syllables: type: integer scores: type: object properties: flesch_kincaid: type: number gunning_fog: type: number coleman_liau: type: number smog: type: number automated_readability_index: type: number interpretation: type: string example: words: 150 sentences: 8 syllables: 230 scores: flesch_kincaid: 62.3 gunning_fog: 10.2 coleman_liau: 9.8 smog: 8.5 automated_readability_index: 8.1 interpretation: "Standard (8th-9th grade)" /text/extract: get: summary: Extract from Text description: Extract emails, URLs, phone numbers, hashtags, or @mentions from text. operationId: textExtract tags: [Text] parameters: - name: text in: query required: true schema: type: string description: Text to extract from example: "Contact john@test.com or visit https://example.com" - name: type in: query required: false schema: type: string enum: [emails, urls, phones, hashtags, mentions, all] default: all description: What to extract responses: '200': description: Extracted entities content: application/json: schema: type: object properties: emails: type: array items: type: string urls: type: array items: type: string phones: type: array items: type: string hashtags: type: array items: type: string mentions: type: array items: type: string example: emails: ["john@test.com"] urls: ["https://example.com"] phones: [] hashtags: [] mentions: [] /text/similarity: get: summary: Text Similarity description: Compare two strings using Levenshtein distance and Jaro-Winkler similarity. operationId: textSimilarity tags: [Text] parameters: - name: a in: query required: true schema: type: string description: First string example: kitten - name: b in: query required: true schema: type: string description: Second string example: sitting responses: '200': description: Similarity scores content: application/json: schema: type: object properties: a: type: string b: type: string levenshtein_distance: type: integer jaro_winkler: type: number similarity_percent: type: number example: a: "kitten" b: "sitting" levenshtein_distance: 3 jaro_winkler: 0.746 similarity_percent: 57.1 /text/markdown: post: summary: Markdown to HTML description: Convert Markdown to HTML. operationId: textMarkdown tags: [Text] requestBody: required: true content: application/json: schema: type: object required: [markdown] properties: markdown: type: string description: Markdown text to convert example: markdown: "# Hello\n\nThis is **bold** and *italic*.\n\n- Item 1\n- Item 2" responses: '200': description: Converted HTML content: application/json: schema: type: object properties: markdown: type: string html: type: string example: markdown: "# Hello\n\nThis is **bold** and *italic*.\n\n- Item 1\n- Item 2" html: "

Hello

This is bold and italic.

Item 1

Item 2

" # ========================================== # VALIDATORS # ========================================== /validate/url: get: summary: Validate URL description: Validate a URL and parse its components (protocol, hostname, port, path, query, hash). operationId: validateUrl tags: [Validators] parameters: - name: url in: query required: true schema: type: string description: URL to validate example: "https://example.com:8080/path?q=test#section" responses: '200': description: URL validation result content: application/json: schema: type: object properties: url: type: string valid: type: boolean protocol: type: string hostname: type: string port: type: string pathname: type: string search: type: string hash: type: string example: url: "https://example.com:8080/path?q=test#section" valid: true protocol: "https" hostname: "example.com" port: "8080" pathname: "/path" search: "?q=test" hash: "#section" /validate/creditcard: get: summary: Validate Credit Card description: Validate a credit card number using the Luhn algorithm and detect card type (Visa, MasterCard, Amex, Discover, JCB, Diners, Maestro). operationId: validateCreditcard tags: [Validators] parameters: - name: number in: query required: true schema: type: string description: Credit card number (spaces and dashes stripped automatically) example: "4111111111111111" responses: '200': description: Card validation result content: application/json: schema: type: object properties: number: type: string valid: type: boolean type: type: string digits: type: integer example: number: "4111 **** **** 1111" valid: true type: "visa" digits: 16 /validate/iban: get: summary: Validate IBAN description: Validate an IBAN (International Bank Account Number) using mod-97 check. Supports 60+ countries. operationId: validateIban tags: [Validators] parameters: - name: iban in: query required: true schema: type: string description: IBAN to validate example: "FR7630006000011234567890189" responses: '200': description: IBAN validation result content: application/json: schema: type: object properties: iban: type: string valid: type: boolean country_code: type: string check_digits: type: string bban: type: string formatted: type: string example: iban: "FR7630006000011234567890189" valid: true country_code: "FR" check_digits: "76" bban: "30006000011234567890189" formatted: "FR76 3000 6000 0112 3456 7890 189" /validate/phone: get: summary: Validate Phone Number description: Validate a phone number in E.164 format and detect country. Supports 200+ countries. operationId: validatePhone tags: [Validators] parameters: - name: number in: query required: true schema: type: string description: Phone number (E.164 format recommended, e.g. +33612345678) example: "+33612345678" responses: '200': description: Phone validation result content: application/json: schema: type: object properties: input: type: string cleaned: type: string valid_e164: type: boolean country_code: type: string digits: type: integer example: input: "+33612345678" cleaned: "+33612345678" valid_e164: true country_code: "FR" digits: 11 # ========================================== # HASHING & CRYPTO # ========================================== /hash/md5: get: summary: MD5 Hash description: Generate MD5 hash of text. operationId: hashMd5 tags: [Hashing] parameters: - name: text in: query required: true schema: type: string description: Text to hash example: hello responses: '200': description: MD5 hash content: application/json: schema: $ref: '#/components/schemas/HashResponse' example: text: "hello" algorithm: "MD5" hash: "5d41402abc4b2a76b9719d911017c592" /hash/sha256: get: summary: SHA-256 Hash description: Generate SHA-256 hash of text. operationId: hashSha256 tags: [Hashing] parameters: - name: text in: query required: true schema: type: string description: Text to hash example: hello responses: '200': description: SHA-256 hash content: application/json: schema: $ref: '#/components/schemas/HashResponse' example: text: "hello" algorithm: "SHA-256" hash: "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824" /hash/sha512: get: summary: SHA-512 Hash description: Generate SHA-512 hash of text. operationId: hashSha512 tags: [Hashing] parameters: - name: text in: query required: true schema: type: string description: Text to hash example: hello responses: '200': description: SHA-512 hash content: application/json: schema: $ref: '#/components/schemas/HashResponse' example: text: "hello" algorithm: "SHA-512" hash: "9b71d224bd62f3785d96d46ad3ea3d73319bfbc2890caadae2dff72519673ca72323c3d99ba5c11d7c7acc6e14b8c5da0c4663475c2e5c3adef46f73bcdec043" /hash/hmac: get: summary: HMAC Signature description: Generate HMAC signature using SHA-256, SHA-512, or SHA-1. operationId: hashHmac tags: [Hashing] parameters: - name: text in: query required: true schema: type: string description: Text to sign example: hello - name: key in: query required: true schema: type: string description: Secret key example: mysecret - name: algo in: query required: false schema: type: string enum: [sha256, sha512, sha1] default: sha256 description: Algorithm responses: '200': description: HMAC signature content: application/json: schema: $ref: '#/components/schemas/HashResponse' example: text: "hello" algorithm: "HMAC-SHA-256" hash: "f09399f0c446d84b31a080e57ec483392d41e6f512f3e7ada5027abbcd358c2a" # ========================================== # ENCODING / DECODING # ========================================== /encode/base64: get: summary: Base64 Encode/Decode description: Encode or decode Base64. Unicode-safe. operationId: encodeBase64 tags: [Encoding] parameters: - name: text in: query required: true schema: type: string description: Text to encode/decode example: Hello World - name: action in: query required: false schema: type: string enum: [encode, decode] default: encode description: Action to perform responses: '200': description: Base64 result content: application/json: schema: type: object properties: original: type: string encoded: type: string action: type: string example: original: "Hello World" encoded: "SGVsbG8gV29ybGQ=" action: "encode" /encode/url: get: summary: URL Encode/Decode description: URL encode or decode text. operationId: encodeUrl tags: [Encoding] parameters: - name: text in: query required: true schema: type: string description: Text to encode/decode example: hello world - name: action in: query required: false schema: type: string enum: [encode, decode] default: encode description: Action to perform responses: '200': description: URL encoding result content: application/json: schema: type: object properties: original: type: string encoded: type: string action: type: string example: original: "hello world" encoded: "hello%20world" action: "encode" /html/entities: get: summary: HTML Entities Encode/Decode description: Encode or decode HTML entities. operationId: htmlEntities tags: [Encoding] parameters: - name: text in: query required: true schema: type: string description: Text to encode/decode example: '' - name: action in: query required: false schema: type: string enum: [encode, decode] default: encode description: Action to perform responses: '200': description: HTML entities result content: application/json: schema: type: object properties: original: type: string result: type: string action: type: string example: original: '' result: '<script>alert("XSS")</script>' action: "encode" # ========================================== # JSON & DATA # ========================================== /json/validate: get: summary: Validate & Format JSON description: Validate and format JSON. Detects syntax errors with position info. operationId: jsonValidate tags: [JSON & Data] parameters: - name: json in: query required: true schema: type: string description: JSON string to validate example: '{"name":"test","version":1}' responses: '200': description: JSON validation result content: application/json: schema: type: object properties: valid: type: boolean formatted: type: string keys: type: integer type: type: string example: valid: true formatted: "{\n \"name\": \"test\",\n \"version\": 1\n}" keys: 2 type: "object" /json/diff: post: summary: JSON Diff description: Compare two JSON objects and return differences (added, removed, changed). operationId: jsonDiff tags: [JSON & Data] requestBody: required: true content: application/json: schema: type: object required: [a, b] properties: a: type: object description: First JSON object b: type: object description: Second JSON object example: a: {"name": "old", "version": 1} b: {"name": "new", "version": 2, "added": true} responses: '200': description: Differences content: application/json: schema: type: object properties: equal: type: boolean changes: type: array items: type: object properties: path: type: string type: type: string from: {} to: {} value: {} total_changes: type: integer example: equal: false changes: - path: "name" type: "changed" from: "old" to: "new" - path: "version" type: "changed" from: 1 to: 2 - path: "added" type: "added" value: true total_changes: 3 /csv/to-json: post: summary: CSV to JSON description: Convert CSV data to JSON array. operationId: csvToJson tags: [JSON & Data] requestBody: required: true content: application/json: schema: type: object required: [csv] properties: csv: type: string description: CSV data with header row example: csv: "name,age,city\nAlice,30,Paris\nBob,25,London" responses: '200': description: JSON array content: application/json: schema: type: object properties: rows: type: integer columns: type: array items: type: string data: type: array items: type: object example: rows: 2 columns: ["name", "age", "city"] data: - name: "Alice" age: "30" city: "Paris" - name: "Bob" age: "25" city: "London" /json/to-csv: post: summary: JSON to CSV description: Convert a JSON array to CSV format. operationId: jsonToCsv tags: [JSON & Data] requestBody: required: true content: application/json: schema: type: object required: [json] properties: json: type: array items: type: object description: JSON array to convert example: json: - name: "Alice" age: 30 - name: "Bob" age: 25 responses: '200': description: CSV data content: application/json: schema: type: object properties: csv: type: string rows: type: integer columns: type: array items: type: string example: csv: "name,age\nAlice,30\nBob,25" rows: 2 columns: ["name", "age"] # ========================================== # GENERATORS # ========================================== /generate/uuid: get: summary: Generate UUID v4 description: Generate cryptographically secure UUID v4. Batch generation up to 100. operationId: generateUuid tags: [Generators] parameters: - name: count in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 1 description: Number of UUIDs to generate responses: '200': description: Generated UUIDs content: application/json: schema: type: object properties: count: type: integer uuids: type: array items: type: string example: count: 3 uuids: - "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d" - "f6e5d4c3-b2a1-4908-8765-432109876543" - "12345678-abcd-4ef0-9876-543210fedcba" /generate/password: get: summary: Generate Password description: Generate cryptographically secure passwords with configurable length, charset, and exclusions. Includes entropy calculation. operationId: generatePassword tags: [Generators] parameters: - name: length in: query required: false schema: type: integer minimum: 4 maximum: 128 default: 16 description: Password length - name: count in: query required: false schema: type: integer minimum: 1 maximum: 20 default: 1 description: Number of passwords - name: uppercase in: query required: false schema: type: boolean default: true description: Include A-Z - name: lowercase in: query required: false schema: type: boolean default: true description: Include a-z - name: numbers in: query required: false schema: type: boolean default: true description: Include 0-9 - name: symbols in: query required: false schema: type: boolean default: false description: "Include !@#$%^&*..." - name: exclude in: query required: false schema: type: string description: Characters to exclude responses: '200': description: Generated password content: application/json: schema: type: object properties: password: type: string length: type: integer charset_size: type: integer entropy_bits: type: number example: password: "EszK$G5dml5j1_+4K4;V" length: 20 charset_size: 88 entropy_bits: 129.2 /generate/lorem: get: summary: Lorem Ipsum Generator description: Generate Lorem Ipsum text in 6 languages (EN, FR, ES, DE, PT, IT). Available in text or HTML format. operationId: generateLorem tags: [Generators] parameters: - name: paragraphs in: query required: false schema: type: integer minimum: 1 maximum: 20 default: 3 description: Number of paragraphs - name: lang in: query required: false schema: type: string enum: [en, fr, es, de, pt, it] default: en description: Language - name: format in: query required: false schema: type: string enum: [text, html] default: text description: Output format responses: '200': description: Lorem ipsum text content: application/json: schema: type: object properties: paragraphs: type: integer lang: type: string format: type: string text: type: string /placeholder: get: summary: Placeholder Image description: Generate a placeholder image (SVG) with custom size, colors, and text. operationId: placeholder tags: [Generators] parameters: - name: w in: query required: false schema: type: integer minimum: 10 maximum: 4000 default: 400 description: Width in pixels - name: h in: query required: false schema: type: integer minimum: 10 maximum: 4000 default: 300 description: Height in pixels - name: bg in: query required: false schema: type: string default: cccccc description: Background color (hex, no #) - name: color in: query required: false schema: type: string default: "666666" description: Text color (hex, no #) - name: text in: query required: false schema: type: string description: Custom text overlay (defaults to WxH) responses: '200': description: SVG placeholder image content: image/svg+xml: schema: type: string # ========================================== # PARSERS # ========================================== /cron/parse: get: summary: Parse Cron Expression description: Parse a cron expression into human-readable format with next scheduled runs. operationId: cronParse tags: [Parsers] parameters: - name: expr in: query required: true schema: type: string description: "Cron expression (e.g. */5 * * * *)" example: "*/5 * * * *" - name: count in: query required: false schema: type: integer minimum: 1 maximum: 20 default: 5 description: Number of next runs to show responses: '200': description: Parsed cron content: application/json: schema: type: object properties: expression: type: string description: type: string next_runs: type: array items: type: string format: date-time example: expression: "*/5 * * * *" description: "Every 5 minutes" next_runs: - "2026-03-01T12:05:00.000Z" - "2026-03-01T12:10:00.000Z" - "2026-03-01T12:15:00.000Z" /regex/test: get: summary: Regex Tester description: Test a regular expression against text and get all matches with positions. operationId: regexTest tags: [Parsers] parameters: - name: pattern in: query required: true schema: type: string description: Regex pattern example: "\\d+" - name: text in: query required: true schema: type: string description: Text to test against example: "abc 123 def 456" - name: flags in: query required: false schema: type: string default: g description: "Regex flags (g, i, m, s)" responses: '200': description: Regex matches content: application/json: schema: type: object properties: pattern: type: string flags: type: string matches: type: array items: type: object properties: match: type: string index: type: integer count: type: integer example: pattern: "\\d+" flags: "g" matches: - match: "123" index: 4 - match: "456" index: 12 count: 2 /useragent/parse: get: summary: Parse User-Agent description: Parse a User-Agent string to detect browser, OS, and device type. operationId: useragentParse tags: [Parsers] parameters: - name: ua in: query required: true schema: type: string description: User-Agent string to parse example: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/120.0.0.0 Safari/537.36" responses: '200': description: Parsed User-Agent content: application/json: schema: type: object properties: browser: type: object properties: name: type: string version: type: string os: type: object properties: name: type: string version: type: string device: type: object properties: type: type: string is_bot: type: boolean example: browser: name: "Chrome" version: "120.0.0.0" os: name: "Windows" version: "10" device: type: "desktop" is_bot: false # ========================================== # QR CODE # ========================================== /qr: get: summary: Generate QR Code description: Generate a QR code as SVG image with custom colors, size, and error correction level. Returns SVG by default, or JSON with data URI. operationId: qrGenerate tags: [QR Code] parameters: - name: text in: query required: true schema: type: string description: Text or URL to encode example: "https://example.com" - name: size in: query required: false schema: type: integer minimum: 50 maximum: 2000 default: 300 description: Image size in pixels - name: color in: query required: false schema: type: string default: "000000" description: Foreground color (hex, no #) - name: bg in: query required: false schema: type: string default: ffffff description: Background color (hex, no #) - name: ecl in: query required: false schema: type: string enum: [L, M, Q, H] default: M description: "Error correction level: L(7%), M(15%), Q(25%), H(30%)" - name: format in: query required: false schema: type: string enum: [svg, json] default: svg description: "Output format: svg (image) or json (with data URI)" responses: '200': description: QR code content: image/svg+xml: schema: type: string application/json: schema: type: object properties: text: type: string size: type: integer color: type: string background: type: string ecl: type: string svg_data_uri: type: string svg: type: string # ========================================== # CONVERT # ========================================== /color/convert: get: summary: Color Converter description: "Convert colors between HEX, RGB, and HSL formats. Accepts any format as input." operationId: colorConvert tags: [Convert] parameters: - name: color in: query required: true schema: type: string description: "Color value (e.g. #ff5733, rgb(255,87,51), hsl(11,100%,60%))" example: "#ff5733" responses: '200': description: All color formats content: application/json: schema: type: object properties: hex: type: string rgb: type: object properties: r: type: integer g: type: integer b: type: integer hsl: type: object properties: h: type: integer s: type: integer l: type: integer css_rgb: type: string css_hsl: type: string example: hex: "#ff5733" rgb: {r: 255, g: 87, b: 51} hsl: {h: 11, s: 100, l: 60} css_rgb: "rgb(255, 87, 51)" css_hsl: "hsl(11, 100%, 60%)" /datetime/convert: get: summary: DateTime Converter description: Convert between Unix timestamps and ISO dates. Provide either ts or date, not both. operationId: datetimeConvert tags: [Convert] parameters: - name: ts in: query required: false schema: type: integer description: Unix timestamp (seconds) example: 1709312400 - name: date in: query required: false schema: type: string description: ISO 8601 date string responses: '200': description: Converted datetime content: application/json: schema: type: object properties: timestamp: type: integer iso: type: string format: date-time utc: type: string local_offset: type: string day_of_week: type: string example: timestamp: 1709312400 iso: "2024-03-01T15:00:00.000Z" utc: "Fri, 01 Mar 2024 15:00:00 GMT" local_offset: "+0100" day_of_week: "Friday" # ========================================== # JWT # ========================================== /jwt/decode: get: summary: Decode JWT description: Decode a JSON Web Token without signature verification. Shows header, payload, expiration status, and issued date. operationId: jwtDecode tags: [JWT] parameters: - name: token in: query required: true schema: type: string description: JWT string example: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" responses: '200': description: Decoded JWT content: application/json: schema: type: object properties: header: type: object payload: type: object expired: type: boolean issued_at: type: string format: date-time example: header: {alg: "HS256", typ: "JWT"} payload: {sub: "1234567890", name: "John Doe", iat: 1516239022} expired: false issued_at: "2018-01-18T01:30:22.000Z" # ========================================== # IP GEOLOCATION # ========================================== /ip: get: summary: IP Geolocation description: Get the requester's IP address with full geolocation (country, region, city, coordinates, timezone), network info (ASN, organization), and country enrichment (currency, language, flag, phone code). operationId: ipGeo tags: [IP] responses: '200': description: IP geolocation data content: application/json: schema: type: object properties: ip: type: string location: type: object properties: country: type: string country_name: type: string region: type: string region_code: type: string city: type: string latitude: type: string longitude: type: string timezone: type: string postal_code: type: string continent: type: string is_eu: type: boolean network: type: object properties: asn: type: integer organization: type: string colo: type: string country_info: type: object properties: currency: type: string language: type: string flag: type: string phone_code: type: string example: ip: "2a01:e0a:ade:9ab0:5d8b:4217:72f3:1c4" location: country: "FR" country_name: "France" region: "Brittany" region_code: "BRE" city: "Fouesnant" latitude: "47.89342" longitude: "-4.0124" timezone: "Europe/Paris" postal_code: "29170" continent: "EU" is_eu: true network: asn: 12322 organization: "Free SAS" colo: "CDG" country_info: currency: "EUR" language: "fr" flag: "\U0001F1EB\U0001F1F7" phone_code: "+33" components: schemas: HashResponse: type: object properties: text: type: string algorithm: type: string hash: type: string