Для работы с API требуется подписка в boosty — https://boosty.to/abbasovsoft

PostPin API — Документация Назад

Общее

Эта страница описывает, как пользоваться инструментом PostPin API в панели настроек. Здесь собраны объяснения полей, разделов и типичных ошибок, которые могут появляться в ответах.

Email boosty

обязательно

Укажите email, который используется в вашей подписке на Boosty. Этот email нужен для проверки доступа к инструменту.

Где указать: поле Email boosty в верхней панели.

Прокси

Прокси используется для некоторых операций и помогает стабильно работать с Pinterest.

Когда нужен: Добавить аккаунт, Обновить аккаунт, Тест публикации пина.

Когда не нужен: Информация об аккаунте, Удалить аккаунт, Получить токен, Сменить токен.

Поддерживаемые форматы:

http://user:pass@host:port

Пока что поддерживается только формат с логином и паролем: http://user:pass@host:port.

Рекомендуется использовать прокси той же страны, что и ваш аккаунт. Убедитесь, что логин и пароль верны, узел доступен, а порт открыт.

Функции панели

Добавить аккаунт — Для авторизации в ваш пинтерест аккаунт

Обновить аккаунт — для переавторизации в ваш пинтерест аккаунт

Удалить аккаунт — для удаления вашего аккаунта из API

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

Получить токен — выдаёт токен для аккаунта, чтобы использовать его в операциях.

Сменить токен — генерирует новый токен для аккаунта.

Тест публикации пина — пробная публикация изображения на выбранную доску.

Ошибки и решения

Ниже перечислены типичные сообщения об ошибках и рекомендации, что делать:

subscription_required — Чтобы получить доступ, подпишитесь: https://boosty.to/abbasovsoft. Проверьте, что вы используете правильный email Boosty.
requests_blocked — Запросы заблокированы. Свяжитесь с поддержкой: https://t.me/abbasovsoft.
limit_exceeded — Лимит операций исчерпан. Подождите или обновите уровень подписки.
proxy_required — Добавьте прокси. Заполните поле Прокси вверху.
proxy_invalid — Прокси недоступен или неверен. Проверьте адрес, логин/пароль, тип и доступность.
bad_request — Некорректные данные или отсутствуют обязательные поля. Проверьте заполнение всех полей.
session_malformed — Сессия неполная или повреждена.
confirm_failed — Не удалось подтвердить аккаунт. Проверьте валидность cookies и прокси.
session_mismatch — Сессия не соответствует указанному аккаунту. Убедитесь, что cookies принадлежат этому username.
save_error — Ошибка сохранения. Повторите позже.
service_unavailable — Сервис недоступен. Проверьте прокси и повторите позже.
upload_failed — Не удалось загрузить изображение. Проверьте ссылку на изображение и доступность.
publish_failed — Не удалось опубликовать/сохранить пин. Проверьте параметры, доску и прокси.
missing_board — Укажите доску. Заполните поле Board ID.
missing_title — Заголовок обязателен. Заполните поле Заголовок.
title_too_long — Сократите заголовок до 100 символов.
description_too_long — Сократите описание до 600 символов.
alt_text_too_long — Сократите alt text до 300 символов.
missing_image — Укажите изображение. Заполните поле Image URL.
invalid_image_url — Некорректная ссылка на изображение. Используйте прямую ссылку https://...
invalid_token — Недействительный токен. Получите токен заново и используйте правильный.
Не указан email — Укажите email Boosty в верхнем поле.
Аккаунт не найден — Убедитесь, что аккаунт добавлен и указан корректный username.
Аккаунт не найден или токен отсутствует — Добавьте аккаунт и получите токен заново.
Такого аккаунта у вас нет — Проверьте, что аккаунт действительно существует в вашем списке.
Отсутствует логин — Заполните поле username Pinterest.

Лимиты

Действуют ограничения на частоту и количество операций. При превышении вы получите сообщение limit_exceeded или временную блокировку запросов (requests_blocked).

Основные правила:

Частота запросов — не отправляйте много операций подряд. Делайте паузы между действиями.
Повышение уровня — при регулярном превышении лимитов перейдите на более высокий уровень подписки.
Нет лимита — на количество публикаций пинов, управление досок и сохранения пинов.
Добавление аккаунта — до 10 запросов в минуту. При превышении появится limit_exceeded.
Обновление аккаунта — до 10 запросов в минуту. Делайте паузы между повторными обновлениями.
Удаление аккаунта — до 10 запросов в минуту. Не удаляйте массово без пауз.
Получить токен — до 5 запросов в минуту. Избегайте повторных запросов подряд.
Сменить токен — до 5 запросов в минуту. Используйте только при необходимости.

Лимиты на аккаунты

На уровне Разбойники2.0 можно держать 250 аккаунтов работе паралельно

На уровне Middle Creator можно держать 600 аккаунтов работе паралельно

Если вы были на уровне Middle потом решили перейти на уровень Разбойники, и у вас количество аккаунтов в работе больше 250 вы будете получать блокировку, поэтому заранее удалите не используваемые аккаунты из пула API

Нет лимита на количество публикаций пинов, управления досок, и сохранений пинов

Максимум аккаунтов — предел числа аккаунтов на вашей подписке. При достижении появится limit_exceeded.
Управление — удаляйте неиспользуемые аккаунты через раздел Удалить аккаунт, чтобы освободить место.
Доступ к операциям — операции выполняются только для аккаунтов, добавленных в ваш список и привязанных к email Boosty.