Complete a multipart upload

POST/v1/videos/{id}/upload/complete

Step 3 of the upload flow. The server loads the part ledger written by the upload endpoint (a client parts array is rejected), completes the multipart upload, verifies the object, and transitions the video to uploaded. Requires an API key with write scope, or session-cookie auth plus projectId. Rate limit: 60 requests per 60 s per caller.

Error codes: unauthorized (401), insufficient_scope (403), account_not_approved (403), invalid_project_id (400), not_found (404), video_not_found (404), invalid_body (400), invalid_checksum_sha256 (400), parts_missing (409), checksum_mismatch (400), upload_already_completed (409).

المصادقة

apiKey — Project API key: Authorization: Bearer vh_live_... (live mode) or Authorization: Bearer vh_test_... (test mode). Keys carry read and/or write scopes.

المعاملات

الاسم	الموضع	النوع	إلزامي	الوصف
`id`	path	string (Ulid)	نعم	—

جسم الطلب

اختياري

نوع المحتوى: application/json

المخطّط: UploadCompleteRequest

{
  "checksumSha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}

الاستجابات

الرمز	المعنى
`200`	Upload completed; the video is `uploaded` and queued for encoding.
`400`	The request body or query failed validation. The per-operation description lists the exact `error.code` values.
`401`	No valid credential was presented.
`403`	The credential is valid but does not permit this action. The per-operation description lists the exact `error.code` values.
`404`	The resource does not exist or is not visible to this caller.
`409`	The request conflicts with the resource's current state. The per-operation description lists the exact `error.code` values.
`429`	Rate limit exceeded.

مثال على الطلب

{
  "checksumSha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}

جرّبها

POST

/v1/videos/{id}/upload/complete

وضع الاختبار فقط

منصة API التفاعلية

أرسل طلبًا حيًا إلى api.videohati.com بمفتاح وضع الاختبار.

تحجب هذه المنصة مفاتيح vh_live_. استخدم مفتاحًا يبدأ بـ vh_test_ فقط؛ لن يغادر أي طلب بمفتاح حي متصفحك.

مفتاح وضع الاختبار

يُحفظ المفتاح في متصفحك على docs.videohati.com فقط.

جسم الطلب (JSON)