v2.livestream.create_session
POST /api/v2/livestream/create_session
Create a new live stream, include basic information, like cover, title, description, type (test live or normal live). (For TW, ID, TH, PH, MY, SG, VN)
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/livestream/create_session
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ. |
| user_id | int | 1 | Shopee's unique identifier for a user. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by(depends on different APIs) partner_id, api path, timestamp, access_token, user_id and partner_key via HMAC-SHA256 hashing algorithm. |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| title | string | True | test livestream | The title of livestream session, cannot exceed 200 characters. |
| description | string | False | test | The description of livestream session, cannot exceed 200 characters. |
| cover_image_url | string | True | https://cf.shopee.sg/file/id-11134104-7r98o-m9pq7jw2cdhx5e | The cover image URL of livestream session. Please call the v2.livestream.upload_image to upload the cover image file and get the cover_image_url. |
| is_test | boolean | False | false | Indicate whether the livestream session is for testing purpose only. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. | |
| request_id | string | e3e3e7f3360690a5b55f0689f8a4e801 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| response | object | Detail informations you are querying. | |
| session_id | int64 | 636732 | The identifier of livestream session. |