
راهنمای برنامه نویسان پارسااسپیس
به راهنمای برنامه نویسان پارسا اسپیس خوش آمدید، در این راهنما شما تمامی اطلاعات مورد نیاز خود جهت استفاده از این وب سرویس را بدست می آورید.
پارسا اسپیس با داشتن REST API امکان ارتباط برنامه های مختلف را فراهم کرده است.در این سرویس شما می توانید به آسانی و امنیت بالا در هر نقطه ای از وب و در هر زمانی اطلاعات خود را ذخیره و بازیابی نمائید. هدف این سرویس، فراهم کردن امکانات آپلود، کپی، انتقال و غیره برای توسعه دهندگان است. در این راهنما مفاهیم اصلی API Parsaspace و نحوه کار با آن توضیح داده شده است.
آدرس های وب سرویس پارسا اسپیس پارامترهایی از نوع Get , Post دریافت و پاسخ هایی از نوع json بر می گردانند.
آدرس (url):
https://api.parsaspace.com/v1/
آدرس های وب سرویس:
Return | Endpoint |
---|---|
لیست فایل ها | https://api.parsaspace.com/v1/files/list |
حذف فایل | https://api.parsaspace.com/v1/files/remove |
تغییر نام فایل | https://api.parsaspace.com/v1/files/rename |
انتقال فایل | https://api.parsaspace.com/v1/files/move |
کپی فایل | https://api.parsaspace.com/v1/files/copy |
ایجاد پوشه | https://api.parsaspace.com/v1/files/createfolder |
آپلود فایل | https://api.parsaspace.com/v1/files/upload |
ریموت آپلود فایل | https://api.parsaspace.com/v1/remote/new |
وضعیت ریموت آپلود فایل | https://api.parsaspace.com/v1/remote/status |
پارسا اسپیس برای اعتبارسنجی درخواست های API خود از توکن استفاده می کند. جهت استفاده از سرویس های پارسااسپیس باید مقدار TOKEN که از پنل کاربری خود دریافت می نمائید، در هر درخواست در قسمت Header به صورت Bearer TOKEN
ارسال نمائید.
اعتبارسنجی کاربر:
این روش رایج ترین روش اعتبارسنجی می باشد. در این روش هر کاربر با استفاده از TOKEN ایجاد شده منحصر بفرد در پنل کاربری خود می تواند در سرویس پارسااسپیس اعتبارسنجی شود و از این سرویس استفاده نماید.
نوع TOKEN:
Bearer
نمونه:
curl -X POST "https://api.parsaspace.com/v1" \
--header "Authorization: Bearer <OAUTH2_ACCESS_TOKEN>"
خطای 401
خطای 401 یا "Authorization has been denied for this request." این خطا زمانی اتفاق می افتد که TOKEN نامعتبر باشد, ممکن است TOKEN تغییر کرده باشد . ممکن است کاربر TOKEN را غیرفعال یا رمز دسترسی به آن را تغییر داده باشد.
تمامی درخواست ها باید شامل Authorization در قسمت Header و Domain در قسمت Body باشند.
پارامتر های ضروری:
Name | Entry In | Example | Description |
---|---|---|---|
Authorization | Headers | Bearer yourtoken | Token ایجاد شده در حساب کاربری شما در پارسااسپیس |
Domain | Body | yourdomain | آدرس وب سایت ایجاد شده شما در پارسااسپیس |
ساختار:
تمامی پاسخ ها در قالب JSON می باشند. اطلاعات در خواستی در تگ RESULT گنجانده می شود. اگر درخواست شما پاسخی داشته باشد RESULT با SUCCESS مقدار دهی می شود. و در صورتی خطایی اتفاق بیافتد پاسخ به این صورت که RESULT با ERROR و MESSAGE با خطای اتفاق افتاده مقدار دهی می شود.
پاسخ موفق:
{"result": "success"}
پاسخ با خطا:
{"result":"error","message":"access denied"}
خطاها به شکل کد خطای استاندارد HTTP باز می گردند. اطلاعات اضافی از خطا در قالب JSON در قسمت Body درخواست بازگردانده می شود.
کد خطاهای استاندار (Status Code):
Code | Result | Description | Message |
---|---|---|---|
200 | success | زمانی که درخواست با موفقیت به سرور ارسال و از سرور پاسخ دریافت نماید | The request was successfull send to server and recieve result (The message is variable relative to the request) |
400 | error | خطای 400 زمانی اتفاق می افتد حداقل یکی از پارامتر های ارسالی نامعتبر باششد | bad request" "Your browser sent a request that this server could not understand |
401 | error | خطای 401 یا "Authorization has been denied for this request." این خطا زمانی اتفاق می افتد که TOKEN نامعتبر باشد, ممکن است TOKEN تغییر کرده باشد . ممکن است کاربر TOKEN را غیرفعال یا رمز دسترسی به آن را تغییر داده باشد. | Authorization has been denied for this request. |
لیست تمامی فایل ها و پوشه های مسیر مورد نظر کاربر را بر می گرداند.
آدرس (Url):
https://api.parsaspace.com/v1/files/list
Method:
Post
اعتبارسنجی:
پارامترهای ارسالی:
Parameter | Enty In | Type | Description | Required |
---|---|---|---|---|
Authorization | Headers | Bearer yourtoken | Token ایجاد شده در حساب کاربری شما در پارسااسپیس | اجباری |
domain | Body | String | آدرس وب سایت ایجاد شده شما در پارسااسپیس | اجباری |
path | Body | String | آدرس (مسیر) فایل های ذخیره شده | اختیاری |
نمونه پاسخ دریافتی:
{"result":"success","list":[{"Name":"a.txt","IsFolder":false,"Size":8,"LastModified":"2016-11-07 09:49:24"},{"Name":"b.txt","IsFolder":false,"Size":3,"LastModified":"2016-11-07 09:49:24"}]}
نمونه کد زبان های برنامه نویسی:
curl_setopt_array($curl,
array(
CURLOPT_URL => "http://api.parsaspace.com/v1/files/list",
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST =>"POST",
CURLOPT_RETURNTRANSFER=>true,
CURLOPT_POSTFIELDS =>"path=Your-path&domain=Your-Domain&type=json",
CURLOPT_HTTPHEADER => array(
"authorization: Your-Token",
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err){
echo "cURL Error #:" $err;
}
else {
echo $response;
}
.header("authorization", "Your-token")
.body("path=Your-Path &domain=Your-Doamin&type=json")
.asString();
var client = new RestClient("http://api.parsaspace.com/v1/files/list");
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", "/");
IRestResponse response = client.Execute(request);
url = "http://api.parsaspace.com/v1/files/list"
payload = "path=Your-Path &domain=Your-Domain &type=json"
headers = {
'authorization': "Your-Token",
}
response = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
var request =
require("request");
var options = { method: 'POST',
url:'http://api.parsaspace.com/v1/files/list',
headers:
{
authorization: ' Your-Token ' },
form: { path: '/', domain: 'yourdomain', type: 'json' } };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
نمونه پاسخ ( خطاها ):
{
"result": "success",
"list":[{"List of files"}];
}
{
"result": "error",.
"message": "access denied"
}
{
"result": "error",
"message": Object already exist.",
}
{
"result":
"error",
"message": "Authorization has been denied for this request.",
}
{
"result": "error",
"message": Sorry!Access denied",
}
حذف اطلاعات مسیر مورد نظر.
آدرس (Url):
https://api.parsaspace.com/v1/files/remove
Method:
Post
اعتبارسنجی:
پارامترهای ارسالی:
Parameter | Enty In | Type | Description | Required |
---|---|---|---|---|
Authorization | Headers | Bearer yourtoken | Token ایجاد شده در حساب کاربری شما در پارسااسپیس | اجباری |
domain | Body | String | آدرس وب سایت ایجاد شده شما در پارسااسپیس | اجباری |
path | Body | String | امکان حذف یک یا چند فایل به طور همزمان. فایل ها باید با (,) از هم جدا شوند. مثال: /images/a.jpg,/music/1.mp3 |
اختیاری |
نمونه پاسخ دریافتی:
{ "result": "success"}
نمونه کد زبان های برنامه نویسی:
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.parsaspace.com/v1/files/remove",
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_RETURNTRANSFER=>true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "path=Your-Path &domain=yourdomain&type=json",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer Your-Token",
"cache-control: no-cache",
"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;
}
.header("content-type", "application/x-www-form-urlencoded")
.header("authorization", "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1bmlxdWVfbmFtZSI6InNhZWlkbWFyb3VmaTY2QGd")
.body("path=%2Ftest-4&yourdomain&type=json")
.asString();
var request = new RestRequest(Method.POST);
request.AddHeader("authorization", Bearer yourtoken");
request.AddHeader("content-type", "application/x-www-form-urlencoded");
request.AddParameter("domain","yourdomain");
IRestResponse response = client.Execute(request);
url = "http://api.parsaspace.com/v1/files/remove"
payload = "path=Your-Path &domain=yourdomain&type=json"
headers = {
'content-type': "application/x-www-form-urlencoded",
'authorization': "Bearer Your-Token",
}
response = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
var options = { method: 'POST',
url: 'http://api.parsaspace.com/v1/files/remove',
headers:
{
authorization: 'Bearer Your-Token' },
form: { path: '/test-4', domain: 'yourdomain', type: 'json' } };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
نمونه پاسخ ( خطاها ):
{
"result": "success",
}
{
"result": "error",
"message": "Object already exist.",
}
{
"result": "error",
"message": "Sorry!Access denied",
}
تغییر نام فایل مورد نظر به نام دلخواه.
آدرس (Url):
https://api.parsaspace.com/v1/files/rename
Method:
Post
اعتبارسنجی:
پارامترهای ارسالی:
Parameter | Entry In | Type | Description | Required |
---|---|---|---|---|
Authorization | Headers | Bearer yourtoken | Token ایجاد شده در حساب کاربری شما در پارسااسپیس | اجباری |
domain | Body | String | آدرس وب سایت ایجاد شده شما در پارسااسپیس | اجباری |
source | Body | String | آدرس فایلی که می خواهید تغییر نام دهید مثال: /image/a.jpg |
اجباری |
destination | Body | String | آدرس فایلی که می خواهید به آن تغییر نام دهید | اجباری |
نمونه پاسخ دریافتی:
{"result":"success"}
نمونه کد زبان های برنامه نویسی:
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.parsaspace.com/v1/files/rename",
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_RETURNTRANSFER=>true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "source=/test &destination=/Ftest&domain=yourdomain&type=json",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer yourtoken",
"cache-control: no-cache",
"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;
}
.header("content-type", "application/x-www-form-urlencoded")
.header("authorization", "Bearer Your-Token")
.body("source=/2Ftest-1&destination=/2Ftest-4&domain=yourdomain&type=json")
.asString();
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","/");
request.AddParameter("destinition","/");
IRestResponse response = client.Execute(request);
url = "http://api.parsaspace.com/v1/files/rename"
payload = "source=/test &destination=/Ftest &domain=yourdomain&type=json"
headers = {
'content-type': "application/x-www-form-urlencoded",
'authorization': "Bearer yourtoken",
}
esponse = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
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: '/test-1',
destination: '/test-4',
domain: 'yourdomain',
type: 'json' } };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
نمونه پاسخ ( خطاها ):
{
"result": "ok",
}
{
"result": "operation failed",
}
{
"result": "error",
"message": "Object already exist.",
}
{
"result": "error",
"message": "Sorry!Access denied",
}
انتقال فایل مورد نظر به پوشه دلخواه.
آدرس (Url):
https://api.parsaspace.com/v1/files/move
Method:
Post
اعتبارسنجی:
پارامترهای ارسالی:
Parameter | Entry In | Type | Description | Required |
---|---|---|---|---|
Authorization | Headers | Bearer yourtoken | Token ایجاد شده در حساب کاربری شما در پارسااسپیس | اجباری |
domain | Body | String | Each user can have multiple file or website, آدرس وب سایت ایجاد شده شما در پارسااسپیس | اجباری |
source | Body | String | امکان انتقال یک یا چند فایل به طور همزمان. فایل ها باید با (,) از هم جدا شوند. مثال: /images/a.jpg,/music/1.mp3 |
اجباری |
destination | Body | String |
آدرس مسیری که فایل ها به آن انتقال می یابند مثال: /c |
اجباری |
نمونه پاسخ دریافتی:
{ "result": "success"}
نمونه کد زبان های برنامه نویسی:
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.parsaspace.com/v1/files/move",
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_RETURNTRANSFER=>true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "source=/2Ftest-3 &destination=/2Ftest-1/2Ftest-3 &domain=yourdomain&type=json",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer yourtoken",
"cache-control: no-cache",
"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;
}
.header("content-type", "application/x-www-form-urlencoded")
.header("authorization", "Bearer yourtoken")
.body("source=/2Ftest-3 &destination=/2Ftest-1/2Ftest-3 &domain=yourdomain&type=json")
.asString();
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","/");
request.AddParameter("destinition","/");
IRestResponse response = client.Execute(request);
url = "http://api.parsaspace.com/v1/files/move"
payload = "source=/Ftest-3 &destination=/2Ftest-1/2Ftest-3 &domain=yourdomain.com&type=json"
headers = {
'content-type': "application/x-www-form-urlencoded",
'authorization': "Bearer yourtoken",
}
response = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
var options = { method: 'POST',
url: 'http://api.parsaspace.com/v1/files/move',
headers:
{ authorization: 'Bearer yourtoken',
'content-type': 'application/x-www-form-urlencoded' },
form:
{ source: '/test-3',
destination: '/test-1/test-3',
domain: 'yourdomain',
type: 'json' } };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
نمونه پاسخ ( خطاها ):
{
"result": "success",
}
{
"result": "error",
"message": "Object already exist.",
}
{
"result": "error",
"message": "Sorry!Access denied",
}
کپی کردن فایل مورد نظر در پوشه دلخواه.
آدرس (Url):
https://api.parsaspace.com/v1/files/copy
Method:
Post
اعتبارسنجی:
پارامترهای ارسالی:
Parameter | Entry In | Type | Description | Required |
---|---|---|---|---|
Authorization | Headers | Bearer yourtoken | Token ایجاد شده در حساب کاربری شما در پارسااسپیس | اجباری |
domain | Body | String | Each user can have multiple file or website, آدرس وب سایت ایجاد شده شما در پارسااسپیس | اجباری |
source | Body | String | امکان کپی یک یا چند فایل به طور همزمان. فایل ها باید با (,) از هم جدا شوند. مثال: /images/a.jpg,/music/1.mp3 |
اجباری |
destination | Body | String |
آدرس مسیری که فایل ها در آن کپی می شوند مثال: /newfolder |
اجباری |
نمونه پاسخ دریافتی:
{ "result": "success"}
نمونه کد زیان های برنامه نویسی:
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.parsaspace.com/v1/files/copy",
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_RETURNTRANSFER=>true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "domain=yourdomain&type=json&source=/2Fa&destination=/2Fb",
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;
}
.header("content-type", "application/x-www-form-urlencoded")
.header("authorization", "Bearer yourtoken")
.body("yourdomain&type=json&source=/2Fa&destination=/2Fb")
.asString();
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","/");
request.AddParameter("destinition","/");
IRestResponse response = client.Execute(request);
url = "http://api.parsaspace.com/v1/files/copy"
payload = "yourdomain&type=json&source=/2Fa&destination=/2Fb"
headers = {
'content-type': "application/x-www-form-urlencoded",
'authorization': "Bearer yourtoken",
}
response = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
var request = require("request");
var options = { method: 'POST',
url: 'http://api.parsaspace.com/v1/files/copy',
headers:
{
authorization: 'Bearer yourtoken' },
form:
{ domain: 'yourdomain',
type: 'json',
source: '/a',
destination: '/b' } };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
نمونه پاسخ ( خطاها ):
{
"result": "success",
}
{
"result": "error",
"message":"can not copy file",
}
{
"result": "error",
"message": "Object already exist.",
}
{
"result": "error",
"message": "Sorry!Access denied",
}
ساخت پوشه جدید با مسیر یا نام دلخواه.
آدرس (Url):
https://api.parsaspace.com/v1/files/createfolder
Method:
Post
اعتبارسنجی:
پارامترهای ارسالی:
Parameter | Entry In | Type | Description | Required |
---|---|---|---|---|
Authorization | Headers | Bearer yourtoken | Token ایجاد شده در حساب کاربری شما در پارسااسپیس | اجباری |
domain | Body | String | آدرس وب سایت ایجاد شده شما در پارسااسپیس | اجباری |
path | Body | String | آدرس ایجاد شدن پوشه جدید . به صورت پیش فرض مسیر root (مسیر اصلی) می باشد. | اختیاری |
نمونه پاسخ دریافتی:
{"result":"success"}
نمونه کد زیان های برنامه نویسی:
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.parsaspace.com/v1/files/createfolder",
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_RETURNTRANSFER=>true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "path=/hello&domain=yourdomain&type=json",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer yourtoken",
"cache-control: no-cache",
"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;
}
.header("content-type", "application/x-www-form-urlencoded")
.header("authorization", "Bearer yourtoken")
.body("path=/hello&yourdomain&type=json")
.asString();
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","/");
IRestResponse response = client.Execute(request);
url = "http://api.parsaspace.com/v1/files/createfolder"
payload = "path=/hello&yourdomain&type=json"
headers = {
'content-type': "application/x-www-form-urlencoded",
'authorization': "Bearer yourtoken",
}
response = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
var options = { method: 'POST',
url: 'http://api.parsaspace.com/v1/files/createfolder',
headers:
{
authorization: 'Bearer yourtoken',
'content-type': 'application/x-www-form-urlencoded' },
form: { path: '/hello', domain: 'yourdomain', type: 'json' } };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
نمونه پاسخ ( خطاها ):
{
"result": "ok,
}
{
"result": "error" ,
"message": "Object already exist.",
}
{
"result": "error" ,
"message": "Sorry!Access denied",
}
آپلود فایل جدید در مسیر دلخواه.
شما می توانید چندین فایل را همزمان در یک درخواست آپلود نمائید. فقط به خاطر داشته باشید که حداکثر حجم فایل جهت آپلود در یک درخواست 2GB می باشد. جهت آپلود فایلهای با حجم بالا از FTP استفاده کنید
آدرس (Url):
https://api.parsaspace.com/v1/files/upload
Method:
Post
اعتبارسنجی:
پارامترهای ارسالی:
Parameter | Entry In | Type | Description | Required |
---|---|---|---|---|
Authorization | Headers | Bearer yourtoken | Token ایجاد شده در حساب کاربری شما در پارسااسپیس | اجباری |
domain | Body | String | آدرس وب سایت ایجاد شده شما در پارسااسپیس | اجباری |
path | Body | String | آدرس (مسیر) آپلود فایل ها درآن. به صورت پیش فرض مسیر اصلی (root) می باشد | اختیاری |
file | Body | file | فایل | اجباری |
نمونه پاسخ دریافتی:
{"result":"success" ,"downloadLink":"file uploaded link"}
نمونه کد زبان های برنامه نویسی:
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.parsaspace.com/v1/files/upload",
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_RETURNTRANSFER=>true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"file\"; filename=\" yourfilename \"\r\nContent-Type: text/plain\r\n\r\n\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"domain\"\r\n\r\n yourdoamin \r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"path\"\r\n\r\n/\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer yourtoken",
"cache-control: no-cache",
"content-type: multipart/form-data; boundary=---011000010111000001101001",
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
.header("authorization", "Bearer yourtoken")
.header("content-type", "("content-type", "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW")
.body("------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"file\"; filename=\"yourfilename \"\r\nContent-Type: text/plain\r\n\r\n\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"domain\"\r\n\r\n yourdomain \r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"path\"\r\n\r\n/\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--")
.asString();
var request = new RestRequest(Method.POST);
request.AddHeader("authorization","Bearer yourtoken");
request.AddHeader("content-type", "multipart/form-data");
request.AddParameter("domain","yourdomain");
request.AddParameter("path","/");
request.AddFile("file",yourfile);
IRestResponse response = client.Execute(request);
url = "http://api.parsaspace.com/v1/files/upload"
payload = ""------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"file\"; filename=\" yourfilename \"\r\nContent-Type: text/plain\r\n\r\n\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"domain\"\r\n\r\n yourdoamin \r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"path\"\r\n\r\n/\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--""
headers = {
'content-type': "multipart/form-data; boundary=---011000010111000001101001",
'authorization': "Bearer yourtoken" }
response = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
var request = require("request");
var options = { method: 'POST',
url: 'http://api.parsaspace.com/v1/files/upload',
headers:
{
'content-type': 'multipart/form-data; boundary=---011000010111000001101001',
authorization: 'youre token' },
formData:
formData:{ file: { value: 'fs.createReadStream(" ")',options:{ filename: 'yourfilename',contentType: null } }, domain: 'yourdomain', path: '/' } };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
نمونه پاسخ (خطاها):
{
"result": "success",
}
{
"result": "error",
"message": "Object already exist.",
}
{
"result": "error",
"message": "Sorry!Access denied.",
}
آپلود فایل به طور مستقیم در مسیر دلخواه .
با استفاده از این قابلیت می توانید فایل های خود را به طور مستقیم روی مسیر مورد نظر خود آپلود کنید ، برای مثال اگر کاربران شما ، ابتدا فایل خود را روی سایت شما آپلود می کنند و سپس شما فایل مورد نظر را روی پارسا اسپیس آپلود می کنید ، به جای این کار می توانید درخواست آپلود فایل کاربران را به طور مستقیم به پارسا اسپیس ارسال کنید .
برای این کار ابتدا باید از متد زیر token جهت آپلود فایل و آدرس url جهت ارسال فایل دریافت نمائید ، سپس فایل مورد نظر خود را از طریق token دریافتی به url دریافت شده ارسال کنید .
آدرس (Url):
https://api.parsaspace.com/v1/auth/uploadtoken
Method:
Post
اعتبارسنجی:
پارامترهای ارسالی:
Parameter | Entry In | Type | Description | Required |
---|---|---|---|---|
Authorization | Headers | Bearer yourtoken | Token ایجاد شده در حساب کاربری شما در پارسااسپیس | اجباری |
domain | Body | String | آدرس وب سایت ایجاد شده شما در پارسااسپیس | اجباری |
remoteip | Body | String | آدرس ip کاربر | اجباری |
path | Body | String | آدرس (مسیر) آپلود فایل ها درآن. به صورت پیش فرض مسیر اصلی (root) می باشد | اختیاری |
نمونه پاسخ دریافتی:
{ "result": "success", "token": "cnlLRmQ1ZGZFcmZDdTNxeGlYZazNxdVZWamVsOWxsNXJaRWlHSjgwOWxEVVB0Z0RKVExoZSxnVWRLKzZ0US9yYWxXeFhyZ2U3N1FnPT0sRlFTaHpyc3IyMW5IeXhrTUhYbkorQT09LHc2QTJWOVZXc0lJWWpRQ0sxNDRRRnc9PSxpVElhd3lFcW5id3oyWEU5c1BVdnRLUnBwZWJnSm5qSm9JeDV6cGpybUQwPSxWczlpc3FyMWFHcWlUTVNpNTJhNGpzeEhBUFFJOGthVnM4b21ndDZEZGV3PSxkUk1lL2tKQkl3Z2VidDM3bzN1cEV3PT0=", "url": "https://asiatech-upload.parsaspace.com/user_upload" }
نمونه کد زبان های برنامه نویسی:
var request = new RestRequest(Method.POST);
request.AddHeader("cache-control", "no-cache");
request.AddHeader("content-type", "multipart/form-data");
request.AddHeader("authorization", "Bearer yourtoken");
request.AddParameter("application/x-www-form-urlencoded", "path=/2F&domain=yourdomain&remoteip=2.187.25.20", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
نمونه پاسخ (خطاها):
{
"result": "success",
}
{
"result": "error",
"message": "Object already exist.",
}
{
"result": "error",
"message": "Sorry!Access denied.",
}
اکنون برای آپلود مستقیم فایل باید فایل مورد نظر کاربر را به همراه token دریافتی به آدرس url دریافت شده ارسال کنید .
نمونه کد آپلود مستقیم:
<form action="https://asiatech-upload.parsaspace.com/user_upload" enctype="multipart/form-data" method="post" > <input type="hidden" name="token" value="your token"> <input type="file" name="file" > </form>