Используйте параметр fields
в ваших запросах, чтобы указать API возвращать только метаданные, необходимые для вашего приложения. Поскольку ответы API Vimeo могут быть довольно большими, особенно при получении списка видео, параметр fields
может значительно уменьшить размер ответа и впоследствии увеличить время ответа.
Например, допустим, вы делаете запрос на получение последних 10 загруженных вами видео. Запрос будет выглядеть так:
curl -X GET https://api.vimeo.com/me/videos?page=1&per_page=10
-H 'Accept: application/vnd.vimeo.*+json;version=3.4'
-H 'Authorization: bearer [token]'
В ответе будут возвращаться полные и полные видеообъекты для 10 видео, которые могут быть довольно большими Однако если вам нужны только некоторые метаданные в ответе, такие как название видео, описание и ссылка на vimeo.com, тогда тот же запрос с параметром fields
будет выглядеть так:
curl -X GET https://api.vimeo.com/me/videos?page=1&per_page=10&fields=uri,name,description,link
-H 'Accept: application/vnd.vimeo.*+json;version=3.4'
-H 'Authorization: bearer [token]'
Параметр fields
задокументирован здесь: https://developer.vimeo.com/api/common-formats#json-filter