Richiedi codice del dispositivo | Frame.io API Documentation

Header

x-client-versionstringOpzionalePredefinito a 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/

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/

Richiesta

client_idstringObbligatorio

Un identificatore univoco per il dispositivo hardware fisico. Questo valore deve garantire l’univocità del dispositivo. Può essere un numero di serie o un UUID generato in modo casuale.

client_secretstringObbligatorio

Verrà inviato dall’assistenza Frame.io e identifica il modello del dispositivo. Non svelare questo valore all’utente e criptalo at-rest

scopestringObbligatorioformat: "asset_create offline"

Elenco di autorizzazioni richieste, delimitato da spazi. I dispositivi hardware possono richiedere i seguenti ambiti: ‘asset_create’ (crea risorse), ‘offline’ (aggiorna token). In genere, vengono richiesti insieme.

Risposta

Richiesta completata

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_uristringformat: "uri"

The URL where the user should go to enter the pairing code.

verification_uri_completestringOpzionaleformat: "uri"

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

1	import requests
2
3	headers = {
4	'x-client-platypus-enabled': 'true',
5	'x-client-version': '1.0.0'
6	}
7
8	data = {
9	'client_id': 'your-client-id',
10	'client_secret': 'your-client-secret',
11	'scope': 'asset_create offline'
12	}
13
14	response = requests.post(
15	'https://api.frame.io/v2/auth/device/code',
16	headers=headers,
17	data=data
18	)
19
20	result = response.json()
21	print(result)

1	{
2	"device_code": "a1b2C3d4E5f6G7h8I9j0K1L2M3N4O5P6Q7R8S9T0U1V2W3X4Y5Z6a7b8c9d0e1f2g3h4i5j6k7",
3	"expires_in": 120,
4	"interval": 5,
5	"name": "my-device-abc123",
6	"user_code": "987654",
7	"verification_uri": "https://next.frame.io/pair",
8	"verification_uri_complete": "https://next.frame.io/pair/987654"
9	}