차트 메이커

CSV 또는 JSON 데이터로 막대, 선, 또는 파이 차트를 만듭니다. 렌더링된 차트의 PNG 이미지를 반환합니다.

API 엔드포인트

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

CSV 또는 JSON 파일과 JSON settings 필드가 포함된 multipart form data를 받습니다.

매개변수

매개변수	유형	필수	기본값	설명
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개의 데이터 포인트. 모든 값은 0 이상이어야 합니다.
• 입력 형식과 관계없이 출력은 항상 PNG 이미지입니다.