فایل‌ها

پاک کردن داده‌های برنامه برای فایل یا پوشه

DELETEhttps://api.parsget.com/api/v1/files/{file}/state

فقط OAuth

داده‌هایی را که برنامه شما برای این کاربر و فایل یا پوشه ذخیره کرده، پاک کنید. خود فایل یا پوشه باقی می‌ماند. بدون هدر شرطی، حتی اگر داده‌ای ذخیره نشده باشد، پاسخ 204 می‌گیرید. برای حذف فقط در صورت تغییر نکردن داده‌ها، ETag پاسخ قبلی را در If-Match بفرستید. اگر داده‌ها تغییر کرده یا دیگر وجود نداشته باشد، پاسخ 412 می‌گیرید.

Parameters

Field	Type	Description
`file`	`string · path`required	شناسه یکتای فایل یا پوشه
`If-Match`	`string · header`optional	ETag پاسخ قبلی را کامل بفرستید تا حذف فقط در صورت تغییر نکردن داده‌ها انجام شود. با *، حذف فقط در صورت وجود داده‌ها انجام می‌شود.
`If-None-Match`	`string · header`optional	اگر ETag فعلی با مقدار ارسالی مطابقت داشته باشد، حذف انجام نمی‌شود و پاسخ 412 می‌گیرید. با *، وجود داده‌های ذخیره‌شده مانع حذف می‌شود.

Response schema

204داده‌ها پاک شده‌اند یا از قبل وجود نداشته‌اند. بدنه پاسخ خالی است.

پاسخ‌های خطاساختار استاندارد error

Example

{
  "error": {
    "code": "validation_failed",
    "message": "The request contains invalid fields.",
    "details": {
      "fields": {},
      "required_scopes": [
        "example"
      ]
    }
  }
}