탐색으로 건너뛰기
API Reference인증

디바이스 코드 요청

헤더

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/

x-client-platypus-enabledenum선택 사항
Enable URL Pairing mode for C2C device code requests. Set to 'true' to enable.
허용된 값:

요청

This endpoint expects a multipart form.
client_idstring필수

물리적 하드웨어 디바이스의 고유 식별자입니다. 이 값은 해당 디바이스에서 고유함이 보장되어야 합니다. 일련번호 또는 무작위로 생성된 UUID를 사용할 수 있습니다.

client_secretstring필수

Frame.io 지원 팀에서 발급하며 디바이스 모델을 식별합니다. 이 값은 사용자에게 공개되지 않도록 비밀로 유지해야 하며, 저장 시 암호화해야 합니다.

scopestring필수형식: "asset_create offline"

요청 중인 권한의 공백으로 구분된 목록입니다. 하드웨어 디바이스는 다음 scope를 요청할 수 있습니다: 'asset_create'(에셋 생성), 'offline'(토큰 새로 고침). 일반적으로 두 항목을 함께 요청합니다.

응답

요청 성공

device_codestring>=1 character
The device code should be hidden from the user, and is used to identify this authorization request when polling to see if the user has entered their code successfully.
expires_indouble<=120
The number of seconds until this code expires.
intervaldouble
How long the we should wait between polling requests to see if the user has entered the code.
namestring>=1 character
The name of the device we are trying to connect.
user_codestring>=1 character

The six-digit code the user will enter into Frame.io to pair the device to a project.

verification_uristring형식: "uri"
The URL where the user should go to enter the pairing code.
verification_uri_completestring선택 사항형식: "uri"

A complete URL with the user code pre-filled, which can be used to streamline the pairing process.