快速入門:Zencoder
Zencoder API
所有操作均使用 Zencoder API 執行。雖然有一個 Request Builder 可用於嘗試一些基本的 API 請求,但您可能很快就會轉向直接訪問 API。在本指南中,您可以修改和使用如下所示的 cURL 命令,或 REST API 客戶端,例如 Postman 。
如果您不熟悉 cURL,請參閱 設置 cURL 。
發出請求
提交工作的請求是傳送至下列地點的POST
要求:
https://app.zencoder.com/api/v2/jobs
必要的標頭
有兩個標頭必須隨請求一起發送:
Zencoder-Api-Key: YOUR_API_KEY
Content-Type: application/json
您可以通過訪問 https://app.zencoder.com/api獲取您的 API 密鑰。對於本練習,您可以使用完全訪問或僅集成密鑰。
更多信息
該請求可能(通常會)包括作業的輸出設置,包括輸出目的地、通知設置和轉碼設置。在這個簡單的練習中,我們將跳過它,但您可以在 編碼設置中找到更多信息。
我們目前支持使用 HTTP/HTTPS、S3、雲文件、FTP/FTPS、SFTP 和 Aspera下載文件。
一個簡單的新工作請求只需要在正文中指定輸入文件的 URL,加上您的帳戶API密鑰在一個名為Zencoder-Api-Key
.
{
"input": "s3://zencodertesting/test.mov"
}
您可以使用以下 cURL 命令對此進行測試。
curl --header "Zencoder-Api-Key: YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{"input":"s3://zencodertesting/test.mov"}' \
https://app.zencoder.com/api/v2/jobs
將此代碼複製到文本編輯器並將 YOUR_API_KEY 替換為您的 API 密鑰。然後打開命令提示符,在命令提示符處複製並粘貼 cURL 命令,然後按 Return (Enter)。
Windows 用戶注意事項:由於 Windows 上 cURL 的限制,您需要像雙引號一樣轉義\"
並將--data
內容包裝在雙引號而不是單引號中。
此請求將為該帳戶創建一個編碼作業,並嘗試將位於 s3://zencodertesting/test.mov 的文件下載並轉碼到默認輸出目標。
響應
當您通過 API 創建新的編碼作業時,我們的服務器將立即響應有關正在創建的作業和輸出文件的詳細信息。您應該存儲作業和輸出 ID,以便在編碼過程中跟踪它們。請注意,這id
是 64 位元範圍內的整數。
數據將以 JSON 格式返回。
上一個新的編碼工作範例會傳回下列內容,並包含201 Created
狀態碼。
{
"id": 366118847,
"outputs": [
{
"id": 1297606670,
"label": null,
"url": "https://zencoder-temp-storage-us-east-1.s3.amazonaws.com/o/20170422/69a1a537e5b40f91c172e6b033827159/9ea8d51bc1a71545eb9c700c0379e950.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAI456JQ76GBU7FECA%2F20170422%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170422T214927Z&X-Amz-Expires=86399&X-Amz-SignedHeaders=host&X-Amz-Signature=9c0b05565dabcd5d7405a882956ef2babff6173c80cbafa36b2bd12df569e594"
}
]
}