فایل‌ها

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

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

فقط OAuth

داده‌هایی را که برنامه شما برای این کاربر و فایل یا پوشه ذخیره کرده، دریافت کنید؛ برای مثال، موقعیت پخش ویدیو یا ترک صوتی انتخاب‌شده. اگر هنوز داده‌ای ذخیره نکرده باشید، پاسخ 200 با data=null می‌گیرید. فایل یا پوشه حذف‌شده یا خارج از دسترس، پاسخ 404 دارد. مجموع درخواست‌های خواندن، ذخیره و حذف داده‌ها برای هر کاربر در هر برنامه حداکثر ۱۲۰۰ درخواست در دقیقه است.

Parameters

Field	Type	Description
`file`	`string · path`required	شناسه یکتای فایل یا پوشه

Response schema

200داده‌های ذخیره‌شده دریافت شدند. اگر هنوز داده‌ای ذخیره نشده باشد، data=null است و هدر ETag ارسال نمی‌شود.

Payloadobject | null

Field	Type	Description
`value`	`Record<string, any>`	داده‌های دلخواه برنامه در قالب یک شیء JSON با حداکثر حجم ۶۴ KiB. فیلدهای داخل این شیء را خودتان تعیین می‌کنید.
`version`	`integer` min 1	—
`etag`	`string`	برای ارسال If-Match، این مقدار را کامل و همراه با علامت نقل‌قول کپی کنید. ETag را از روی version نسازید.
`created_at`	`string`date-time	—
`updated_at`	`string`date-time	—
`file_id`	`string`	—

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

Example

{
  "data": {
    "value": {
      "playback": {
        "position_seconds": 1234,
        "completed": false
      },
      "audio_track": 2
    },
    "version": 1,
    "etag": "\"01M1BDA500B4A6D9K3N5R7T8VC-1\"",
    "created_at": "2026-09-08T08:00:00.000Z",
    "updated_at": "2026-09-08T08:00:00.000Z",
    "file_id": "example"
  }
}