• نویسنده
• آگوست 24, 2019

آموزش کامل API پارسا اسپیس 3

در دنیای دیجیتال امروز، مدیریت فایل‌ها و پوشه‌ها یکی از ارکان اصلی هر اپلیکیشن یا وب‌سایت است. توسعه‌دهندگان همواره به دنبال راه‌حل‌هایی هستند که این فرآیند را خودکار، سریع و مقیاس‌پذیر کنند. API پارسا اسپیس ابزاری قدرتمند برای تعامل برنامه‌نویسی با فضای ابری است. در مقالات گذشته به نسخه‌های ۱ و ۲ پرداختیم. اکنون زمان آن رسیده که روی API پارسا اسپیس 3 و یکی از پرکاربردترین قابلیت‌های آن، یعنی ساخت پوشه جدید، تمرکز کنیم. 📂

این راهنما به شما نشان می‌دهد که چگونه می‌توانید با چند خط کد، مدیریت ساختار فایل‌های خود را به سطح بالاتری ببرید. بنابراین، اگر به دنبال یکپارچه‌سازی فضای ذخیره‌سازی ابری با پروژه خود هستید، این مقاله برای شما نوشته شده است.

API پارسا اسپیس 3 چیست و چرا اهمیت دارد؟

API (رابط برنامه‌نویسی کاربردی) پارسا اسپیس یک مجموعه دستورات و پروتکل‌های استاندارد است. این ابزار به توسعه‌دهندگان اجازه می‌دهد تا به صورت برنامه‌ریزی‌شده با زیرساخت ذخیره‌سازی ابری پارسا اسپیس تعامل داشته باشند. به عبارت ساده‌تر، به جای انجام دستی کارها در پنل کاربری، می‌توانید با کدنویسی فایل‌ها را آپلود، دانلود، حذف یا سازماندهی کنید.

نسخه سوم این API با بهینه‌سازی‌های جدید، پایداری بیشتر و سادگی در استفاده، تجربه توسعه‌دهندگان را بهبود بخشیده است. استفاده از این API به شما کمک می‌کند تا فرآیندهای تکراری را خودکار کرده و سرعت توسعه اپلیکیشن خود را افزایش دهید.

مزایای کلیدی استفاده از API پارسا اسپیس

ادغام API پارسا اسپیس با پروژه‌های شما مزایای قابل توجهی به همراه دارد. این مزیت‌ها نه تنها در زمان و هزینه صرفه‌جویی می‌کنند، بلکه کیفیت و کارایی محصول نهایی را نیز افزایش می‌دهند. در ادامه به مهم‌ترین آن‌ها اشاره می‌کنیم:

• 🚀 اتوماسیون و سرعت: فرآیندهای دستی مانند ساختن پوشه برای هر کاربر جدید را به طور کامل خودکار کنید. این کار سرعت پاسخگویی سرویس شما را به شدت افزایش می‌دهد.
• 📈 مقیاس‌پذیری بالا: با رشد کسب‌وکار و افزایش تعداد کاربران، API به راحتی پاسخگوی نیازهای شما خواهد بود. بدون نگرانی از محدودیت‌ها، ساختار فایل خود را گسترش دهید.
• 🛡️ امنیت و کنترل دسترسی: شما کنترل کاملی بر روی دسترسی‌ها دارید. با استفاده از توکن‌های امن، می‌توانید مشخص کنید چه کسی و با چه مجوزی به فایل‌ها دسترسی داشته باشد.
• 💻 یکپارچه‌سازی آسان: این API بر اساس معماری RESTful طراحی شده است. بنابراین، با هر زبان برنامه‌نویسی مدرنی به راحتی قابل استفاده و ادغام است.
• 💰 کاهش هزینه‌های عملیاتی: با خودکارسازی وظایف، نیاز به نیروی انسانی برای مدیریت فایل‌ها کاهش می‌یابد. این موضوع در بلندمدت منجر به صرفه‌جویی در هزینه‌ها می‌شود.

آموزش گام‌به‌گام ساخت پوشه جدید با API پارسا اسپیس 3

اکنون به بخش عملی ماجرا می‌رسیم. در این بخش، تمام مراحل لازم برای ساخت یک پوشه جدید از طریق API را با جزئیات کامل بررسی خواهیم کرد.

 پیش‌نیازها: اولین قدم برای شروع

قبل از ارسال هر درخواستی به API، شما به دو چیز نیاز دارید:

1. حساب کاربری پارسا اسپیس: باید در پارسا اسپیس یک حساب فعال داشته باشید.
2. توکن دسترسی (Bearer Token): این توکن کلید امنیتی شما برای احراز هویت درخواست‌ها است.

 مراحل ثبت‌نام و دریافت توکن

اگر هنوز حساب کاربری ندارید، نگران نباشید. فرآیند ثبت‌نام بسیار ساده است.

1. ابتدا به وب‌سایت p.api.ir مراجعه کنید.
2. اطلاعات مورد نیاز را تکمیل و حساب کاربری خود را ایجاد نمایید.
3. پس از ورود به پنل کاربری، به بخش «کلیدهای دسترسی» یا «API Keys» بروید.
4. در این بخش می‌توانید توکن اختصاصی خود را مشاهده و کپی کنید. این توکن را در جایی امن نگهداری کنید! ✨

 ساختار درخواست (Request) برای ساخت پوشه

برای ساخت یک پوشه جدید، باید یک درخواست از نوع POST به آدرس زیر ارسال کنید. این درخواست شامل پارامترهایی برای مشخص کردن دامنه و مسیر پوشه است.

• آدرس (URL): https://api.parsaspace.com/v1/files/Createfolder
• متد (Method): POST
• هدرها (Headers):
• authorization: مقدار آن باید Bearer yourtoken باشد (yourtoken را با توکن خود جایگزین کنید).
• content-type: مقدار آن application/x-www-form-urlencoded است.
• پارامترها (Parameters):
• domain: نام دامنه یا فضای ذخیره‌سازی شما.
• path: مسیر و نام پوشه جدید (مثلاً /new-folder یا /users/profile-images).

 نمونه کدها در زبان‌های مختلف

در ادامه، نمونه کدهای آماده برای چند زبان برنامه‌نویسی محبوب آورده شده است. کافیست yourtoken و yourdomain را با مقادیر واقعی خود جایگزین کنید.

.NET

var client = new RestClient("https://api.parsaspace.com/v1/files/Createfolder");
var request = new RestRequest(Method.POST);
request.AddHeader("authorization", "Bearer yourtoken");
request.AddHeader("content-type", "application/x-www-form-urlencoded");
request.AddParameter("domain", "yourdomain");
request.AddParameter("path", "/new-folder-name");
IRestResponse response = client.Execute(request);

PHP

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.parsaspace.com/v1/files/createfolder",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "path=%2Fnew-folder-name&domain=yourdomain",
  CURLOPT_HTTPHEADER => array(
    "authorization: Bearer yourtoken",
    "content-type: application/x-www-form-urlencoded"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Java (با Unirest)

HttpResponse<String> response = Unirest.post("https://api.parsaspace.com/v1/files/createfolder")
  .header("authorization", "Bearer yourtoken")
  .header("content-type", "application/x-www-form-urlencoded")
  .body("path=%2Fnew-folder-name&domain=yourdomain")
  .asString();

Python

import requests

url = "https://api.parsaspace.com/v1/files/createfolder"

payload = "path=%2Fnew-folder-name&domain=yourdomain"
headers = {
    'authorization': "Bearer yourtoken",
    'content-type': "application/x-www-form-urlencoded"
}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Node.js

var request = require("request");

var options = {
  method: 'POST',
  url: 'https://api.parsaspace.com/v1/files/createfolder',
  headers: {
    'content-type': 'application/x-www-form-urlencoded',
    'authorization': 'Bearer yourtoken'
  },
  form: {
    domain: 'yourdomain',
    path: '/new-folder-name'
  }
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);
  console.log(body);
});

 تحلیل پاسخ‌های دریافتی از API

پس از ارسال درخواست، API پاسخی با فرمت JSON برمی‌گرداند. درک این پاسخ‌ها برای مدیریت خطاها ضروری است.

• ✅ پاسخ موفق (کد 200): اگر همه چیز به درستی انجام شود، پاسخی مشابه زیر دریافت خواهید کرد که نشان‌دهنده موفقیت عملیات است.

    {"result":"success"}

• ⚠️ خطای 400 (درخواست نامعتبر): این خطا معمولاً زمانی رخ می‌دهد که پوشه‌ای با همین نام از قبل وجود داشته باشد.

    {"result": "error", "message": "Object already exist."}

• 🚫 خطای 403 (عدم دسترسی): این خطا به معنای آن است که توکن شما معتبر نیست یا مجوز لازم برای انجام این کار را ندارید.

    {"result": "error", "message": "Sorry! Access denied"}

کاربردهای عملی ساخت پوشه با API پارسا اسپیس

شاید بپرسید این قابلیت ساده در چه سناریوهایی به کار می‌آید؟ کاربردهای آن بسیار گسترده‌تر از چیزی است که به نظر می‌رسد.

• 👤 ایجاد پوشه برای هر کاربر: در پلتفرم‌هایی که کاربران فایل آپلود می‌کنند (مانند شبکه‌های اجتماعی یا سیستم‌های مدیریت اسناد)، می‌توانید به محض ثبت‌نام کاربر، یک پوشه اختصاصی برای او بسازید.
• 🗂️ سازماندهی فایل‌های آپلودی: می‌توانید فایل‌ها را بر اساس تاریخ (مثلاً پوشه /uploads/2026/06) یا نوع (مثلاً /images, /videos, /documents) به صورت خودکار دسته‌بندی کنید.
• 📦 مدیریت محصولات فروشگاه: برای هر محصول در یک فروشگاه اینترنتی، یک پوشه مجزا برای نگهداری تصاویر، ویدیوها و کاتالوگ‌ها ایجاد کنید.
• 📑 سیستم‌های پشتیبان‌گیری خودکار: اسکریپت‌هایی بنویسید که به صورت روزانه یا هفتگی یک پوشه جدید با تاریخ همان روز بسازند و از اطلاعات مهم نسخه پشتیبان تهیه کنند.

جمع‌بندی و گام بعدی

در این مقاله، ما به طور کامل با متد CreateFolder در API پارسا اسپیس 3 آشنا شدیم. دیدیم که چگونه می‌توان با استفاده از چند خط کد ساده در زبان‌های مختلف، فرآیند ساخت پوشه در فضای ابری را خودکار کرد. این قابلیت، دروازه‌ای به سوی ساخت اپلیکیشن‌های مقیاس‌پذیر و هوشمند است. با خودکارسازی مدیریت فایل، می‌توانید زمان و انرژی خود را روی توسعه ویژگی‌های اصلی محصولتان متمرکز کنید. 🎯

حالا نوبت شماست! با استفاده از این راهنما، اولین درخواست خود را به API ارسال کنید و قدرت اتوماسیون را تجربه کنید.

آیا در مورد استفاده از این API سوالی دارید یا تجربه خود را با ما در میان می‌گذارید؟ مشتاقانه منتظر خواندن نظرات شما در بخش دیدگاه‌ها هستیم.

• برچسب ها:
• api
• API پارسااسپیس
• Web API
• Web API چیست؟
• پارسااسپیس
• وب سرویس