API Reference

C2C 에셋 만들기

C2C 디바이스 및 애플리케이션을 위한 에셋 업로드 시작입니다.

참고: 이 엔드포인트는 이전에 /v2/assets였으며, 해당 엔드포인트도 정상적으로 계속 작동하지만, 대신 이 엔드포인트를 사용하는 것이 좋습니다.

인증

AuthorizationBearer

Bearer <token> 형식의 Bearer 인증. 여기서 token은 인증 토큰입니다.

헤더

x-client-versionstring선택 사항기본값 0.0.0
Firmware or software version of a C2C integration. Will be used to determine the correct Device Model configuration for the device when multiple are available. Must be a valid semantic version. For more on semantic versions, see here: https://semver.org/

요청

While supported, we encourage you to switch from application/x-ww-form-urlencoded to application/json in order to support future workflows that will only be supported through JSON.

When is_realtime_upload is true, call must be made in application/json.

namestring선택 사항기본값
The name the asset should have in Frame.io. This value does not have to match the name of the file on disk; it can be whatever you want it to be in Frame.io. Required if `is_realtime_upload` is `false`. If `is_realtime_upload` is `true`, must containa valid extension in the form of `".[ext]"`, unless `extension` is provided, in which case this field may be `null` or omitted.
extensionstring선택 사항형식: "\..+"
Required when `is_realtime_upload` is `true`, when `name` is not known at time of asset creation. If `name` is provided, must match extension of that value. Ignored when `is_realtime_upload` is `false`. When supplied, asset will be creted with `name` value of `"[new file].extension"`.
filetypestring선택 사항

MIME type like video/quicktime. Many languages have built in utilities for detecting file mimetype (see Go and Python for examples).

Required if is_realtime_upload is true.

auto_version_idstring선택 사항형식: "uuid"
The asset you'd like this to be the next version of
is_realtime_uploadboolean선택 사항기본값 false

If true, File data for this asset is to be uploaded through the Real-time Uploads API.

If false, File data for this asset will be uploaded through the default API.

Must be false if filetype is not file.

filesizestring or integer선택 사항
channelstring or integer선택 사항
offsetstring or integer선택 사항
partsstring or integer선택 사항

응답 헤더

x-ratelimit-limitdouble

The number of times you can make this call within the x-ratelimit-window

x-ratelimit-windowstring선택 사항
The length in milliseconds of the rate limit window
x-ratelimit-remainingstring선택 사항

The number of remaining times you can make this API call in the x-ratelimit-window

응답

Asset create success response.

When is_realtime_asset was set to true in the request, a simplified payload will be returned.

object
OR
RealtimeAssetCreateResponseobject

오류

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error