Thiết lập client_reference cho file

client_reference là mã tham chiếu do ứng dụng của bạn quản lý, giúp liên kết file MPS với một bản ghi khách hàng, nội dung hoặc nghiệp vụ trong hệ thống của bạn. Giá trị này là chuỗi tối đa 64 ký tự.

Bạn có thể gửi client_reference ngay khi upload file hoặc cập nhật sau khi file đã tồn tại.

Cập nhật file đã có

PATCH https://mps.mediacdn.vn/v1/namespaces/{namespace}/files/{path}

Xem API reference cho endpoint cập nhật client_reference .

path là đường dẫn tương đối trong namespace, ví dụ videos/intro.mp4.

curl --request PATCH \
  'https://mps.mediacdn.vn/v1/namespaces/<namespace>/files/videos/intro.mp4' \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Type: application_credential' \
  --header 'X-App-Credential-Id: <credential-id>' \
  --header 'X-App-Credential-Secret: <credential-secret>' \
  --data '{"client_reference":"customer-record-42"}'

Chỉ trường client_reference được chấp nhận trong body của endpoint này. Khi cập nhật file nguồn, MPS cũng áp dụng giá trị cho các artifact liên quan do transcoding tạo ra.

Xóa giá trị

Gửi null để xóa client_reference:

{
  "client_reference": null
}

MPS trả 404 nếu không tìm thấy file, và 400 nếu giá trị không phải chuỗi hoặc dài hơn 64 ký tự.

Liệt kê file trong namespace Tìm file theo client_reference