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

Создание столбчатых, линейных или круговых диаграмм из данных 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 "[email protected]" \
  -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 независимо от входного формата.