مرجع API متوافق مع S3

نظرة عامة

يوفر Memesplora API متوافقًا مع AWS S3، يمكن استخدام أي عميل متوافق مع S3 (مثل rclone و AWS CLI و MinIO Client) للوصول المباشر إلى مساحات التخزين.

نقطة النهاية

عنوان S3 API: http://localhost:5213

المصادقة

استخدام خوارزمية توقيع AWS Signature V4. يتم الحصول على Access Key و Secret Key من واجهة إدارة الويب.

API المدعومة

عمليات Bucket

العملية	HTTP	المسار
ListBuckets	GET	/
HeadBucket	HEAD	/{bucket}

عمليات الكائنات

العملية	HTTP	المسار
GetObject	GET	/{bucket}/{key}
PutObject	PUT	/{bucket}/{key}
DeleteObject	DELETE	/{bucket}/{key}
HeadObject	HEAD	/{bucket}/{key}
ListObjects	GET	/{bucket}
ListObjectsV2	GET	/{bucket}?list-type=2
DeleteObjects	POST	/{bucket}?delete
CopyObject	PUT	/{bucket}/{key} (x-amz-copy-source)

الرفع المجزأ (Multipart Upload)

العملية	HTTP	المسار
CreateMultipartUpload	POST	/{bucket}/{key}?uploads
UploadPart	PUT	/{bucket}/{key}?partNumber=&uploadId=
CompleteMultipartUpload	POST	/{bucket}/{key}?uploadId=
AbortMultipartUpload	DELETE	/{bucket}/{key}?uploadId=
ListParts	GET	/{bucket}/{key}?uploadId=

أمثلة الاستخدام

AWS CLI

aws configure --profile memesplora
aws s3 --endpoint-url http://localhost:5213 ls
aws s3 --endpoint-url http://localhost:5213 cp file.txt s3://my-space/
aws s3 --endpoint-url http://localhost:5213 ls s3://my-space/

rclone

rclone config  # اختر S3 Compatible
rclone copy file.txt memesplora:my-space/
rclone ls memesplora:my-space/

تفاصيل الهندسة المعمارية

يرجى الرجوع إلى هندسة بروتوكول S3 للاطلاع على التصميم التفصيلي.