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

راهنمای جامع API پارسا اسپیس 2

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

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

چرا باید از API پارسا اسپیس 2 استفاده کنید؟ 🚀

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

• 🎯 اتوماسیون کامل: به سادگی فرآیندهای تکراری مانند آپلود، دانلود، تغییر نام یا حذف فایل‌ها را خودکار کنید. این ویژگی باعث صرفه‌جویی در زمان و کاهش خطای انسانی می‌شود.
• ⚡️ سرعت و کارایی بالا: با ارسال درخواست‌های مستقیم به سرور، عملیات مدیریت فایل با سرعت بسیار بالایی انجام می‌شود. دیگر نیازی به دخالت دستی و رابط‌های کاربری کند نخواهید داشت.
• 🧩 یکپارچه‌سازی آسان: این API به راحتی با زبان‌های برنامه‌نویسی مختلف ادغام می‌شود. بنابراین، شما می‌توانید آن را در هر پروژه‌ای، از وب‌سایت‌های وردپرسی گرفته تا اپلیکیشن‌های موبایل، به کار بگیرید.
• 🔒 امنیت تضمین‌شده: تمام درخواست‌ها از طریق توکن‌های احراز هویت (Bearer Token) ارسال می‌شوند. این مکانیزم امنیت داده‌های شما را در حین انتقال تضمین می‌کند.
• 📈 مقیاس‌پذیری: چه یک پروژه کوچک داشته باشید و چه یک سرویس بزرگ با میلیون‌ها کاربر، API پارسا اسپیس به خوبی پاسخگوی نیاز شما خواهد بود و همراه با رشد کسب‌وکارتان، مقیاس‌پذیر باقی می‌ماند.

کاربردهای کلیدی API پارسا اسپیس

شاید بپرسید این API در عمل چه کاربردهایی دارد؟ انعطاف‌پذیری API پارسا اسپیس به شما اجازه می‌دهد تا راه‌حل‌های خلاقانه‌ای برای نیازهای مختلف ایجاد کنید.

• 📂 سیستم‌های مدیریت محتوا (CMS): فایل‌های رسانه‌ای (تصاویر، ویدئوها و اسناد) وب‌سایت خود را مستقیماً روی فضای ابری مدیریت کنید.
• 💾 سرویس‌های پشتیبان‌گیری خودکار: یک اسکریپت بنویسید تا به صورت روزانه یا هفتگی از داده‌های مهم شما نسخه پشتیبان تهیه کرده و در پارسا اسپیس ذخیره کند.
• ☁️ اپلیکیشن‌های اشتراک‌گذاری فایل: برنامه‌ای بسازید که کاربران بتوانند فایل‌های خود را آپلود کرده و با دیگران به اشتراک بگذارند.
• 📊 پلتفرم‌های پردازش داده: فایل‌های حجیم مانند دیتاست‌های علمی یا گزارش‌های مالی را برای پردازش و تحلیل به فضای ابری منتقل کنید.
• 🎥 وب‌سایت‌های پخش ویدئو و پادکست: فایل‌های مدیا را روی هاست ابری قدرتمند پارسا اسپیس میزبانی کرده و از طریق API به کاربران خود ارائه دهید.

چگونه شروع کنیم؟ راهنمای ثبت‌نام سریع 📝

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

1. ابتدا به وب‌سایت پارسا اسپیس به آدرس p.api.ir مراجعه کنید.
2. در پنل کاربری خود ثبت‌نام کرده و وارد حساب خود شوید.
3. از بخش مربوط به توسعه‌دهندگان یا تنظیمات حساب، کلید API منحصربه‌فرد خود را دریافت کنید.

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

آموزش عملی: تغییر نام فایل با API پارسا اسپیس 2

یکی از عملیات‌های پایه‌ای و پرکاربرد، تغییر نام یک فایل موجود در فضای ابری است. در این بخش، به صورت عملی نحوه انجام این کار را با استفاده از API پارسا اسپیس 2 نمایش می‌دهیم.

ارسال درخواست تغییر نام

برای تغییر نام یک فایل، باید یک درخواست از نوع POST به آدرس http://api.parsaspace.com/v1/files/rename ارسال کنید. این درخواست شامل پارامترهای زیر است:

• source: مسیر و نام فعلی فایل.
• destination: مسیر و نام جدید فایل.
• domain: دامنه یا زیردامنه شما در پارسا اسپیس.

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

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

C# / .NET

var client = new RestClient("http://api.parsaspace.com/v1/files/rename");
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("source", "/old-name.jpg");
request.AddParameter("destination", "/new-name.jpg");
IRestResponse response = client.Execute(request);

PHP

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.parsaspace.com/v1/files/rename",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "source=%2Fold-name.jpg&destination=%2Fnew-name.jpg&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);

Java (با استفاده از Unirest)

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

Python

import requests

url = "http://api.parsaspace.com/v1/files/rename"
payload = "source=/old-name.jpg&destination=/new-name.jpg&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: 'http://api.parsaspace.com/v1/files/rename',
  headers: { 
     'authorization': 'Bearer yourtoken',
     'content-type': 'application/x-www-form-urlencoded' 
  },
  form: { 
    source: '/old-name.jpg',
    destination: '/new-name.jpg',
    domain: 'yourdomain' 
  } 
};

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

درک پاسخ‌های API

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

• پاسخ موفق (کد 200):

    { "result": "ok" }

این پاسخ به معنی موفقیت‌آمیز بودن عملیات تغییر نام است.

• فایل از قبل موجود است (کد 400):

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

این خطا زمانی رخ می‌دهد که نام جدیدی که انتخاب کرده‌اید، از قبل برای فایل دیگری استفاده شده باشد.

• عدم دسترسی (کد 403):

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

این خطا معمولاً به دلیل نامعتبر بودن توکن یا نداشتن مجوز کافی برای انجام عملیات رخ می‌دهد.

 قدرت در دستان شماست

API پارسا اسپیس 2 یک ابزار استراتژیک برای توسعه‌دهندگانی است که به دنبال کارایی، امنیت و مقیاس‌پذیری هستند. این سرویس به شما کمک می‌کند تا مدیریت فایل‌ها را از یک وظیفه دستی و زمان‌بر به یک فرآیند خودکار و هوشمند تبدیل کنید. با ادغام این API در پروژه‌های خود، می‌توانید قابلیت‌های جدیدی خلق کرده و تجربه کاربری بهتری ارائه دهید.

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

💬 شما چه تجربه‌ای از کار با APIهای مدیریت فایل دارید؟ نظرات و سوالات خود را در بخش دیدگاه‌ها با ما به اشتراک بگذارید!

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