S3 อัปโหลดไฟล์

การจัดเก็บข้อมูลที่ไม่ใช่ ข้อมูลเชิงพื้นที่ เพื่อใช้สำหรับพัฒนาแผนที่หรือเว็บไซต์ ซึ่งในระบบ Vallaris Maps สามารถอัปโหลดไฟล์ ในรูปแบบ AWS S3 Storage

บน Vallaris Maps แพลตฟอร์มของคุณสามารถอัปโหลดไฟล์ โดยใช้ API Key หรือ Token เพื่อใช้ในการอัปโหลดไฟล์

การจัดเก็บข้อมูลถูกจัดเก็บอยู่ในรูปแบบ Single Bucket คือการจัดเก็บไว้ที่เดียว ในฐานข้อมูล ซึ่งในการจัดเก็บ ถูกแบ่งออกเป็น 2 คือ

• ไฟล์ส่วนตัว (Private files)
• ไฟล์สาธารณะ (Public files) โดยสามารถระบุได้เมื่อทำการสร้าง Presign Upload เพื่อสร้าง URL สำหรับการอัปโหลดไฟล์ และดาวน์โหลดไฟล์

info

ค่าเริ่มต้นอายุของลิงก์ (URL) Presign อัปโหลดเท่ากับ 1 ชั่วโมง (3600 วินาที)

สร้าง Presign Upload

curl --location 'https://app.vallarismaps.com/core/api/managements/1.1/files' \
--header 'API-Key;' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--data '{
    "fileName": "crazy-dog.jpg",
    "activeTime": 3600,
    "private": true,
    "path": "test-upload/dog-meme",
    "overwrite": true,
    "expiresIn": 99
}'

ตัวอย่างผลลัพธ์ (Response)

{
    "fileName": "private/666017ccc7d2df4b4111975a/main-foldername/sub-folder/example-file.jpg",
    "expiredAt": "2025-06-02T02:20:04.127686557Z",
    "uploadUrl": "https://app.vallarismaps.com/core/api/managements/1.1/files/presigned/vallaris/private/666017ccc7d2df4b4111975a/main-foldername/sub-folder/example-file.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=HtJTiC6nDfChWmXx%2F20250602%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20250602T012004Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&x-id=PutObject&X-Amz-Signature=12a094ecb64ca358e87b89d50e9f2dc95b1395feee15a12ad0c808f231065ea2",
    "downloadUrl": "https://app.vallarismaps.com/core/api/managements/1.1/files/683cfc440168f574fb9b5f5c/download"
}

Order	Name	Method	Path
1	Generate Presign	POST	/managements/1.1/files
2	Retreive file list	GET	/managements/1.1/files/my-storage
3	Upload	PUT	URL อัปโหลดที่ได้รับจากการสร้าง Presign
4	Download	GET	/managements/1.1/files/:fileId/download
5	Delete	DELETE	/managements/1.1/files/:fileId