Площадки и источники
Freelancehunt: как получать заказы через API
Сайт Freelancehunt защищён от ботов, поэтому читать его страницы мы не будем. Зато у площадки есть официальный API, который работает с личным токеном. Это тот случай, когда доступ даёт сам пользователь.
Как Klondo читает эту площадку
- Доступ
- твой токен
- Тариф
- Pro
- Период
- раз в 15 минут
Через официальный API с твоим токеном.
Что за площадка
Freelancehunt это биржа с сильной украинской и польской аудиторией. Многие заказы приходят в гривнах и других валютах, часть на русском, часть на украинском и английском. Если у тебя есть такие клиенты, площадка даёт доступ к заказам, которых нет на российских биржах.
Почему только API
На страницах сайта стоит защита от ботов с проверкой в браузере. Её нельзя пройти честно из программы, и обходить её мы не будем. Официальный API другое дело: пользователь сам выпускает токен и разрешает программе читать список открытых проектов.
Токен это пароль с ограниченными правами. Относись к нему так же, как к паролю: не отправляй в чатах, храни в защищённом месте и отзывай, если подозреваешь утечку.
Как подключить
- В настройках профиля Freelancehunt найди раздел для разработчиков и API и выпусти персональный токен (точное название пункта меню смотри на самой площадке).
- Открой в Klondo «Сканер», карточку источника Freelancehunt и вставь токен.
- Включи источник. В интерфейсе токен больше не показывается: его можно только заменить или удалить.
Что учитывать при работе
- Бюджет приходит с валютой. Не сравнивай гривны с рублями без пересчёта.
- В работу берутся только проекты, открытые для откликов.
- Оценка заказчика на площадке по шкале 0–10 приводится к рейтингу 0–5, и по нему можно фильтровать.
- Анонимный кэш API мы не используем: площадка отметила его как устаревший.
Как выбирать заказчика по рейтингу и валюте
Оценка заказчика и число завершённых проектов дают первое представление о нём. Новый заказчик без истории не плох сам по себе, но работать с ним лучше через безопасную сделку площадки и по этапам. Валюта влияет на цену: пересчитай бюджет в рубли по текущему курсу и учти комиссию вывода, иначе привлекательная сумма окажется скромной.
- Смотри на отзывы исполнителей, а не только на цифру рейтинга.
- Для заказчиков из других стран заранее уточни язык общения и часовой пояс.
- Указывай цену в той валюте, в которой заказчик привык платить.
Если приходят ошибки доступа
Ошибка 401 или 403 обычно означает, что токен введён неверно, отозван или у него не хватает прав. Выпусти новый токен в настройках Freelancehunt и замени его в Klondo. Ошибка 429 означает, что запросов слишком много: источник сам сделает паузу, ничего делать не нужно.
Как Freelancehunt читает Klondo
Klondo делает один запрос к официальному API Freelancehunt раз в пятнадцать минут и только с твоим токеном. Токен лежит в защищённом хранилище системы (safeStorage), не попадает в базу, логи и интерфейс. При ошибке доступа (401, 403) источник показывает ошибку доступа и не пытается обойти ограничение, при лимите (429) делает паузу.
Источник входит в тариф Pro и по умолчанию выключен. Отклик Klondo готовит черновиком, отправляешь ты, на странице проекта.
Частые вопросы
Что будет, если токен отзовут?
Источник покажет, что нужен новый токен, и перестанет читать. Остальные источники продолжат работу, а данные Freelancehunt, которые уже в Inbox, останутся.