فضای برنامه

فهرست کلیدهای فضای برنامه

GEThttps://api.parsget.com/api/v1/app-storage

فقط OAuth

کلیدها و مقادیر ذخیره‌شده برنامه را برای کاربر فعلی دریافت کنید. هر کاربر در هر برنامه OAuth فضای جداگانه‌ای دارد. میزان مصرف و سقف مجاز در meta.quota آمده است؛ حداکثر ۲۵۶ کلید و در مجموع ۵ MiB.

Parameters

Field	Type	Description
`limit`	`integer · query`optional default `50`min 1max 100	تعداد موارد در هر صفحه؛ پیش‌فرض ۵۰ و حداکثر ۱۰۰ مورد.
`cursor`	`string · query`optional	برای صفحه اول نفرستید. برای صفحه بعد، مقدار meta.next_cursor پاسخ قبلی را بدون تغییر بفرستید.

Response schema

200فهرست مقادیر و اطلاعات سهمیه

Payloadobject[]

Field	Type	Description
`key`	`string`	—
`value`	`any`	هر مقدار معتبر JSON
`version`	`integer` min 1	شماره نسخه مقدار ذخیره‌شده. برای جلوگیری از بازنویسی تغییرات هم‌زمان، ETag هدر پاسخ را در If-Match بفرستید. ETag را از این عدد نسازید.
`created_at`	`string`date-time	—
`updated_at`	`string`date-time	—

Metaobject

Field	Type	Description
`quota`	`object`
`keys_used`	`integer`	—
`keys_limit`	`integer` `256`	—
`bytes_used`	`integer`	—
`bytes_limit`	`integer` `5242880`	—

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

Example

{
  "data": [
    {
      "key": "player_preferences",
      "value": {
        "autoplay": false,
        "subtitle_language": "fa"
      },
      "version": 3,
      "created_at": "2026-08-30T12:00:00.000000Z",
      "updated_at": "2026-08-31T07:45:00.000000Z"
    }
  ],
  "meta": {
    "next_cursor": null,
    "has_more": false,
    "quota": {
      "keys_used": 1,
      "keys_limit": 256,
      "bytes_used": 43,
      "bytes_limit": 5242880
    }
  }
}