url-encode.md

• URL Encode/Decode — REST API
  • Request
  • Success response (200)
  • Error response (400)

URL Encode/Decode — REST API

POST /api/v1/tools/url-encode

Request

{ "input": "hello world & friends", "options": { "decode": false, "component": "query" } }

options.decode: false (default, encode) or true (decode). options.component: query (default), path, or full.

Success response (200)

{
  "success": true,
  "data": { "output": "hello+world+%26+friends" },
  "meta": { "tool": "url-encode", "duration_ms": 0.01 }
}

Error response (400)

{ "success": false, "error": { "code": "INVALID_ENCODING", "message": "invalid URL escape \"%ZZ\"" } }

Workflow

flowchart LR
    A[Client: CLI / Web / REST] -->|input, decode, component| B[handlers.Wrap generic handler]
    B --> C[urlencode.Process]
    C --> D{component}
    D -->|query| E[url.QueryEscape/Unescape]
    D -->|path| F[url.PathEscape/Unescape]
    D -->|full| G[url.Parse / QueryUnescape]
    E --> H[shared success envelope]
    F --> H
    G --> H
    E -->|malformed| I[apperr.Error 400 INVALID_ENCODING] --> J[shared error envelope]

Loading