Files
SnapOtter/apps/docs/ru/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.9 KiB
Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Создание столбчатых, линейных или круговых диаграмм из данных CSV или JSON. d3c39384457b human d4bf64976710

Конструктор диаграмм

Создание столбчатых, линейных или круговых диаграмм из данных CSV или JSON. Возвращает изображение PNG с отрисованной диаграммой.

Эндпоинт API

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

Принимает multipart form data с файлом CSV или JSON и JSON-полем settings.

Параметры

Параметр Тип Обязательный По умолчанию Описание
kind string Нет "bar" Тип диаграммы: bar, line, pie
title string Нет - Заголовок диаграммы (максимум 120 символов)
width integer Нет 960 Ширина диаграммы в пикселях (320-2048)
height integer Нет 540 Высота диаграммы в пикселях (240-1536)

Пример запроса

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}'

Пример ответа

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

Примечания

  • Входные данные должны быть файлом .csv или .json. Файлы CSV должны содержать строку заголовка с именами столбцов.
  • Первый столбец используется как метка категории; второй столбец должен быть числовым и предоставляет значения данных. Используются только два столбца.
  • Входные данные JSON должны быть массивом объектов {label, value} или простым объектом, ключи которого становятся метками, а значения точками данных.
  • Максимум 100 точек данных. Все значения должны быть нулевыми или больше.
  • Выходной файл всегда является изображением PNG независимо от входного формата.