جديدPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2انظر سجل التغيير →

التخزين

تخزين الملفات، مع إنجاز العمل على الصورة نيابةً عنك.

مجموعات البيانات والتحميلات والروابط الموقعة وتحويلات الصور السريعة من نفس SDK مثل بياناتك.

4
تنسيقات إخراج الصور
2,500 px
الحد الأقصى لحجم التحويل
storage.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
await aura.storage.createBucket('avatars', {
public: true,
fileSizeLimit: 5 * 1024 * 1024,
allowedMimeTypes: ['image/png', 'image/jpeg'],
})

ما هو مدرج

كل ما يحتاجه الملف . من التحميل إلى الصورة المصغرة.

التنظيم

دلاء مع القواعد

قم بتعيين حد للحجم وأنواع الملفات المسموح بها في كل مجموعة.

تحميل

تحميلات بسيطة

أرسل ملفًا بمكالمة واحدة، مع إمكانية الكتابة فوقه عندما تريد ذلك.

تحميل

فقاعة أو تيار

قم بتنزيل ملف بتنسيق Blob، أو قراءته كتدفق.

المشاركة

عناوين URL الموقعة

قم بمشاركة ملف خاص برابط تنتهي صلاحيته بعد الوقت الذي تختاره.

الدلاء العامة

العامة عندما تقول ذلك

يتم تقديم الملفات الموجودة في المجموعة العامة لأي شخص، بدون مفتاح API. احتفظ بالملفات الخاصة في دلو خاص.

الصور

تتحول الصورة على الفور

يمكنك تغيير حجم الصور واقتصاصها وتحويلها إلى JPEG أو PNG أو WebP أو GIF باستخدام خيارات URL. يتم تخزين النتائج مؤقتًا على الخادم.

ملفات

النسخ والنقل والقائمة

انسخ الملفات أو انقلها داخل مجموعة، وقم بإدراجها حسب البادئة وقراءة البيانات الوصفية.

السلامة

سلة المهملات قبل الحذف

تؤدي إزالة الملف إلى نقله إلى سلة المهملات. الحذف الدائم يحتاج إلى دور الخدمة.

جانب الخادم

التحميلات الموقعة من الخادم الخاص بك

قم بإنشاء عناوين URL للتحميل الموقعة مع دور الخدمة حتى يتمكن العملاء من التحميل دون الاحتفاظ بمفاتيحك.

كيف يعمل

من ملف إلى رابط.

  1. 1

    إنشاء دلو

    اختر عام أو خاص، والحد الأقصى للحجم والأنواع المسموح بها.

  2. 2

    تحميل

    أرسل الملف يقوم الخادم بإرجاع مفتاحه.

  3. 3

    شارك

    استخدم عنوان URL عامًا أو عنوان URL موقعًا تنتهي صلاحيته.

  4. 4

    تحويل

    أضف العرض أو الارتفاع أو التنسيق إلى عنوان URL للحصول على صورة مشتقة.

REST API

هل تفضل HTTP العادي؟ كل شيء هنا.

SDK عبارة عن طبقة رقيقة فوق هذه المسارات. أرسل مفتاح API الخاص بمشروعك مع كل طلب.

الطريقةنقطة النهايةالوصف
GET/v1/storage/bucketsقائمة الدلاء.
POST/v1/storage/bucketsإنشاء دلو.
PATCH/v1/storage/buckets/{id}قم بتحديث إعدادات الجرافة.
DELETE/v1/storage/buckets/{id}حذف دلو.
POST/v1/storage/{bucket}تحميل ملف يحتوي على بيانات نموذج متعددة الأجزاء.
GET/v1/storage/{bucket}/{key}قم بتنزيل ملف، تم تحويله اختياريًا.
DELETE/v1/storage/{bucket}/{key}حذف ملف.
GET/v1/storage/{bucket}/meta/{key}قراءة البيانات الوصفية للملف.
POST/v1/storage/{bucket}/copyانسخ ملفًا داخل مجموعته.
POST/v1/storage/{bucket}/moveانقل ملفًا داخل مجموعته.
GET/v1/storage/{bucket}/signed-urlقم بإنشاء عنوان URL للتنزيل لفترة محدودة.
GET/v1/storage/{bucket}/upload-urlأنشئ عنوان URL للتحميل المُوقّع. محفوظة لدور الخدمة.

أسئلة

من الجيد أن نعرف.

هل الدلو العام عام حقًا؟+
نعم. يمكن لأي شخص لديه عنوان URL تنزيل ملفاته، بدون مفتاح API. ضع فقط في دلو عام ما قد تضعه على الإنترنت المفتوح.
كيف يمكنني مشاركة ملف خاص لفترة من الوقت؟+
قم بإنشاء عنوان URL موقّع باستخدام createSignedUrl() ومدى الحياة بالثواني. يتوقف الرابط عن العمل عند انتهاء صلاحيته.
ما هو الحجم الذي يمكن أن يصل إليه تحويل الصورة؟+
يتم تحديد العرض والارتفاع عند 2500 بكسل. ينطبق إعداد الجودة على JPEG فقط.
هل يمكنني نسخ ملف إلى مجموعة أخرى؟+
ليس بعد. انسخ العمل وانقله داخل مجموعة واحدة.
هل التحميلات القابلة للاستئناف مدعومة؟+
لا، فكل عملية تحميل عبارة عن طلب واحد متعدد الأجزاء، لذا خطط للملفات التي تناسب طلبًا واحدًا.
هل يمكنني إيقاف تحويلات الصور؟+
نعم. تكون التحويلات قيد التشغيل بشكل افتراضي، ويمكن للمشروع تعطيلها. ثم يتم رفض الطلبات ذات التحويل.

هل أنت مستعد لتخزين الملفات؟

امنح ملفاتك منزلاً اليوم.

يتم تضمين التخزين في كل مشروع. لا حاجة لبطاقة الائتمان.