Tạo bộ sticker

API hỗ trợ việc tạo mới một bộ sticker trên hệ thống PiScale.

HTTP request

POST https://{app_id}.api.piscale.com/sticker/v1.0/pack

Request header

Bảng mô tả tham số của request header:

Tên	Kiểu dữ liệu	Mô tả	Bắt buộc
X-Api-Key	string	API Key của ứng dụng	✓
X-Tenant-Id	string	Chỉ định tạo bộ sticker cho tenant nào (ID bên hệ thống của bạn), nếu không truyền thì bộ sticker sẽ được đánh dấu là global (dùng được cho tất cả các tenant)	✗

Request body

Content-Type: multipart/form-data

Tên	Kiểu dữ liệu	Mô tả	Bắt buộc
name	string	Tên của bộ sticker. Max 100 kí tự.	✓
icon	file	File ảnh icon của bộ sticker, chỉ chấp nhận file png.	✓
stickers	file	File zip chứa các file sticker bên trong. Chỉ chấp nhận các file sticker dạng png, gif, json, webp	✓

note

Mặc dù chúng tôi không giới hạn kích thước nhưng để đảm bảo trải nghiệm mượt mà và tiết kiệm băng thông cho người dùng, chúng tôi khuyến nghị dung lượng của mỗi ảnh sticker nên dưới 150KB. Độ phân giải đề xuất là 128x128 hoặc 160x160.

Responses

Nếu thành công, API này trả về dữ liệu như sau:

Status: 200 OK

{
  "data": {
    "id": "a0210a33-e322-412f-bf72-e383faca28d8",
    "name": "Frog Go In Love",
    "status": "uploading",
  },
  "message_code": "M200",
  "message": "Success"
}

Tên	Kiểu dữ liệu	Mô tả
message_code	string	Mã thông điệp. Xem chi tiết
message	string	Nội dung mã thông điệp
data	object	Thông tin bộ sticker đã được tạo
data.id	string	ID duy nhất của bộ sticker
data.name	string	Tên của bộ sticker
data.status	string	Trạng thái của bộ sticker. uploading hoặc uploaded