Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Dribbble: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Просматривайте каталог дизайнеров Dribbble по специализации, местоположению, бюджету, рейтингу или статусу PRO. | $1.39 за 1 000 запросов | Норма |
Шотыshots | Ищите шоты Dribbble по keyword. | $1.39 за 1 000 запросов | Норма |
Профилиprofile | Найдите дизайнера на Dribbble по username и получите его описание, местоположение, число подписчиков и рейтинг. | $3.6 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Dribbble?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Просматривайте каталог дизайнеров Dribbble по специализации, местоположению, бюджету, рейтингу или статусу PRO. Получайте рейтинг, стартовую цену, время ответа и навыки каждого дизайнера. Результаты содержат сведения из профилей. Поиск не передаёт дизайнеру заказ и не подтверждает, что он свободен для работы. | category, keyword, location, min_budget, min_rating, pro_only | Режим выдачи: Sync | Значения в каталоге: defaultLimit=30, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | user_id · username · name · url · avatar_url · location · rating · rating_scale · review_count · projects_completed · starting_price · response_time · services_count · is_pro · skills · platform | |
shotsШоты Ищите шоты Dribbble по | keyword | query, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=24, maxLimit=60. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | shot_id · title · url · author_name · author_url · view_count · like_count · comment_count · tags · image_url · is_pro · is_animated · platform |
profileПрофили Найдите дизайнера на Dribbble по | username | — | Режим выдачи: Sync | — | $3.6 за 1 000 запросов | user_id · username · name · bio · url · avatar_url · location · follower_count · rating · rating_scale · platform |
Что означают параметры действия search в API Dribbble?
Просматривайте каталог дизайнеров Dribbble по специализации, местоположению, бюджету, рейтингу или статусу PRO. Получайте рейтинг, стартовую цену, время ответа и навыки каждого дизайнера. Результаты содержат сведения из профилей. Поиск не передаёт дизайнеру заказ и не подтверждает, что он свободен для работы.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеcategoryНеобязательный- Фильтрует запросы
searchпо дизайнерам по одной профессиональной категории:animation,branding,illustration,mobile,print,product-design,typographyилиweb-design. Переопределяет категорию, переданную вkeyword; это не произвольный тег работ.Допустимые значения:animationbrandingillustrationmobileprintproduct-designtypographyweb-design keywordНеобязательный- Поисковый запрос по работам в
shotsлибо категория дизайнеров вsearch, используемая, если параметрcategoryне передан. Можно оставить пустым, если вы только просматриваете каталог дизайнеров.Допустимые значения:animationbrandingillustrationmobileprintproduct-designtypographyweb-design locationНеобязательный- Произвольная текстовая строка для фильтрации дизайнеров по местоположению, например «New York», «San Francisco, CA» или «London». Если параметр не передан, фильтр по местоположению не применяется. Это не зона оказания услуг и не часовой пояс.
min_budgetНеобязательный- Фильтрует дизайнеров по минимальному бюджету проекта в USD: целое число от
0до10000, где0означает отсутствие нижней границы. Отражает предпочтения дизайнера, а не стоимость вызовов API или подтверждённую смету проекта. min_ratingНеобязательный- Фильтрует дизайнеров по минимальному рейтингу при поиске дизайнеров. Допустимые значения передаются строками:
any(без ограничений),1,2,3или4(выбранное число звёзд и выше). Ожидаются точные строковые значения, а не произвольные десятичные числа вроде4.5и не число лайков работ.Допустимые значения:1234any pro_onlyНеобязательный- Логический флаг: при
trueвозвращаются только дизайнеры Dribbble PRO, приfalseтип аккаунта не ограничивается. Передавайте булево значение JSON, а не строку ("false"). Статус PRO не является официальным подтверждением качества.
Что означают параметры действия shots в API Dribbble?
Ищите шоты Dribbble по keyword. Получайте название каждой работы, автора, теги, изображение, а также число просмотров, лайков и комментариев. Можно сортировать по популярности, новизне или просмотрам. Ссылка на изображение не даёт лицензии и может вести не на оригинальный файл.
keywordОбязательный- Поисковый запрос по работам в
shotsлибо категория дизайнеров вsearch, используемая, если параметрcategoryне передан. Можно оставить пустым, если вы только просматриваете каталог дизайнеров.Dribbble: как Shots показывают дизайнерские работы и процесс их создания — В документации Dribbble сказано, что Shots с помощью изображений, текста и видео показывают результаты и процесс дизайна, а теги описывают содержание работы. Получение отображаемых метаданных Shot не равнозначно получению полных исходных файлов дизайна. · Проверено queryНеобязательный- Псевдоним поискового запроса в действиях
shots. Параметрkeywordимеет приоритет и остаётся обязательным; это поле не используется для выбора категории при поиске в каталоге дизайнеров. sortНеобязательный- Сортирует списки работ в действиях
shots; допустимые значения:popular,newestиmost_viewed. В действияхprofileподтверждённого влияния на сортировку объектов пользователей у параметра нет, поэтому полагаться на него не следует.Допустимые значения:most_viewednewestpopular
Что означают параметры действия profile в API Dribbble?
Найдите дизайнера на Dribbble по username и получите его описание, местоположение, число подписчиков и рейтинг. Передавайте только имя пользователя из URL профиля, а не полную ссылку. Эти данные не подтверждают навыки или личность.
usernameОбязательный- Имя пользователя дизайнера Dribbble из пути URL профиля, без префикса
@и без полного URL. Используется в запросахprofileдля получения данных аккаунта; это не ID отдельной работы.Dribbble: профиль дизайнера и отдельные Shots — разные сущности — Dribbble отличает витрины работ от профиля дизайнера, в котором указаны биография, местоположение, навыки и предпочтения по работе. Ссылка на эти определения не означает, что этот эндпоинт позволяет запускать проекты или нанимать дизайнеров. · Проверено
Как использовать API Dribbble
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"dribbble","action":"search","params":{}}'
Вопросы об API Dribbble
Какие данные можно получить через API Dribbble?
Укажите в platform значение dribbble. В текущем каталоге: поиск, шоты и профили. Эти названия действий соответствуют разным объектам или представлениям Dribbble; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Dribbble?
У действия search нет собственных обязательных параметров. Передайте идентификаторы платформы и действия, а также только те необязательные параметры, которые вам нужны.
Какие поля может вернуть search на платформе Dribbble?
Объявленная схема включает user_id, username, name и avatar_url. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Dribbble возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.