▣ SMART GENERATION

Generate Stacked Graph API

Hosted on ApyHub

What it does

Stacked Bar Chart Generator creates stacked bar chart images from structured chart data. Send a title, a data array, and optional styling options, and get back either a pre-signed chart URL or a binary image depending on the endpoint you use.

Each data item includes a name and an array of values. Each value can include a label, numeric value, and optional 6-character hex color. You can also set the chart theme to light or dark, and adjust canvas size, axis font settings, spacing, bar width, title styling, canvas color, and background padding through the options object.

Use it when you need to render quarterly revenue breakdowns, compare category totals, or generate dashboard graphics from application data. The structure is simple enough to build charts from analytics output, reporting pipelines, or admin tools without assembling the image yourself.

Stacked Bar Chart Generator is useful when your app needs consistent chart output with controlled layout and colors. The /link endpoint returns a pre-signed URL in data, while /download returns the image directly as binary.

▣ ENDPOINT 01 / 02

POST

Generate stacked bar chart link

http://localhost:8080/apyhub/generate-stacked-bar-chart/link

QUICKSTARTGUIDE

Quickstart

Generate a stacked bar chart and get back a pre-signed image URL.

curl -X POST "http://localhost:8080/apyhub/generate-stacked-bar-chart/link?output=quarterly-revenue-cost-stacked-chart" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quarterly Revenue and Cost",
    "data": [
      {
        "name": "Q1",
        "width": 56,
        "values": [
          { "color": "3B82F6", "label": "Revenue", "value": 100000 },
          { "color": "EF4444", "label": "Cost", "value": 62000 }
        ]
      },
      {
        "name": "Q2",
        "width": 56,
        "values": [
          { "color": "3B82F6", "label": "Revenue", "value": 118000 },
          { "color": "EF4444", "label": "Cost", "value": 69000 }
        ]
      }
    ]
  }'

What you'll get back

Returns a JSON object with a data string field containing a pre-signed URI for the generated chart image.

{
  "data": "https://example.com/generated/charts/chart.png"
}

TRY ITLIVE · 60 ATOMS

Loading playground…

About this endpoint

What it does

Generates a link for a stacked bar chart from the chart configuration in the request body. The response returns a JSON object containing a data URI string for the generated chart image.

Request Body

Parameter	Type	Mandatory	Description
title	String	Yes	Chart title.
data	Object Array	Yes	Stacked bar chart groups. Each item must include `name` and `values`; `width` is optional.
data[].name	String	Yes	Group label for the bar category, such as a quarter name.
data[].width	Integer	No	Bar width in pixels. Minimum: 1.
data[].values	Object Array	Yes	Stacked segments for the group. Each item must include `label` and `value`; `color` is optional.
data[].values[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
data[].values[].label	String	Yes	Segment label.
data[].values[].value	Number	Yes	Segment value.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
options	Object	No	Chart rendering options. See nested fields below.
options.width	Integer	No	Chart width in pixels. Minimum: 1.
options.height	Integer	No	Chart height in pixels. Minimum: 1.
options.x_axis	Object	No	X-axis styling options.
options.x_axis.font_size	Number	No	Font size in pixels. Minimum: 1.
options.x_axis.font_color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
options.y_axis	Object	No	Y-axis styling options.
options.y_axis.font_size	Number	No	Font size in pixels. Minimum: 1.
options.y_axis.font_color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
options.spacing	Integer	No	Spacing in pixels between bars. Minimum: 0.
options.bar_width	Integer	No	Bar width in pixels. Minimum: 1.
options.title_style	Object	No	Title styling options.
options.title_style.padding	Integer	No	Padding in pixels. Minimum: 0.
options.title_style.font_size	Number	No	Font size in pixels. Minimum: 1.
options.title_style.font_color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
options.canvas_color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
options.background_padding	Integer	No	Background padding in pixels. Minimum: 0.

Response

Returns a JSON object with a required data string field. The data value is a URI pointing to the generated chart image.

Parameter	Type	Mandatory	Description
data	String	Yes	Pre-signed URL for the generated chart image. Format: URI.

Notes

The request body supports both data and the deprecated bar field as aliases for the chart series, but they should not be sent together.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 02 / 02

POST

Generate stacked bar chart image

http://localhost:8080/apyhub/generate-stacked-bar-chart/download

QUICKSTARTGUIDE

Quickstart

Generate a stacked bar chart from a minimal JSON payload with a title and one data series.

curl -X POST "http://localhost:8080/apyhub/generate-stacked-bar-chart/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quarterly Revenue and Cost",
    "data": [
      {
        "name": "Q1",
        "values": [
          {
            "label": "Revenue",
            "value": 100000
          },
          {
            "label": "Cost",
            "value": 62000
          }
        ]
      }
    ]
  }'

What you'll get back

Returns a binary file response (string with format: binary), typically the generated chart image itself.

TRY ITLIVE · 60 ATOMS

Loading playground…

About this endpoint

What it does

Generates a stacked bar chart image from the chart data you provide in the request body and returns the image as binary content.

Request Body

Parameter	Type	Mandatory	Description
title	String	Yes	Chart title. Must be at least 1 character long.
data	Object Array	Yes	Stacked bar groups to render. Each item must include `name` and `values`.
data[].name	String	Yes	Label for the bar group.
data[].width	Integer	No	Bar width in pixels. Must be at least 1.
data[].values	Object Array	Yes	Stacked segments for the bar group. Must contain at least 1 item.
data[].values[].color	String	No	Segment color as a 6-character hex value without the leading `#`.
data[].values[].label	String	Yes	Label for the stacked segment.
data[].values[].value	Number	Yes	Numeric value for the stacked segment.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
options	Object	No	Optional chart styling and layout settings.
options.width	Integer	No	Chart width in pixels. Must be at least 1.
options.height	Integer	No	Chart height in pixels. Must be at least 1.
options.x_axis	Object	No	X-axis styling.
options.x_axis.font_size	Number	No	Font size in pixels. Must be at least 1.
options.x_axis.font_color	String	No	X-axis font color as a 6-character hex value without the leading `#`.
options.y_axis	Object	No	Y-axis styling.
options.y_axis.font_size	Number	No	Font size in pixels. Must be at least 1.
options.y_axis.font_color	String	No	Y-axis font color as a 6-character hex value without the leading `#`.
options.spacing	Integer	No	Space between bars in pixels. Must be at least 0.
options.bar_width	Integer	No	Default bar width in pixels. Must be at least 1.
options.title_style	Object	No	Title styling.
options.title_style.padding	Integer	No	Padding in pixels. Must be at least 0.
options.title_style.font_size	Number	No	Title font size in pixels. Must be at least 1.
options.title_style.font_color	String	No	Title font color as a 6-character hex value without the leading `#`.
options.canvas_color	String	No	Canvas background color as a 6-character hex value without the leading `#`.
options.background_padding	Integer	No	Padding around the chart background in pixels. Must be at least 0.

Response

Returns the generated chart as binary content. The output schema is a binary string, so the success response is the image file itself rather than a JSON object.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.