Download an image and add a solid border before returning the transformed file.

Parameters

Query Parameters

All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.

Responses

"Binary image bytes (PNG/JPG/WEBP)."

Examples

"GET /img/add-border?url=https://example.com/cat.jpg&color=%23ff00ff&width=30&ak=demo"

"Binary PNG (bordered cat image)."

"GET /img/add-border?url=https://example.com/cat.jpg&dryrun=1"

{
  "ok": true,
  "data": {
    "source_url": "https://example.com/cat.jpg",
    "border_width": 20,
    "color": "#000000",
    "format": "png"
  },
  "meta": {
    "dryrun": true
  }
}

Test Contracts

[
  {
    "name": "dryrun_metadata",
    "method": "GET",
    "params": {
      "url": "https://example.com/a.png",
      "dryrun": true
    },
    "expect": {
      "color": "#000000"
    }
  },
  {
    "name": "named_color_resolves",
    "method": "GET",
    "params": {
      "url": "https://example.com/a.png",
      "color": "purple",
      "dryrun": true
    },
    "expect": {
      "color": "#800080"
    }
  },
  {
    "name": "invalid_color",
    "method": "GET",
    "params": {
      "url": "https://example.com/a.png",
      "color": "!!!"
    },
    "expect_status": 400
  }
]