API Playground: проверка методов API соцсетей в браузере
API Playground — интерактивная среда в кабинете socialift.uz. Она собирает 191 методов по Facebook, Instagram, LinkedIn, TikTok, аккаунту и боту Telegram, лидам для CRM и подключённым аккаунтам вместе с документацией, отправляет реальные запросы и показывает их в виде cURL и JavaScript, а также соответствующий вызов Python SDK. А в разделе «Kalitlar» (ключи) вы добавляете ключи своих приложений разработчика.
Обновлено:
Что такое API Playground и зачем он нужен
API Playground — инструмент, в котором метод API соцсети можно вызвать прямо в браузере, не написав ни строчки кода. Вы выбираете метод, указываете, от имени какого подключённого аккаунта работать, заполняете форму и отправляете реальный запрос. Ответ приходит со статусом, временем, заголовками и JSON, а рядом — этот же запрос в виде cURL и JavaScript и соответствующий пример Python SDK.
Запросы настоящие: пост действительно публикуется, сообщение действительно отправляется. Поэтому удаляющие действия и действия, влияющие на бюджет, перед отправкой требуют явного подтверждения.
Playground не заменяет написание кода. Он нужен, чтобы изучить метод, проверить, хватает ли разрешений, и быстро найти ошибку; в продакшене те же вызовы выполняются через Python SDK.
Что есть в Playground
191 методов с документацией
Для каждого метода: что он делает, какие есть подводные камни и какие нужны разрешения или scope.
Форма по схеме
Форма строится по реальной схеме API; при желании — редактор сырого JSON или загрузка файла.
Выбор аккаунта
Вы выбираете из списка, от имени какого подключённого аккаунта отправить запрос.
Просмотр ответа
Статус, время выполнения, заголовки и удобный просмотрщик JSON.
Код в трёх видах
cURL и JavaScript fetch — ровно отправленный запрос (к API сервера Socialift, с JWT кабинета); Python — пример эквивалентного вызова SDK (есть у большинства методов).
Ссылки и история
Прямая ссылка на метод и история последних запросов, которая хранится в этом браузере.
Какие методы можно проверить
| Раздел | Группы методов |
|---|---|
| Подключение, страницы и вебхук, посты, истории, комментарии, Lead Ads, реклама (таргетинг, кампании, аудитории и статистика) | |
| Подключение, профиль и статистика, посты, истории, комментарии, Direct | |
| Подключение, профиль, посты | |
| TikTok | Подключение и профиль, видео и статистика, публикация, комментарии (Business) |
| Аккаунт Telegram | Подключение, сообщения, истории, группы и каналы, участники и модерация, контакты и сессии |
| Бот Telegram | Подключение, сообщения, чаты и модерация, вебхук и универсальный вызов |
| CRM и лиды | Лиды |
| Подключённые аккаунты | Аккаунты |
Примечания и ограничения
Всего 191 методов. Удаляющие действия и действия, влияющие на бюджет, перед отправкой требуют явного подтверждения. Эндпоинты историй тоже проверяются здесь: для Instagram — POST и GET /instagram/media/stories, для Facebook — POST /facebook/stories/photo, POST /facebook/stories/video и GET /facebook/stories, для аккаунта Telegram — GET, POST и PATCH /telegram/stories, POST /telegram/stories/delete, а также GET /telegram/stories/can-send и GET /telegram/stories/targets, которые проверяют условия до публикации.
Ключи: ваши собственные приложения разработчика
В разделе «Kalitlar» (ключи) вы добавляете ключи своего приложения для каждой платформы. Секреты хранятся в зашифрованном виде и потом не показываются целиком.
- Приложение Meta
- App ID, app secret и необязательный configuration ID для Facebook Login for Business.
- Приложение Instagram Login
- Instagram app ID и app secret — для подключения Instagram-аккаунта без страницы Facebook.
- Приложение LinkedIn
- Client ID и client secret.
- Приложение TikTok
- Client key и client secret.
- Telegram API
- api_id и api_hash — для подключения аккаунта Telegram. Для бота ключи не нужны: достаточно его токена.
Что даёт собственное приложение
Ваш бренд в окне входа
Выдавая доступ, пользователь видит название вашего приложения.
Отдельный адрес вебхука для вашего приложения
События Meta, Instagram и TikTok приходят на выделенный вашему приложению адрес Socialift и проверяются вашим app secret. Пока из них доступны лиды Lead Ads (GET /crm/leads); чтобы получать остальные события у себя, укажите в callback URL свой endpoint и используйте помощники SDK verify_request / verify_tiktok_request.
Проверка в один клик
Ключи проверяются у самого провайдера: запрос client credentials в Meta, Instagram Login, LinkedIn и TikTok, MTProto в Telegram. Результат: «tekshirilgan» (проверен), «rad etilgan» (отклонён) или нет однозначного ответа (реальная проверка — при первом входе).
Готовые значения для консоли
Страница показывает точный redirect URI для консоли провайдера; после сохранения ключей для Meta, Instagram и TikTok появляются адрес вебхука и verify token, а для Meta — ещё адреса deauthorize и data deletion.
Работает и без своих ключей
Если своих ключей нет, там, где это возможно, используется общее приложение Socialift.
Подключения и статистика
На странице «Ulanishlar» (подключения) Facebook (вместе со страницами и привязанными к ним Instagram-аккаунтами), Instagram без страницы, LinkedIn и TikTok подключаются через OAuth, аккаунт Telegram — по шагам телефон → код → 2FA, бот Telegram — по токену. Токены остаются на сервере в зашифрованном виде и не попадают в браузер.
Страница «Statistika» (статистика) показывает активации SDK-токенов отдельно от вызовов Playground и API, с числом ошибок. Кнопка «Tekshirish va muhitlar» (проверка и окружения) на странице «Tokenlar» (токены) показывает статус токена и занятые окружения (seat'ы) — сама проверка seat не занимает. Каждый раздел подробно описан в руководстве по кабинету.
Первый реальный запрос — четыре шага
Войдите в кабинет
Войдите на socialift.uz через Google или email и откройте кабинет.
Добавьте ключи
Введите ключи своего приложения на странице «Kalitlar» (ключи) и проверьте их в один клик — или пропустите шаг, если доступно общее приложение.
Подключите аккаунт
На странице «Ulanishlar» (подключения) подключите Facebook, Instagram, LinkedIn, TikTok, аккаунт или бота Telegram.
Вызовите метод
В Playground выберите метод и аккаунт, заполните форму, отправьте запрос и скопируйте готовый код.
Как правильно пользоваться Playground
- Запросы настоящие — для экспериментов используйте отдельную страницу, аккаунт или бота.
- Прежде чем подтвердить удаление или действие с бюджетом, ещё раз проверьте параметры.
- Читайте подводные камни и требуемые разрешения в документации метода — там описана причина многих ошибок.
- Делитесь с коллегой нужным запросом через прямую ссылку на метод.
- Если проверка ключей не дала однозначного ответа, это не значит, что ключ неверный — провайдер не подтверждает его заранее, реальная проверка происходит при первом входе.
- В продакшене используйте Python SDK — пример на вкладке Python нужен для этого; примеры cURL/JavaScript вызывают API сервера Socialift с JWT кабинета.
Частые вопросы
Запросы в Playground настоящие?
Да. Пост действительно публикуется, сообщение действительно отправляется. Поэтому удаляющие действия и действия, влияющие на бюджет, перед отправкой требуют явного подтверждения.
Заменяет ли Playground написание кода?
Нет. Playground нужен для изучения и проверки методов. В продакшене используется Python SDK — Playground показывает эквивалент метода в SDK (если он есть) и отправленный запрос в виде cURL/JavaScript.
Зачем нужны собственные ключи приложения?
С собственным приложением в окне входа виден ваш бренд, а вебхуки Meta/TikTok приходят на выделенный вашему приложению адрес и проверяются вашим секретом. Без своих ключей, где возможно, используется общее приложение Socialift.
Как хранятся ключи и токены?
Секреты приложений хранятся в зашифрованном виде и потом не показываются целиком. Токены подключённых аккаунтов тоже остаются на сервере в зашифрованном виде и не попадают в браузер.
Как работает проверка ключей?
В один клик ключи проверяются у самого провайдера: запрос client credentials в Meta, Instagram Login, LinkedIn и TikTok, MTProto в Telegram. Результат — «tekshirilgan» (проверен), «rad etilgan» (отклонён) или нет однозначного ответа; в последнем случае реальная проверка происходит при первом входе.
Что нужно, чтобы пользоваться Playground?
Войти на socialift.uz через Google или email и подключить нужный аккаунт на странице «Ulanishlar» (подключения). SDK-токен не нужен: Playground работает независимо от тарифа токена.
Источники
Связанные страницы
Отправьте первый запрос прямо сейчас
Войдите через Google или email, подключите аккаунт и проверьте любой метод в Playground.
Открыть Playground →