Практическое руководство: настройка

Введение

Перед внедрением устройства «С камеры в облако», что у вас есть все необходимое для успешной реализации.

Зарегистрируйтесь как разработчик

Для настройки устройства согласно руководствам вам потребуется client_secret. Если вы его еще не получили, изучите руководство по началу работы и узнайте, как зарегистрироваться в качестве разработчика C2C. Наша команда предоставит учетные данные, необходимые для взаимодействия с API-интерфейсом.

Инструменты для работы с руководствами по реализации

Эти инструменты не являются обязательными, но благодаря им вы сможете следовать нашим руководствам и тестировать взаимодействия с API-интерфейсом напрямую.

cURL

В руководствах показаны запросы к API-интерфейсу Frame.io с использованием curl. Эта широко распространенная библиотека обеспечивает превосходный интерфейс командной строки для выполнения HTTP-запросов. При внедрении вашего устройства вам потребуется воспроизвести эти HTTP-вызовы на выбранном языке программирования. Использование curl в этих примерах позволяет протестировать взаимодействия с API-интерфейсом, просто копируя команды в терминал. Чтобы проверить, установлена ли curl в вашей системе, введите эту команду в терминале:

$
curl --version

Вы должны получить результат, похожий на этот:

curl 7.64.1 (x86_64-apple-darwin20.0) libcurl/7.64.1 (SecureTransport) LibreSSL/2.8.3 zlib/1.2.11 nghttp2/1.41.0
Release-Date: 2019-03-27
Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 pop3s rtsp smb smbs smtp smtps telnet tftp 
Features: AsynchDNS GSS-API HTTP2 HTTPS-proxy IPv6 Kerberos Largefile libz MultiSSL NTLM NTLM_WB SPNEGO SSL UnixSockets

Если библиотека не установлена, установщики для большинства операционных систем можно найти здесь. Пользователи macOS или Linux могут установить ее через Homebrew:

$
brew install curl

Python

Для форматирования ответов JSON мы будем использовать Python, передавая результаты curl через:

$
curl https://api.frame.io/health | python -m json.tool

Чтобы проверить, установлен ли у вас Python:

$
python --version

Ожидаемый результат:

Python 2.7.16

Если Python не установлен, его можно загрузить здесь. Подойдет Python 2.6+ или Python 3.x. Хотя использовать Python не обязательно, он помогает сделать ответы более читаемыми. Аналогичные возможности предоставляют также инструменты типа jq.

Эталонная реализация

Пакет разработчика включает эталонную реализацию Python с примером приложения CLI для добавления медиафайлов в Frame.io через подключение C2C. После проработки каждого раздела этих руководств может быть полезно изучить эталонную реализацию, чтобы увидеть применение концепций в рабочем коде.

Дальнейшие шаги

Если вы еще этого не сделали, рекомендуем связаться с нашей командой, а затем перейти к руководству по аутентификации и авторизации. Будем рады помочь вам в процессе реализации.