
چگونه JSON را به CSV با استفاده از API Node.js تبدیل کنیم.
JSON(JavaScript Object Notation) به طور گستردهای برای انتقال دادهها در پلتفرمهای وب و موبایل استفاده میشود. با این حال، هنگام کار با پایگاههای داده، صفحهگستردهها یا پلتفرمهای تحلیل داده، معمولاً دادهها در فرمت صاف CSV(Comma-Separated Values) مورد انتظار است. با استفاده از GroupDocs.Conversion Cloud SDK برای Node.js، تبدیل JSON به CSV سریع، دقیق و کاملاً مبتنی بر Cloud است.
- Node.js API برای تبدیل JSON به CSV
- در Node.js JSON را به CSV تبدیل کنید
- تبدیل JSON به CSV از طریق دستور cURL
API نود.جیاس برای تبدیل JSON به CSV
GroupDocs.Conversion Cloud SDK for Node.js یک SDK مبتنی بر REST است که تغییر فرمتهای فایل را ساده میکند. این SDK از بیش از 50 نوع سند و داده پشتیبانی میکند، از جمله JSON، CSV، DOCX، PDF و غیره.
مزایای کلیدی:
- JSON را به ساختار CSV مسطح تبدیل میکند.
- هدرها، نگاشتهای فیلد و مقادیر را حفظ میکند.
- نیازی به نصب نرمافزار نیست.
- SDK یا دستورات cURL RESTful که استفاده از آنها آسان است.
- اح authentification OAuth 2.0 امن.
API را نصب کنید
npm install groupdocs-conversion-cloud --save
یک حساب کاربری رایگان ایجاد کنید و Client ID و Client Secret خود را از GroupDocs Cloud dashboard دریافت کنید.
JSON را به CSV در Node.js تبدیل کنید
این بخش جزئیات چگونگی تبدیل فایل JSON به فرمت CSV با استفاده از کد مختصر Node.js را توضیح میدهد.
مرحله 1: وارد کردن و تنظیمکردن API
const { Configuration, ConvertApi, FileApi, UploadFileRequest, ConvertSettings, ConvertDocumentRequest } = require("groupdocs-conversion-cloud");
const config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
const convertApi = new ConvertApi(config);
const fileApi = new FileApi(config);
مرحله ۲: فایل JSON را به Cloud بارگذاری کنید
const fs = require("fs");
const uploadRequest = new UploadFileRequest("source.json", fs.createReadStream("source.json"));
await fileApi.uploadFile(uploadRequest);
مرحله ۳: تبدیل JSON به فرمت CSV
const settings = new ConvertSettings();
settings.filePath = "input.json";
settings.format = "csv";
settings.outputPath = "converted/output.csv";
const request = new ConvertDocumentRequest(settings);
await convertApi.convertDocument(request);
console.log("JSON to CSV conversion completed successfully.");
// بیشتر نمونهها در https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-node
// گواهینامههای API خود را بدست آورید
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// یک نمونه از ConvertApi را با شیء Configuration راهاندازی کنید
const {
Configuration,
ConvertApi,
FileApi,
UploadFileRequest,
ConvertDocumentRequest,
ConvertSettings
} = require("groupdocs-conversion-cloud");
const config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
// API base URL را برای تبدیل JSON به CSV تعریف کنید.
config.setApiBaseUrl("https://api.groupdocs.cloud");
const convertApi = new ConvertApi(config);
const fileApi = new FileApi(config);
const fs = require("fs");
const uploadRequest = new UploadFileRequest("source.json", fs.createReadStream("source.json"));
await fileApi.uploadFile(uploadRequest);
const settings = new ConvertSettings();
settings.filePath = "source.json"; // Input file path
settings.format = "csv"; // Output format
settings.outputPath = "resultant/output.csv"; // Output file path
const request = new ConvertDocumentRequest(settings);
const result = await convertApi.convertDocument(request);
console.log("✅ JSON to CSV conversion completed successfully.");

تصویر:- پیشنمایش تبدیل JSON به CSV.
فایلهای نمونه استفاده شده در مثال بالا را میتوان از دانلود کرد:
تبدیل JSON به CSV از طریق فرمان cURL
ترجیح میدهید از خط فرمان یا اسکریپتهای شل استفاده کنید؟ شما همچنین میتوانید از GroupDocs.Conversion Cloud از طریق cURL برای اتوماسیون مستقل از پلتفرم استفاده کنید.
مرحله ۱ – دریافت توکن دسترسی:
curl -v "https://api.groupdocs.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
-H "Content-Type: application/x-www-form-urlencoded"
مرحله ۲ - تبدیل JSON به CSV با استفاده از API: پس از دریافت توکن JWT، لطفاً از این دستور cURL برای تبدیل JSON به فرمت CSV استفاده کنید:
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {JWT_TOKEN}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"internal\", \"FilePath\": \"{inputFile}\", \"Format\": \"csv\", \"resultantPath\": \"{myResultant}\"}"
inputFile
را با نام فایل JSON ورودی، resultantPath
را با نام فایل CSV حاصل و JWTTOKEN
را با توکن دسترسی JWT شخصیسازی شده که در مرحله 1 تولید شده، تعویض کنید.
تبدیلکنندهی رایگان JSON به CSV آنلاین را امتحان کنید
شما میتوانید قدرت این API را از طریق JSON to CSV Converter آنلاین نیز کشف کنید. این ابزار عملکرد API REST را به نمایش میگذارد و نیازی به نصب یا کدنویسی ندارد.

منابع توسعه دهندگان
✅ نتیجه گیری
استفاده از GroupDocs.Conversion Cloud SDK برای Node.js، تبدیل JSON به CSV را ساده، سریع و بسیار قابل اعتماد میکند. خواه شما در حال ساخت ابزارهای پردازش داده، داشبوردها یا خطوط ادغام باشید، این API به شما امکان میدهد تا دادههای مرتب شده را به فرمتهای جدولی با سهولت تبدیل کنید.
در برنامههای Node.js خود تبدیل JSON به CSV را اتوماتیک کنید و امروز جریانهای دادهای خود را بهبود بخشید!
مقالات پیشنهادی
ما همچنین توصیه میکنیم به لینکهای زیر مراجعه کنید تا بیشتر درباره یاد بگیرید: