การนำเข้าวิดีโอจาก Https Url ผ่าน API

หากคุณมีไฟล์วิดีโอต้นฉบับ ที่สามารถดาวน์โหลดได้ผ่าน HTTPS Url ท่านสามารถนำไฟล์เข้าสู่ระบบ ByteArk Stream ได้โดยตรงผ่าน API โดยไม่ต้องอัปโหลดใหม่ ด้วยวิธีการดังนี้

1. ส่ง Request เพื่อร้องขอการสร้างวิดีโอ
2. รอจนกระทั่งวิดีโออัปโหลดสำเร็จและพร้อมใช้งาน

Authorization

API ที่กล่าวมาข้างต้นต้องส่ง HTTP Authorization Header ดังต่อไปนี้

Authorization: Bearer <personal_access_token_here>

คุณสามารถดูวิธีการนำ Personal Access Token มาใช้ได้จาก ที่นี่

ขั้นตอนที่ 1 - ส่ง Request เพื่อร้องขอการสร้างวิดีโอ

เริ่มต้นด้วยการส่ง HTTP Request แบบ POST พร้อมกับชื่อวิดีโอ

Request Endpoint

POST https://stream.byteark.com/api/v2/public/import-batch-actions/single-import-http

Request Parameters

Parameter	Type	Required	Description
projectKey	String	Required	Key ของโปรเจกต์ที่จะอัปโหลดวิดีโอเข้าไป
videos	[]Object	Required	ข้อมูลวิดีโอที่จะสร้าง โดยสามารถสร้างหลายๆ วิดีโอพร้อมๆ กันได้
videos.*.title	String	Required	ชื่อวิดีโอ
videos.*.source.uri	String	Required	url ของ video ที่ต้องการ import
videos.*.source.httpHeaders	[]Object	-	httpHeader ที่ต้องส่งไปหาก url ของ video ต้องการหากไม่มีสามารถใส่เป็น empty array ได้
presetId	String	-	ID ของพรีเซตที่ต้องการใช้สำหรับวิดีโอที่สร้างใหม่ สามารถเว้นว่างได้เพื่อใช้พรีเซตตั้งต้นของโปรเจกต์นั้นๆ

คุณสามารถดูวิธีการนำ projectKey มาใช้ได้จาก ที่นี่

คุณสามารถดู presetId ที่มีอยู่แล้วได้ในหน้า https://stream.byteark.com/${workspace-key}/manage/presets

Sample Request Parameters

{
  "projectKey": "your-project-key-here",
  "videos": [
    {
      "title": "Video 1 title here",
      "source": {
            "uri": "https://url/to/video",
            "httpHeaders": [{"key": "string", "value": "string"}]
        }
    },
   {
      "title": "Video 2 title here",
      "source": {
            "uri": "https://url/to/video",
            "httpHeaders": [{"key": "string", "value": "string"}]
        }
    }
  ]
}

Sample Response

[
  {
    "key": "RuguHtZPJYm4",
    "title": "Video 1 title here",
    "primaryPlaybackUrl": {
      name: "playback",
      hls: {
        name: "Adaptive Bitrate",
        url: "https://your-playback-domain/streams/VideoKey/playlist.m3u8"
      }
    }
  },
  {
    "key": "RuguHtZPJYm5",
    "title": "Video 2 title here",
    "primaryPlaybackUrl": {
      name: "playback",
      hls: {
        name: "Adaptive Bitrate",
        url: "https://your-playback-domain/streams/VideoKey/playlist.m3u8"
      }
    }
  }
]

ขั้นตอนที่ 2 - รอจนกระทั่งวิดีโอพร้อมใช้งาน

วิดีโอจะถูกประมวลผล คุณอาจจะรอให้วิดีโอพร้อมใช้งานโดย Polling Video API หรือใช้ Webhook (opens new window) โดยสามารถดูสถานะได้จาก field vod.processingInfo.state หากวิดีโอพร้อมใช้งานสถานะควรเป็น completed