▣ SMART GENERATION

Generate Pie Chart API

Hosted on ApyHub

What it does

Pie Chart Generator turns your labeled values into a pie chart image. Send a title, a data array, and optional styling options, and get back a pre-signed URL for the rendered chart or a binary image download.

Each data item can include a label, value, and optional hex color. The request also supports a light or dark theme, plus chart options for width, height, title styling, and canvas color. Use the deprecated pies alias only if you need to match an older integration; data is the primary field.

Use Pie Chart Generator when you need a shareable visual for product mix, budget allocation, survey results, or any other part-to-whole breakdown. It is a good fit for dashboards, reports, admin panels, and automated content pipelines where the chart needs to be generated from API data instead of drawn in the browser.

The response is simple to work with: one endpoint returns a URL in data, and the other returns the image as binary output. That keeps the integration lightweight whether you want to store the image, embed it, or hand it off to another service.

▣ ENDPOINT 01 / 02

POST

Generate pie chart link

http://localhost:8080/apyhub/generate-pie-chart/link

QUICKSTARTGUIDE

Quickstart

Create a pie chart from a title and slice data, and get back a URL to the generated image.

curl -X POST "http://localhost:8080/apyhub/generate-pie-chart/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Product Market Share",
    "data": [
      { "label": "Product A", "value": 45, "color": "3B82F6" },
      { "label": "Product B", "value": 30, "color": "10B981" },
      { "label": "Product C", "value": 25, "color": "F59E0B" }
    ]
  }'

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

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Generates a pie chart and returns a pre-signed URL for the rendered chart image. The request body lets you provide the chart data, title, theme, and optional sizing/style settings.

Request Body

Parameter	Type	Mandatory	Description
data	Object Array	Yes	Pie chart slices. Each item must include `label` and `value`; `color` is optional. Use `data` or the deprecated `pies` alias, but not both.
data[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
data[].label	String	Yes	Slice label.
data[].value	Number	Yes	Slice value. Minimum: 0.
pies	Object Array	No	Deprecated alias for `data`. Use either `data` or `pies`, not both. Each item has the same shape as `data[]`.
pies[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
pies[].label	String	Yes	Slice label.
pies[].value	Number	Yes	Slice value. Minimum: 0.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Yes	Chart title. Must be at least 1 character long.
options	Object	No	Optional chart layout and styling settings.
options.width	Integer	No	Chart width in pixels. Minimum: 1.
options.height	Integer	No	Chart height in pixels. Minimum: 1.
options.title_style	Object	No	Title styling settings.
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	Canvas color as a 6-character hex value without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.

Response

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

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

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 02 / 02

POST

Generate pie chart image

http://localhost:8080/apyhub/generate-pie-chart/download

QUICKSTARTGUIDE

Quickstart

Generate a pie chart file from a simple title and slice data, and name the output with the output query parameter.

curl -X POST "http://localhost:8080/apyhub/generate-pie-chart/download?output=product-market-share-pie-chart" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Product Market Share","data":[{"color":"3B82F6","label":"Product A","value":45},{"color":"10B981","label":"Product B","value":30},{"color":"F59E0B","label":"Product C","value":25}]}'

What you'll get back

Returns a binary file response (string with format: "binary"), which you can save directly to disk.

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Generates a pie chart image from the chart configuration in the request body and returns the rendered image as binary output. The request must include the chart title and data, and can also include optional styling and sizing options.

Request Body

Parameter	Type	Mandatory	Description
data	Object Array	Yes	Pie chart slices. Each item must include `label` and `value`; `color` is optional.
data[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
data[].label	String	Yes	Slice label.
data[].value	Number	Yes	Slice value. Must be greater than or equal to 0.
pies	Object Array	No	Deprecated alias for `data`. Use either `data` or `pies`, not both. Each item must include `label` and `value`; `color` is optional.
pies[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
pies[].label	String	Yes	Slice label.
pies[].value	Number	Yes	Slice value. Must be greater than or equal to 0.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Yes	Chart title. Minimum length: 1.
options	Object	No	Optional rendering options. Includes `width`, `height`, `title_style`, and `canvas_color`.
options.width	Integer	No	Chart width in pixels. Must be greater than or equal to 1.
options.height	Integer	No	Chart height in pixels. Must be greater than or equal to 1.
options.title_style	Object	No	Title styling options. Includes `padding`, `font_size`, and `font_color`.
options.title_style.padding	Integer	No	Padding in pixels. Must be greater than or equal to 0.
options.title_style.font_size	Number	No	Font size in pixels. Must be greater than or equal to 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}$`.

Response

Returns a binary file response containing the generated pie chart image.

Parameter	Type	Mandatory	Description
binary output	String	Yes	Rendered pie chart image returned as binary data.

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.