ذخیره یا ویرایش مقدار در فضای برنامه
https://api.parsget.com/api/v1/app-storage/{key}برای پیگیری درخواست در لاگها، یک شناسه بین ۱ تا ۱۰۰ کاراکتر بفرستید. اگر این هدر را نفرستید، سرور شناسه میسازد.
هدرهای استانداردمقدار JSON را در فیلد value بفرستید. اگر کلید وجود نداشته باشد، ایجاد میشود؛ در غیر این صورت، مقدار قبلی جایگزین میشود. حجم هر مقدار میتواند تا ۶۴ KiB باشد. ساختار JSON و فاصلههای داخل مقادیر متنی حفظ میشوند؛ {}، [] و null هم مقادیر متفاوتی هستند.
برای جلوگیری از بازنویسی تغییرات دستگاه دیگر، ETag آخرین پاسخ GET را در If-Match بفرستید. اگر مقدار از آن زمان تغییر کرده باشد، پاسخ 412 میگیرید. مقدار فعلی را دوباره دریافت کنید و تغییرات مورد نظرتان را بر اساس آن بفرستید.
ETag را کامل کپی کنید و از version نسازید. با حذف و ایجاد دوباره کلید هم ETag قبلی معتبر نمیشود. برای ایجاد کلید فقط در صورتی که از قبل وجود ندارد، If-None-Match: * بفرستید. بدون این هدرها، هر درخواست مقدار موجود را جایگزین میکند.
Parameters
| Field | Type | Description |
|---|---|---|
key | string · pathrequired | — |
If-Match | string · headeroptional | ETag پاسخ قبلی را کامل، همراه با علامت نقلقول، بفرستید. یک ETag یا فهرست ETagها پذیرفته میشود. مقدار * فقط وجود کلید را بررسی میکند. ETagهایی که با W/ شروع میشوند، با نسخه فعلی برابر در نظر گرفته نمیشوند. اگر شرط برقرار نباشد، پاسخ 412 و اگر قالب هدر نامعتبر باشد، پاسخ 400 میگیرید. |
If-None-Match | string · headeroptional | با مقدار *، کلید فقط در صورتی ایجاد میشود که از قبل وجود نداشته باشد. اگر کلید موجود باشد، پاسخ 412 میگیرید و مقدار قبلی حفظ میشود. |
Request body
| Field | Type | Description |
|---|---|---|
value | anyrequired | هر مقدار معتبر JSON (حداکثر ۶۵۵۳۶ بایت) |
Response schema
object| Field | Type | Description |
|---|---|---|
key | string | — |
value | any | هر مقدار معتبر JSON |
version | integermin 1 | شماره نسخه مقدار ذخیرهشده. برای جلوگیری از بازنویسی تغییرات همزمان، ETag هدر پاسخ را در If-Match بفرستید. ETag را از این عدد نسازید. |
created_at | stringdate-time | — |
updated_at | stringdate-time | — |
error