فایل‌های چندرسانه‌ای

حذف فایل

یک فایل آپلودشده را حذف می‌کند.

DELETE
https://api.payamras.ir/v1/YOUR_API_KEY/media/delete.json

پارامترها

نامنوعتوضیح
id الزامی Guid شناسه فایل.

نمونه درخواست

curl -X DELETE -G "https://api.payamras.ir/v1/YOUR_API_KEY/media/delete.json" \
  --data-urlencode "id=3f2b7c1e-9a4d-4e21-8b0f-6c5d2a1e9f30"

پاسخ

فیلدهای هر ردیف entries:

فیلدنوعتوضیح
id Guid شناسه فایل.
deleted Boolean true اگر حذف شد.
response.json
{
    "return": {
        "status": 200,
        "message": "تایید شد"
    },
    "entries": {
        "id": "3f2b7c1e-9a4d-4e21-8b0f-6c5d2a1e9f30",
        "deleted": true
    }
}

خطاهای رایج

علاوه بر خطاهای عمومی مثل 403 و 418، این متد ممکن است این کدها را در return.status برگرداند:

  • 808 شناسه فایل نامعتبر است.
  • 809 فایل پیدا نشد.