podium logo

پاداسپیس- مدیریت فایل-پوشه

خدمت‌دهنده

بازارچه پادیوم

فراخوانی آزمایشی BETAاطلاعات مجموعه سرویس

مقدمه

سرویس اسپیس ، امکان استفاده‌ از بستر ابری پلتفرم پاد را برای مشتریان مهیا می‌سازد. این سرویس به صورت REST پیاده سازی شده‌است.

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

با استفاده از درخواست‌های HTTP می‌توان بر‌روی منابع کنش انجام‌داد.

 

پیش از شروع

  • URL فراخوانی سرویس­ها:

Production Server: https://api.pod.ir/srv/sc/nzh/doServiceCall

Sandbox Server:https://sandbox.pod.ir/srv/sc/nzh/doServiceCall

  • تمامی درخواست­ها با متد POST ارسال می­شوند.
  • فیلدهای زیر درHeader تمامی درخواست­ها ثابت است:

پارامتر

توضیحات

_token_

توکن کسب­وکاری دریافتی از پنل

_token_issuer_

مقدار ثابت "1"
  • فیلدهای زیر در بدنه‌ی تمامی درخواست‌ها ثابت است (با فرمت x-www-form-urlencoded):

پارامتر

توضیحات

scProductId

شناسه­‌ی سرویس مدنظر

scApiKey

راهنمای دریافت این پارامتر در این لینک موجود است.
  • علاوه بر موارد بالا که ثابت هستند، اگر سرویس نیاز به پارامتر دیگری داشته باشد در داکیومنت مربوطه ذکر شده است.
  • خروجی: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.

نکته:پس از درخواست سرویس به پادیوم، همکاران ما درخواستهای ارسالی را بررسی می‌کنند. در صورت عدم دریافت تایید کرد بر روی درخواست ارسالی ظرف یک روز کاری،به همکاران ما از طریق شماره تلفن (021-89518989) و یا در گروه واتس‌اپ اطلاع دهید تا دسترسی به سرویس موردنظر برای شما فعال شود.

 

مدیریت فایل

  • ساخت پوشه با یک درخواست

از این متد  برای ساخت چند پوشه با یک درخواست استفاده می­شود استفاده می­شود.

  • شماره سرویس : 2961324

پارامترهای ورودی:

directories

  مسیر مورد نظر که با / آغاز می‌شود و تمام می‌شود. (تمام پوشه­ ها­ی مسیر داده شده در صورت موجود نبودن ساخته می‌شوند.)

parentHash

هش پوشه والد

 پاسخ نمونه در صورت موفقیت‌آمیز بودن:

json

 

 

حذف قایل بازگشت فایل- پوشه

از این متد  برای انتقال فایل/پوشه به سطل بازیافت استفاده می­شود.

  • شماره سرویس : 2961325

پارامتر ورودی:

hash*

 هش فایل/پوشه برای انتقال به سطل بازیافت

 پاسخ نمونه در صورت موفقیت‌آمیز بودن:

json

 

 

انتقال فایل - پوشه

از این متد  برای انتقال فایل/پوشه به  مقصدی جدید استفاده می­شود.

  • شماره سرویس: 2961326

پارامترهای ورودی:

hash*

 هش فایل/پوشه برای انتقال

destFolderHash*

  هش پوشه مقصد

policyKeepPolicy

در صورت تکراری بودن فایل‌ها:

نگه داشتن هر دو KEPP

جایگزینی OVERWRITE

برای پوشه‌ها در صورت تکراری بودن فقط مقدار KEEP مورد قبول است.

مقدار پیش فرض: KEEP

 پاسخ نمونه در صورت موفقیت‌آمیز بودن:

json

 

 

گپی فایل - پوشه

از این متد برای کپی فایل/فولد استفاده می­شود.

  • شماره سرویس: 2961327

پارامترهای ورودی:

 hash

 هش فایل/پوشه برای کپی

destFolderHash

 هش پوشه مقصد

keepPolicyKeepPolicy

در صورت تکراری بودن: نگه داشتن هر دو keep  جایگزینی owerwrite

مقدار پیش فرض: KEEP

 پاسخ نمونه در صورت موفقیت‌آمیز بودن:

json

 

 

تغییر نام فایل - پوشه

از این متد برای تغییر نام فایل/پوشه استفاده می­شود.

نکته: هنگام تغییر نام فایل، اگر extension داده نشود، امکان تغییر icon فایل وجود دارد.

  • شماره سرویس : 2961328

پارامترهای ورودی:

 hash

 هش فایل/پوشه برای تغییر نام

 newName

نام جدید

پاسخ نمونه در صورت موفقیت‌آمیز بودن:

json

 

 

دریافت نسخه‌های فایل 

 

از این متد برای دریافت نسخه های یک فایل استفاده می­شود.

  • شماره سرویس: 2961329

پارامتر ورودی:

 hash

  هش فایل

 پاسخ نمونه در صورت موفقیت‌آمیز بودن:

json

 

 

 

دریافت id پست ساخته شده برای فایل

از این متد برای دریافت id پست ساخته شده برای فایل(در شبکه اجتماعی) استفاده می­شود.

  • شماره سرویس : 2961332

پارامترهای ورودی:

hash

  هش فایل 

password

رمز فایل مورد نظر

  پاسخ نمونه در صورت موفقیت‌آمیز بودن:

json

 

 

دریافت اطلاعات فایل- پوشه

از این متد برای دریافت اطلاعات فایل یا پوشه استفاده می­شود.

  • شماره سرویس : 2961732

پارامترهای ورودی:

hash

  هش فایل/پوشه

password

رمز فایل یا پوشه مورد نظر

 پاسخ نمونه در صورت موفقیت‌آمیز بودن:

 

json

 

 

دریافت مسیر پوشه- فایل (پوشه‌های والد)

از این متد برای دریافت همه­‌ی پوشه های والد یک پوشه/فایل استفاده می­شود.

  • شماره سرویس : 2961733

پارامترهای ورودی:

hash 

کد هش فایل یا پوشه 

password

رمز پوشه/فایل مورد نظر

 پاسخ نمونه درصورت موفقیت‎‌آمیز بودن:

json

 

 

بررسی وجود فایل- پوشه

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

  • شماره سرویس: 2961734

پارامترهای ورودی: 

hash

 هش پوشه محل بررسی

fileName

  نام فایل/پوشه برای بررسی

 پاسخ نمونه در صورت موفقیت‌آمیز بودن::

json

 

 

جستجو

از این متد  برای جستجو بین فایل و پوشه ها استفاده می­شود.

  • شماره سرویس : 2961735

پارامترهای ورودی: 

words

کلمات برای جستجو (باید با فاصله از یکدیگر جدا شوند)

title

نام فایل یا پوشه

type

نوع فایل vnd.podspace.folder,audio,video,image,text

after

ابتدای دوره زمانی مورد نظر                        (yyyy-MM-dd)

before

انتهای دوره زمانی مورد نظر                        (yyyy-MM-dd)

minSize

حداقل سایز مورد نظر

maxSize

حداکثر سایز مورد نظر

start

اندیس اولین فایل برای بازگردانی پیشفرض =0

size

تعداد آیتم برای بازگردانی پیشفرض =20

order

ترتیب نمایش نتایج  پیشفرض =NAME                        NAME,CREATED

desc

ترتیب صعودی/نزولی  پیشفرض =false

 

پاسخ نمونه در صورت موفقیت‌آمیز بودن:

{

  "status": 200,

  "path": "GET /api/files/search",

  "timestamp": "2021-02-24T09:14:27.329+0000",

  "result": {

    "list": [

      {

        "hash": "file or folder hash",

        "name": "new_name",

        "type": "application/octet-stream",

        "parentHash": "parent hash",

        "owner": {

      "username": "owner username",

      "name": "owner name",

      "ssoId": owner ssoid,

      "roles": [

        "USER_ROLE"

      ]

    },

    "uploader": {

      "username": "uploader username",

      "name": "uploader name",

      "ssoId": uploader ssoid,

      "roles": [

        "USER_ROLE"

      ]

    },

        "attributes": [],

        "created": 1614152117257,

        "updated": 1614154195460,

        "extension": "txt",

        "size": 8,

        "postId": 3694746,

        "version": 0,

        "thumbnail": "WITHOUT_THUMBNAIL"

      }

    ],

    "count": 1 // number of returned items

  },

  "reference": "0d8c8feb-b038-3c4b-b69d-038e4bfa1df3-cloudysky"

}

 

از این متد  برای فشرده سازی تعدادی فایلی و پوشه استفاده می­شود.

  • شماره سرویس : 2961736

 

پارامترهای ورودی:

name*

  نام جدید فولدر با پسوند zip

fileHashes

   لیستی از هش فایل‌ها 

folderHashes 

  لیستی از هش پوشه ها

destFolderHash

هش پوشه محل ایجاد فایل زیپ، بصورت پیش فرض محل آن پوشه اصلی است.

 

پاسخ نمونه در صورت موفقیت‌آمیز بودن:

{

  "status": 200,

  "path": "POST /api/files/compress",

  "timestamp": "2021-02-24T10:10:16.560+0000",

  "result": {

    "hash": "zip file hash",

    "name": "my_zip",

    "type": "application/octet-stream",

    "parentHash": "parent hash",

    "owner": {

      "username": "owner username",

      "name": "owner name",

      "ssoId": owner ssoid,

      "roles": [

        "USER_ROLE"

      ]

    },

    "uploader": {

      "username": "uploader username",

      "name": "uploader name",

      "ssoId": uploader ssoid,

      "roles": [

        "USER_ROLE"

      ]

    },

    "attributes": [],

    "created": 1614161418015,

    "updated": 1614161418015,

    "extension": "zip",

    "size": 3749802,

    "metaData": {},

    "version": 0,

    "thumbnail": "WITHOUT_THUMBNAIL"

  },

  "reference": "b4b3e4e7-9142-3101-ab57-33c6b65312af-cloudysky"

}

از این متد  برای استخراج فایلهای درون یک فایل فشرده استفاده می­شود.

  • شماره سرویس : 2961737

 

نکته: فایل و پوشه‌های فشرده شده، در قالب یک پوشه به نام فایل zip شده، استخراج میشود.

پارامترهای ورودی:

hash

  هش فایل فشرده مورد نظر.

destFolderHash

کد هش پوشه مقصد، به صورت پیش فرض در پوشه اصلی از حالت فشرده خارج می شود.

postProcess

انجام فرآیند‌های بعد از استخراج پیشفرض true

 

پاسخ نمونه در صورت موفقیت‌آمیز بودن:

{

  "status": 200,

  "path": "PUT /api/files/JVZ1UP8K1O2XK99E/extract",

  "timestamp": "2021-02-24T11:16:32.128+0000",

  "result": {

    "hash": "zip file hash",

    "name": "my_zip",

    "type": "application/vnd.podspace.folder",

    "parentHash": "parent hash",

    "owner": {

      "username": "owner username",

      "name": "owner name",

      "ssoId": owner ssoid,

      "roles": [

        "USER_ROLE"

      ]

    },

    "uploader": {

      "username": "uploader username",

      "name": "uploader name",

      "ssoId": uploader ssoid,

      "roles": [

        "USER_ROLE"

      ]

    },

    "attributes": [],

    "created": 1614165392486,

    "updated": 1614165392486

  },

  "reference": "22f5d2e7-2c63-3ca6-ad3e-01e7e8977658-cloudysky"

}

از این متد  برای دریافت فعالیت های یک پوشه/فایل استفاده می­شود.

  • شماره سرویس : 2961738

 

پارامتر ورودی:

hash

هش فایل/پوشه مورد نظر 

 

پاسخ نمونه در صورت موفقیت‌آمیز بودن:

{

  "status": 200,

  "path": "GET /api/files/4TMQLHEJY6EXI844/activities",

  "timestamp": "2021-02-24T08:10:34.671+0000",

  "result": [

    {

      "kind": "UPLOAD",

      "reference": "FILE",

      "creator": {

        "username": "creator username",

        "name": "creator name",

        "ssoId": creator ssoid,

        "roles": [

          "USER_ROLE"

        ]

      },

      "entity": {

        "hash": "file/folder hash",

        "name": "new_name",

        "type": "application/octet-stream",

        "parentHash": "parent hash",

        "owner": {

      "username": "owner username",

      "name": "owner name",

      "ssoId": owner ssoid,

      "roles": [

        "USER_ROLE"

      ]

    },

    "uploader": {

      "username": "uploader username",

      "name": "uploader name",

      "ssoId": uploader ssoid,

      "roles": [

        "USER_ROLE"

      ]

    },

        "attributes": [],

        "created": 1614152117257,

        "updated": 1614154195460,

        "extension": "txt",

        "size": 8,

        "postId": 3694746,

        "version": 0,

        "thumbnail": "WITHOUT_THUMBNAIL"

      },

      "created": 1614152117264

    },

    {

      "kind": "RENAME",

      "reference": "FILE",

      "creator": {

        "username": "creator username",

        "name": "creator name",

        "ssoId": creator ssoid,

        "roles": [

          "USER_ROLE"

        ]

      },

      "entity": {

        "hash": "file/folder hash",

        "name": "new_name",

        "type": "application/octet-stream",

        "parentHash": "parent hash",

        "owner": {

      "username": "owner username",

      "name": "owner name",

      "ssoId": owner ssoid,

      "roles": [

        "USER_ROLE"

      ]

    },

    "uploader": {

      "username": "uploader username",

      "name": "uploader name",

      "ssoId": uploader ssoid,

      "roles": [

        "USER_ROLE"

      ]

    },

        "attributes": [],

        "created": 1614152117257,

        "updated": 1614154195460,

        "extension": "txt",

        "size": 8,

        "postId": 3694746,

        "version": 0,

        "thumbnail": "WITHOUT_THUMBNAIL"

      },

      "created": 1614154195460

    }

  ],

  "reference": "e69644b7-41ae-3d14-81de-7ebb084edc61-cloudysky"

}

 از این سرویس برای دریافت حجم و تعداد فایل‌های موجود در پوشه استفاده می شود.

  • شماره سرویس : 2961739

 

{

  "results": [

    {

      "status": 200,

      "body": "{\"status\":200,\"path\":\"DELETE /api/files/EFO4KYCLVV8MNBMN\",\"timestamp\":\"2021-10-26T13:03:08.609+00:00\",\"result\":{\"hash\":\"EFO4KYCLVV8MNBMN\",\"name\":\"Screenshot from 2019-12-24 15-41-53\",\"type\":\"image/png\",\"parentHash\":\"NDM6YZRKHEW2VOOM\",\"owner\":{\"username\":\"PodspaceUser\",\"name\":\"کاربر پاداسپیس\",\"ssoId\":10123456,\"roles\":[\"USER_ROLE\"]},\"uploader\":{\"username\":\"PodspaceUser\",\"name\":\"کاربر پاداسپیس\",\"ssoId\":10123456,\"roles\":[\"USER_ROLE\"]},\"attributes\":[],\"created\":1577716098755,\"updated\":1635253388627,\"extension\":\"png\",\"size\":100337,\"tags\":[],\"postId\":2105659,\"version\":0,\"thumbnail\":\"THUMBNAIL_EXIST\"},\"reference\":\"4de6d239-be66-38bd-944a-5737cf3ab558-cloudysky\"}",

      "headers": {

        "Date": "Tue, 26 Oct 2020 10:03:08 GMT",

        "Content-Type": "application/json;charset=UTF-8",

        "Vary": "Accept-Encoding",

        "version": "v3",

        "Access-Control-Allow-Headers": "Origin, Content-type, Accept, Authorization",

        "Access-Control-Allow-Credentials": "true",

        "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS, HEAD",

        "X-Powered-By": "FanapSoft/PodPlatform (Space Server v3.14.4.0 #cloudysky)",

        "X-Content-Type-Options": "nosniff",

        "X-XSS-Protection": "1; mode=block",

      },

      "payload": "EFO4KYCLVV8MNBMN"

    },

    {

      "status": 200,

      "body": "{\"status\":200,\"path\":\"DELETE /api/files/7E5GKPK6GHXVALZ7\",\"timestamp\":\"2021-10-26T13:03:08.667+00:00\",\"result\":{\"hash\":\"7E5GKPK6GHXVALZ7\",\"name\":\"Screenshot_2020-01-21 16-09-59\",\"type\":\"image/png\",\"parentHash\":\"NDM6YZRKHEW2VOOM\",\"owner\":{\"username\":\"PodspaceUser\",\"name\":\"کاربر پاداسپیس\",\"ssoId\":10123456,\"roles\":[\"USER_ROLE\"]},\"uploader\":{\"username\":\"PodspaceUser\",\"name\":\"کاربر پاداسپیس\",\"ssoId\":10123456,\"roles\":[\"USER_ROLE\"]},\"attributes\":[],\"created\":1579610361329,\"updated\":1635253388685,\"extension\":\"png\",\"size\":5333,\"tags\":[],\"postId\":2134792,\"version\":0,\"thumbnail\":\"THUMBNAIL_EXIST\"},\"reference\":\"774a039c-b33c-3862-89d5-5326578c2210-cloudysky\"}",

      "headers": {

        "Date": "Tue, 26 Oct 2020 10:03:08 GMT",

        "Content-Type": "application/json;charset=UTF-8",

        "Vary": "Accept-Encoding",

        "version": "v3",

        "Access-Control-Allow-Headers": "Origin, Content-type, Accept, Authorization",

        "Access-Control-Allow-Credentials": "true",

        "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS, HEAD",

        "X-Powered-By": "FanapSoft/PodPlatform (Space Server v3.14.4.0 #cloudysky)",

        "X-Content-Type-Options": "nosniff",

        "X-XSS-Protection": "1; mode=block",

      },

      "payload": "7E5GKPK6GHXVALZ7"

    }

  ]

}

پاسخ نمونه در صورت موفقیت‌آمیز بودن:

{

    "hasError": false,

    "referenceNumber": "3480590",

    "errorCode": 0,

    "count": 0,

    "ott": "aa65ad463b02e641",

    "result": {

        "size": 92366,

        "count": 5

    }

}

از این متد برای دریافت لیست فایل‌ها و فولدر‌های حذف شده توسط کاربراستفاده می‌شود.

  • شماره سرویس : 2961741

 

پارامترهای ورودی: 

offset

 شماره اولین آیتم

size 

 تعداد آیتم بازگشتی

order

  ترتيب نمايش (name, created, updated, size, type)

desc

  ترتیب نمایش صعودی / نزولی.به صورت پیش فرض صعودی در نظر گرفته می شود.

 

پاسخ نمونه در صورت موفقیت‌آمیز بودن:

{

    "hasError": false,

    "referenceNumber": "371958",

    "errorCode": 0,

    "count": 1,

    "ott": "a2ef2ee6d96f619",

    "result": {

        "ownerId": 1942,

        "name": "__trash__",

        "bookmarked": false,

        "files": [

            {

                "hash": "SL3R8PXP4RYJS5R3",

                "ownerId": 0,

                "created": 1538814684087,

                "updated": 1538815352874,

                "folderHash": "4VBBZM3TO5NRAWL2",

                "name": "icon (1)",

                "extension": "png",

                "size": 11822,

                "type": "image/jpeg",

                "uploaderId": 0,

                "bookmarked": false,

                "share": false,

                "public": false

            }

        ],

        "subFolders": []

    }

}

با استفاده از این متد می‌توان لیست تغییرات اعمال شده بر روی فایل یا فولدر را مشاهده نمود.

  • شماره سرویس : 2961742

 

به عنوان ورودی نیز hash را دریافت می‌کند.

پارامتر ورودی:

hash

  هش فایل یا فولدر موردنظر 

 

پاسخ نمونه در صورت موفقیت‌آمیز بودن:

{

    "hasError": false,

    "referenceNumber": "791209",

    "errorCode": 0,

    "count": 2,

    "ott": "2654c37b7e7863f2",

    "result": [

        {

            "id": 37933,

            "kind": "CREATE",

            "reference": "FOLDER",

            "folder": {

                "hash": "J7CDF7P393MNS3RA",

                "ownerId": 0,

                "created": 1556435281431,

                "updated": 1556435281431,

                "canTrashByUser": false,

                "name": "abcfffdds",

                "public": false,

                "shared": false,

                "bookmarked": false

            },

            "created": 1556435281572

        },

        {

            "id": 37934,

            "kind": "SHARE",

            "reference": "FOLDER",

            "folder": {

                "hash": "J7CDF7P393MNS3RA",

                "ownerId": 0,

                "created": 1556435281431,

                "updated": 1556435281431,

                "canTrashByUser": false,

                "name": "abcfffdds",

                "public": false,

                "shared": false,

                "bookmarked": false

            },

            "created": 1556435352565

        }

    ]

}

 از این متد برای جست‌و‌جو در فایل‌ها و فولدر‌ها استفاده می‌شود.

  • شماره سرویس : 47866

پارامترهای ورودی:

words 

 کلمات مورد جستجو

title

  نام فایل 

type

  نوع فایل document/image/video/audio/folder

after

  تاریخ شروع بازه (فرمت: yyyy-MM-dd)

before

 تاریخ پایان بازه (فرمت: yyyy-MM-dd)

minsize

  حداقل سایز فایل

maxsize

  حداکثر سایز فایل

size

  تعداد آیتم بازگشتی

offset

  شماره اولین آیتم

order

 ترتیب نمایش (name, created, updated, size, type)

desc

  ترتيب نمايش صعودي(false) پیش‌فرض / نزولي (true)    

 

پاسخ نمونه در صورت موفقیت‌آمیز بودن::

{

    "hasError": false,

    "referenceNumber": "793621",

    "errorCode": 0,

    "count": 2,

    "ott": "ff38f93ef9cfd567",

    "result": [

        {

            "hash": "ZNEI4THEAJ3H6TLD",

            "ownerId": 2101,

            "created": 1541321390135,

            "updated": 1541321390135,

            "folderHash": "5XU7XQV9NCHY1CBM",

            "name": "aa",

            "size": 0,

            "type": "folder",

            "uploaderId": 0,

            "canTrashByUser": false,

            "public": false,

            "share": false,

            "bookmarked": false

        },

        {

            "hash": "PINHIYLNN9XGFVH2",

            "ownerId": 2101,

            "created": 1540205117847,

            "updated": 1540205117847,

            "folderHash": "XZ2ZG3HN63RASYED",

            "name": "aa",

            "size": 0,

            "type": "folder",

            "uploaderId": 0,

            "canTrashByUser": false,

            "public": false,

            "share": false,

            "bookmarked": false

        }

    ]

}

 

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

  • شماره سرویس : 48135

پارامترهای ورودی:

 offset

 شماره اولین ایتم

size

 تعداد ایتم بازگشتی

desc

 ترتیب نمایش صعودی / نزولی.به صورت پیش فرض صعودی در نظر گرفته می شود.

پاسخ نمونه در صورت موفقیت‌آمیز بودن:

{

    "hasError": false,

    "referenceNumber": "794104",

    "errorCode": 0,

    "count": 1,

    "ott": "a11cb58efdcdb814",

    "result": [

        {

            "id": 38043,

            "kind": "UNSHARE",

            "reference": "FILE",

            "file": {

                "hash": "A15J4LAF6JPBJMVP",

                "ownerId": 2101,

                "created": 1556109009658,

                "updated": 1556365541358,

                "folderHash": "GS5COQ7SP8ZEO27R",

                "name": "test100",

                "size": 659,

                "type": "application/octet-stream",

                "uploaderId": 0,

                "uploaderUsername": "test_10",

                "canTrashByUser": true,

                "public": true,

                "share": true,

                "bookmarked": false

            },

            "created": 1556364541159

        }

    ]

}

از این متد برای دریافت اطلاعات فضای ذخیره‌سازی استفاده می‌شود.

  • شماره سرویس : 48136

پارامتر ورودی:

 _token_ *

  توکنی که بعد از ورود به سیستم یا از پنل کسب‌و‌کار دریافت شده‌است

پاسخ نمونه در صورت موفقیت‌آمیز بودن:

{

    "hasError": false,

    "referenceNumber": "794035",

    "errorCode": 0,

    "count": 0,

    "ott": "84a5f6189bf69e7",

    "result": {

        "total": 27409146,

        "fileSize": 27179275,

        "trashSize": 0,

        "historySize": 229871

    }

}

از این‌ متد برای جایگزین‌کردن نسخه‌های قبلی یک‌ فایل استفاده می‌شود.به‌عنوان ورودي fileHash را دريافت مي‌کند.

  • شماره سرویس : 48137

پارامتر ورودی:

 fileHash

  کد هش فایل مورد نظر 

 

پاسخ نمونه درصورت موفقیت‌آمیز بودن:

{

    "hasError": false,

    "referenceNumber": "794013",

    "errorCode": 0,

    "count": 0,

    "ott": "3171a7154d5cdddb",

    "result": {

        "id": 8433,

        "hash": "RR96KBXVXJWNM1WX",

        "ownerId": 2101,

        "created": "2019-04-27 16:15:41.17",

        "updated": "Sat Apr 27 16:16:10 IRDT 2019",

        "createdStamp": 1556365541170,

        "updatedStamp": 1556365570901,

        "folderHash": "GS5COQ7SP8ZEO27R",

        "name": "test100",

        "size": 659,

        "type": "application/octet-stream",

        "uploaderId": 2101,

        "metaData": "{\"tags\":[]}",

        "version": 2,

        "canTrashByUser": false,

        "sharesVO": [],

        "trashed": false,

        "trashedByHash": false,

        "public": false,

        "share": false,

        "bookmarked": false

    }

}

 

 

کدهای خطای سرویس

 

400

INVALID_REQUEST

درخواست نامعتبر

400

INVALID_HASH_TYPE

هش نادرست

400

INVALID_DATA

داده ورودی نامعتبر

400

CANNOT_BOOKMARK_DELETED_ENTITY

نشان گذاری فایل حذف شده

400

INVALID_SSO_TYPE

مرکز sso نامعتبر

400

INVALID_REDIRECT_URI

آدرس بازگشت نامعتبر

400

INVALID_HASH

هش نامعتبر

400

INVALID_NAME

نام نامعتبر

400

INVALID_AUTHENTICATION_INFORMATION

اطلاعات کاربری نامعتبر

400

INVALID_SORT_PROPERTY

پارامتر مرتب سازی نامعتبر

400

LAST_FILE_VERSION

عدم امکان بازگشت به نسخه آخر

 

400

INVALID_EXPIRATION_DATE

تاریخ انقضای اشتباه

400

INVALID_DATE

تاریخ نامعتبر

400

INVALID_DATE_FORMAT

فرمت نامعتبر تاریخ

400

             INVALID_DATE_FORMAT_YYMMDD

فرمت نامعتبر تاریخ

400

INVALID_DATE_INTERVAL

بازه تاریخی اشتباه

400

INVALID_PHONE_NUMBER

شماره موبایل اشتباه

400

INVALID_NATIONAL_CODE

فرمت اشتباه کد ملی

400

INVALID_PAGINATION_PARAM

پارامتر های صفحه بندی نامعتبر

400

INVALID_PAGINATION_SIZE

پارامتر size غیرمجاز

400

INVALID_FOLDER_DEPTH

عمق پوشه غیر مجاز

400

INVALID_FILTER_PARAMETER

پارامتر فیلتر نامعتبر

400

INVALID_FILE_SIZE

تعداد فایلهای بیش از حد مجاز

400

INVALID_FOLDERTREE_SIZE

اندازه بیش از حد درخت پوشه

400

INVALID_FOLDER_FORMAT

فرمت مسیر (directory) نادرست

 کپی یا انتقال غیرمجاز

400

MOVE_INSIDE_ITS_OWN

انتقال پوشه  داخل خودش

400

MOVE_INSIDE_ITS_SUBFOLDER

انتقال پوشه داخل پوشه های فرزند خودش

400

COPY_INSIDE_ITS_OWN

کپی پوشه درون خودش

400

 COPY_INSIDE_ITS_SUBFOLDER

کپی پوشه داخل پوشه های فرزند خودش

 درخواست های نامعتبر

400

DUPLICATE_NAME

نام تکراری در پوشه

400

ONLY_TRASHED_ENTITIES_CAN_BE_WIPED

عدم امکان حذف دائمی فایل های trash نشده

400

FILE_NOT_SENT

فایل ارسال نشده

400

ENTITY_BEEN_SHARED

اشتراک گذلری تکراری

400

INVALID_PLAN_ID

شناسه طرح نادرست

400

INVALID_PLAN_DATE

خرید طرح با زمان کمتر از طرح فعلی

400

INVALID_BILL_NUMBER

فاکتور کنسل شده

400

SSO_INVALID_REQUEST

کد تایید نامعتبر

 مربوط به فضای ذخیره سازی

402

INSUFFICIENT_SPACE

عدم وجود فضای کافی

402

PAYMENT_REQUIRED

نیاز به خرید طرح

 دسترسی های غیرمجاز

403

WRONG_PASSWORD

رمز نادرست

403

FORBIDDEN

دسترسی غیرمجاز

403

SHARE_FORBIDDEN

عدم دسترسی برای اشتراک گذلری

 پیدا نشدن منابع

404

NOT_FOUND

عدم وجود درخواست

404

ENTITY_NOT_FOUND

عدم وجود فایل یا پوشه

404

FILE_NOT_FOUND

عدم وجود فایل

404

FOLDER_NOT_FOUND

عدم وجود پوشه

404

SHARE_NOT_FOUND

عدم وجود اشتراک گذاری

404

USERGROUP_NOT_FOUND

عدم وجود گروه کاربری

404

USER_NOT_FOUND

عدم وجود کاربر

404

DESTINATION_FOLDER_NOT_FOUND

عدم وجود پوشه مقصد

404

THUMBNAIL_NOT_FOUND

عدم وجود تصویر شاخص

404

PLAN_NOT_FOUND

عدم وجود طرح

404

BILL_NUMBER_NOT_FOUND

عدم وجود شناسه کسب و کاری فاکتور

404

AVATAR_NOT_FOUND

عدم وجود آواتار

404

METADATA_KEY_NOT_FOUND

عدم وجود کلید داده شده

404

METADATA_KEYS_NOT_FOUND

عدم وجود کلیدهای داده شده

404

NOT_FOUND_PLATFORM

عدم وجود پلتفرم

404

STREAMER_NOT_FOUND

عدم وجود استریمر فعال

404

BUSINESS_NOT_FOUND

عدم وجود کسب و کار

404

UPLOAD_KEY_NOT_FOUND

عدم وجود کلید آپلود

404

ENTITY_IS_REMOVED

فایل یا پوشه حذف شده

 غیرقابل پذیرش

406

NAME_NOT_CHANGED

عدم تغیرنام

406

NOT_ACCEPTABLE

عدم قبول محتوای ارسالی

406

NOT_STREAMABLE

عدم امکانم استریم کردن فایل

 خطاهای دیگر

401

UNAUTHORIZED

عدم دسترسی

401

INVALID_AUTHORIZATION_TYPE

نوع احراز هویت نامعتبر

401

USER_GROUP_OWNER_UNAUTHORIZED

عدم دسترسی به گروه کاربری

401

FILE_OWNER_UNAUTHORIZED

عدم دسترسی به فایل

401

UPLOAD_KEY_HAS_BEEN_DELETED

کلید حذف شده

401

UPLOAD_KEY_DOES_NOT_EXIST

عدم وجود کلید

401

UPLOAD_KEY_IS_NOT_VALID

کلید نامعتبر

403

BUSINESS_IS_NOT_CONFIRMED

کسب و کار تایید نشده

403

NON_BUSINESSES_CANT_REQUEST_ACCESS

عدم امکان درخواست برای کاربران غیرکسبو کار

403

Bulk_API_INVALID_BATCH_API

عدم پشتیبانی url‌ از حالت batch

413

Bulk_API_PAYLOAD_TOO_LARGE

تعداد عملیات بیش از سقف مجاز

409

FILE_ALREADY_EXISTS

فایل قبلا ارسال شده

409

TEAM_ALREADY_EXIST

تیم قبلا ایجاد شده

409

BUSINESS_ACCESS_ALREADY_REQUESTED

درخواست دسترسی قبلا ارسال شده

 خطاهای داخلی

500

UNKNOWN_ERROR

خطای ناشناخته

501

MUST_IMPLEMENT

پیاده سازی نشده

502

BAD_GATEWAY

عدم توانایی برقراری ارتباط

 

 

Clasor npm package version 2.1.4
به پادیوم قدرت داده اند:
pasargad
fanap
pod