Files
SnapOtter/apps/docs/pl/tools/files/chart-maker.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.0 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Tworzy wykresy słupkowe, liniowe lub kołowe z danych CSV lub JSON. d3c39384457b human 25849f2b1af2

Chart Maker

Tworzy wykresy słupkowe, liniowe lub kołowe z danych CSV lub JSON. Zwraca obraz PNG z wyrenderowanym wykresem.

API Endpoint

POST /api/v1/tools/files/chart-maker

Przyjmuje dane formularza multipart z plikiem CSV lub JSON oraz polem JSON settings.

Parameters

Parametr Typ Wymagany Domyślny Opis
kind string Nie "bar" Typ wykresu: bar, line, pie
title string Nie - Tytuł wykresu (maks. 120 znaków)
width integer Nie 960 Szerokość wykresu w pikselach (320-2048)
height integer Nie 540 Wysokość wykresu w pikselach (240-1536)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/files/chart-maker \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@sales.csv" \
  -F 'settings={"kind": "line", "title": "Monthly Sales", "width": 960, "height": 540}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/sales_chart.png",
  "originalSize": 1024,
  "processedSize": 48500
}

Notes

  • Wejściem musi być plik .csv lub .json. Pliki CSV powinny mieć wiersz nagłówka z nazwami kolumn.
  • Pierwsza kolumna jest używana jako etykieta kategorii; druga kolumna musi być liczbowa i dostarcza wartości danych. Używane są tylko dwie kolumny.
  • Wejście JSON powinno być tablicą obiektów {label, value} lub zwykłym obiektem, którego klucze stają się etykietami, a wartości punktami danych.
  • Maksymalnie 100 punktów danych. Wszystkie wartości muszą być zerowe lub większe.
  • Wynikiem jest zawsze obraz PNG, niezależnie od formatu wejściowego.