VKNET ВКонтакте API для .NET (C#) — https://vknet.github.io/vk
Вконтакте API для .NET (C#)
Разработка проекта VkNet
Package Manager
PM> Install-Package VkNet
.NET CLI
> dotnet add package VkNet
Ниже приводятся все реализованные методы для работы с данными ВКонтакте.
Авторизация
Authorize — авторизация на сервере вконтакте и получение AccessToken.
Пользователи
- Users.Get — Возвращает расширенную информацию о пользователях.
- Users.GetFollowers — Возвращает список идентификаторов пользователей, которые являются подписчиками пользователя.
- Users.GetSubscriptions — Возвращает список идентификаторов пользователей и сообществ, которые входят в список подписок пользователя.
- (Устаревший) Users.GetNearby — Индексирует текущее местоположение пользователя и возвращает список пользователей, которые находятся вблизи.
- (Устаревший) Users.IsAppUser — Возвращает информацию о том, установил ли пользователь приложение.
- Users.Report — Позволяет пожаловаться на пользователя.
- Users.Search — Возвращает список пользователей в соответствии с заданным критерием поиска.
Друзья
- Friends.Add — Одобряет или создает заявку на добавление в друзья.
- Friends.AddList — Создает новый список друзей у текущего пользователя.
- Friends.AreFriends — Возвращает информацию о том, добавлен ли текущий пользователь в друзья у указанных пользователей.
- Friends.Delete — Удаляет пользователя из списка друзей или отклоняет заявку в друзья.
- Friends.DeleteAllRequests — Отмечает все входящие заявки на добавление в друзья как просмотренные.
- Friends.DeleteList — Удаляет существующий список друзей текущего пользователя.
- Friends.Edit — Редактирует списки друзей для выбранного друга.
- Friends.EditList — Редактирует существующий список друзей текущего пользователя.
- Friends.Get — Возвращает список идентификаторов друзей пользователя или расширенную информацию о друзьях пользователя (при использовании параметра fields).
- (Устаревший) Friends.GetAvailableForCall — Позволяет получить список идентификаторов пользователей, доступных для вызова в приложении, используя метод JSAPI callUser. Подробнее о схеме вызова из приложений.
- Friends.GetAppUsers — Возвращает список идентификаторов друзей текущего пользователя, которые установили данное приложение.
- Friends.GetByPhones — Возвращает список друзей пользователя, у которых завалидированные или указанные в профиле телефонные номера входят в заданный список.
- Friends.GetLists — Возвращает список меток друзей текущего пользователя.
- Friends.GetMutual — Возвращает список идентификаторов общих друзей между парой пользователей.
- Friends.GetOnline — Возвращает список идентификаторов друзей пользователя, находящихся на сайте.
- Friends.GetRecent — Возвращает список идентификаторов недавно добавленных друзей текущего пользователя
- Friends.GetRequests — Возвращает информацию о полученных или отправленных заявках на добавление в друзья для текущего пользователя.
- Friends.GetSuggestions — Возвращает список профилей пользователей, которые могут быть друзьями текущего пользователя.
- Friends.Search — Позволяет искать по списку друзей пользователей.
Группы
- Groups.addAddress — Позволяет добавить адрес в сообщество.
- Groups.AddCallbackServer — !!Добавляет сервер для Callback API в сообщество.
- Groups.AddLink — Позволяет добавлять ссылки в сообщество.
- Groups.ApproveRequest — Позволяет одобрить заявку в группу от пользователя.
- Groups.Ban — Добавляет пользователя в черный список сообщества.
- Groups.Create — Создает новое сообщество.
- Groups.DeleteAddress — Позволяет удалить адрес в сообществе.
- Groups.DeleteCallbackServer — !!Удаляет сервер для Callback API из сообщества.
- Groups.DeleteLink — Позволяет удалить ссылки из сообщества.
- Groups.DisableOnline — !!Выключает статус «онлайн» в сообществе.
- Groups.Edit — Редактирует сообщество.
- Groups.EditAddress — Позволяет отредактировать адрес в сообществе.
- Groups.EditCallbackServer — !!Редактирует данные сервера для Callback API в сообществе.
- Groups.EditLink — Позволяет редактировать ссылки в сообществе.
- Groups.EditManager — Позволяет назначить/разжаловать руководителя в сообществе или изменить уровень его полномочий.
- Groups.EnableOnline — !!Включает статус «онлайн» в сообществе.
- (Устаревший) Groups.EditPlace — Позволяет редактировать информацию о месте группы.
- Groups.Get — Возвращает список сообществ указанного пользователя.
- Groups.GetAddress — Позволяет отредактировать адрес в сообществе.
- Groups.GetBanned — Возвращает список забаненных пользователей в сообществе.
- Groups.GetById — Возвращает информацию о заданном сообществе или о нескольких сообществах.
- Groups.GetCallbackConfirmationCode — Позволяет получить строку, необходимую для подтверждения адреса сервера в Callback API.
- Groups.GetCallbackServers — !!Получает информацию о серверах для Callback API в сообществе.
- Groups.GetCallbackSettings — !!Позволяет получить настройки уведомлений Callback API для сообщества.
- Groups.GetCatalog — Возвращает список сообществ выбранной категории каталога.
- Groups.GetCatalogInfo — Возвращает список категорий для каталога сообществ.
- Groups.GetInvitedUsers — Возвращает список пользователей, которые были приглашены в группу.
- Groups.GetInvites — Данный метод возвращает список приглашений в сообщества и встречи текущего пользователя.
- Groups.GetLongPollServer — Возвращает данные для подключения к Bots Longpoll API.
- Groups.GetLongPollSettings — !!Получает настройки Bots Longpoll API для сообщества.
- Groups.GetMembers — Возвращает список участников сообщества.
- Groups.GetOnlineStatus — !!Получает информацию о статусе «онлайн» в сообществе.
- Groups.GetRequests — Возвращает список заявок на вступление в сообщество.
- Groups.GetSettings — Позволяет получать данные, необходимые для отображения страницы редактирования данных сообщества.
- Groups.GetTokenPermissions — !!Возвращает настройки прав для ключа доступа сообщества.
- Groups.Invite — Позволяет приглашать друзей в группу.
- Groups.IsMember — Возвращает информацию о том, является ли пользователь участником сообщества.
- Groups.Join — Данный метод позволяет вступить в группу, публичную страницу, а также подтвердить участие во встрече.
- Groups.Leave — Позволяет покинуть сообщество.
- Groups.RemoveUser — Позволяет исключить пользователя из группы или отклонить заявку на вступление.
- Groups.ReorderLink — Позволяет менять местоположение ссылки в списке.
- Groups.Search — Осуществляет поиск сообществ по заданной подстроке.
- Groups.SetCallbackSettings — !!Позволяет задать настройки уведомлений о событиях в Callback API.
- Groups.SetLongPollSettings — !!Задаёт настройки для Bots Long Poll API в сообществе.
- Groups.Unban — Убирает пользователя из черного списка сообщества.
Установка через Nuget
Package Manager
PM> Install-Package VkNet.AudioBypassService
.NET CLI
> dotnet add package VkNet.AudioBypassService
- Audio.Get — Возвращает список аудиозаписей пользователя или сообщества.
- Audio.GetById — Возвращает информацию об аудиозаписях.
- Audio.GetLyrics — Возвращает текст аудиозаписи.
- Audio.Search — Возвращает список аудиозаписей в соответствии с заданным критерием поиска.
- Audio.GetUploadServer — Возвращает адрес сервера для загрузки аудиозаписей.
- Audio.Save — Сохраняет аудиозаписи после успешной загрузки.
- Audio.Add — Копирует аудиозапись на страницу пользователя или группы.
- Audio.Delete — Удаляет аудиозапись со страницы пользователя или сообщества.
- Audio.Edit — Редактирует данные аудиозаписи на странице пользователя или сообщества.
- Audio.Reorder — Изменяет порядок аудиозаписи, перенося ее между аудиозаписями, идентификаторы которых переданы параметрами after и before.
- Audio.Restore — Восстанавливает аудиозапись после удаления.
- Audio.GetAlbums — Возвращает список альбомов аудиозаписей пользователя или группы.
- Audio.AddAlbum — Создает пустой альбом аудиозаписей.
- Audio.EditAlbum — Редактирует название альбома аудиозаписей.
- Audio.DeleteAlbum — Удаляет альбом аудиозаписей.
- Audio.MoveToAlbum — Перемещает аудиозаписи в альбом.
- Audio.SetBroadcast — Транслирует аудиозапись в статус пользователю или сообществу.
- Audio.GetBroadcastList — Возвращает список друзей и сообществ пользователя, которые транслируют музыку в статус.
- Audio.GetRecommendations — Возвращает список рекомендуемых аудиозаписей на основе списка воспроизведения заданного пользователя или на основе одной выбранной аудиозаписи.
- Audio.GetPopular — Возвращает список аудиозаписей из раздела “Популярное”.
- Audio.GetCount — Возвращает количество аудиозаписей пользователя или сообщества.
Сообщения
- Messages.AddChatUser — Добавляет в мультидиалог нового пользователя.
- Messages.AllowMessagesFromGroup — !!Позволяет разрешить отправку сообщений от сообщества текущему пользователю.
- Messages.CreateChat — Создаёт беседу с несколькими участниками.
- Messages.Delete — Удаляет сообщение.
- Messages.DeleteChatPhoto — Позволяет удалить фотографию мультидиалога.
- Messages.DeleteConversation — Удаляет все личные сообщения в диалоге.
- (Устаревший) Messages.DeleteDialog — Удаляет все личные сообщения в диалоге.
- Messages.DenyMessagesFromGroup — !!Позволяет запретить отправку сообщений от сообщества текущему пользователю.
- Messages.Edit — !!Редактирует сообщение.
- Messages.EditChat — Изменяет название беседы.
- (Устаревший) Messages.Get — Возвращает список входящих либо исходящих личных сообщений текущего пользователя.
- Messages.GetByConversationMessageId — !!Возвращает сообщения по их идентификаторам в рамках беседы.
- Messages.GetById — !!Возвращает сообщения по их идентификаторам в рамках беседы.
- Messages.GetChat — Возвращает информацию о беседе.
- (Устаревший) Messages.GetChatUsers — Позволяет получить список пользователей мультидиалога по его id.
- Messages.GetChatPreview — !!Получает данные для превью чата с приглашением по ссылке.
- Messages.GetConversationMembers — Позволяет получить список участников беседы.
- Messages.GetConversations — Возвращает список бесед пользователя.
- Messages.GetConversationsById — Возвращает список бесед пользователя.
- (Устаревший) Messages.GetDialogs — Возвращает список диалогов текущего пользователя.
- Messages.GetHistory — Возвращает историю сообщений для указанного пользователя.
- Messages.GetHistoryAttachments — !!Возвращает материалы диалога или беседы.
- Messages.GetImportantMessages — !!Возвращает список важных сообщений пользователя.
- Messages.GetInviteLink — !!Получает ссылку для приглашения пользователя в беседу.
- Messages.GetLastActivity — Возвращает текущий статус и дату последней активности указанного пользователя.
- Messages.GetLongPollHistory — Возвращает обновления в личных сообщениях пользователя.
- Messages.GetLongPollServer — Возвращает данные, необходимые для подключения к Long Poll серверу.
- Messages.IsMessagesFromGroupAllowed — !!Возвращает информацию о том, разрешена ли отправка сообщений от сообщества пользователю.
- Messages.JoinChatByInviteLink — !!Позволяет присоединиться к чату по ссылке-приглашению.
- Messages.MarkAsAnsweredConversation — !!Помечает беседу как отвеченную либо снимает отметку.
- Messages.MarkAsImportant — !!Помечает сообщения как важные либо снимает отметку.
- Messages.MarkAsImportantConversation — !!Помечает беседу как важную либо снимает отметку.
- Messages.MarkAsRead — Помечает сообщения как прочитанные.
- Messages.Pin — !!Закрепляет сообщение.
- Messages.RemoveChatUser — Исключает из мультидиалога пользователя, если текущий пользователь был создателем беседы либо пригласил исключаемого пользователя.
- Messages.Restore — Восстанавливает удаленное сообщение.
- Messages.Search — Возвращает список найденных личных сообщений текущего пользователя по введенной строке поиска.
- (Устаревший) Messages.SearchDialogs — Возвращает список найденных диалогов текущего пользователя по введенной строке поиска.
- Messages.SearchConversations — Позволяет искать диалоги.
- Messages.Send — Отправляет сообщение.
- Messages.SetActivity — Изменяет статус набора текста пользователем в диалоге.
- Messages.SetChatPhoto — Позволяет установить фотографию мультидиалога, загруженную с помощью метода pho/tos.getChatUploadServer.
- Messages.Unpin — !!Открепляет сообщение.
Стена
- Wall.CloseComments — !!Выключает комментирование записи.
- (Устаревший метод) Wall.AddComment — Добавляет комментарий к записи на стене пользователя или сообщества.
- Wall.CreateComment — !!Добавляет комментарий к записи на стене.
- Wall.Delete — Удаляет запись со стены.
- Wall.DeleteComment — Удаляет комментарий текущего пользователя к записи на своей или чужой стене.
- Wall.Edit — Редактирует запись на стене.
- Wall.EditAdsStealth — !!Позволяет отредактировать скрытую запись.
- Wall.EditComment — Редактирует комментарий на стене пользователя или сообщества.
- Wall.Get — Возвращает список записей со стены пользователя или сообщества.
- Wall.GetById — Возвращает список записей со стен пользователей или сообществ по их идентификаторам.
- Wall.GetComments — Возвращает список комментариев к записи на стене.
- Wall.GetReposts — Позволяет получать список репостов заданной записи.
- Wall.OpenComments — !!Включает комментирование записи
- Wall.Pin — Закрепляет запись на стене (запись будет отображаться выше остальных).
- Wall.Post — Публикует новую запись на своей или чужой стене.
- Wall.PostAdsStealth — !!Позволяет создать скрытую запись, которая не попадает на стену сообщества и в дальнейшем может быть использована для создания рекламного объявления типа “Запись в сообществе”.
- Wall.ReportComment — Позволяет пожаловаться на комментарий к записи.
- Wall.ReportPost — Позволяет пожаловаться на запись.
- Wall.Repost — Копирует объект на стену пользователя или сообщества.
- Wall.Restore — Восстанавливает удаленную запись на стене пользователя или сообщества.
- Wall.RestoreComment — Восстанавливает комментарий текущего пользователя к записи на своей или чужой стене.
- Wall.Search — Метод, позволяющий осуществлять поиск по стенам пользователей.
- Wall.Unpin — Отменяет закрепление записи на стене.
Статус
- Status.Get — Получает статус пользователя.
- Status.Set — Устанавливает статус текущему пользователю.
Фотографии
- Photos.ConfirmTag — Подтверждает отметку на фотографии.
- Photos.Copy — Позволяет скопировать фотографию в альбом “Сохраненные фотографии”.
- Photos.CreateAlbum — Создает пустой альбом для фотографий.
- Photos.CreateComment — Создает новый комментарий к фотографии.
- Photos.Delete — Удаление фотографии на сайте.
- Photos.DeleteAlbum — Удаляет указанный альбом для фотографий у текущего пользователя.
- Photos.DeleteComment — Удаляет комментарий к фотографии.
- Photos.Edit — Изменяет описание у выбранной фотографии.
- Photos.EditAlbum — Редактирует данные альбома для фотографий пользователя.
- Photos.EditComment — Изменяет текст комментария к фотографии.
- Photos.Get — Возвращает список фотографий в альбоме.
- Photos.GetAlbums — Возвращает список альбомов пользователя или сообщества.
- Photos.GetAlbumsCount — Возвращает количество доступных альбомов пользователя или сообщества.
- Photos.GetAll — Возвращает все фотографии пользователя или сообщества в антихронологическом порядке.
- Photos.GetAllComments — Возвращает отсортированный в антихронологическом порядке список всех комментариев к конкретному альбому или ко всем альбомам пользователя.
- Photos.GetById — Возвращает информацию о фотографиях по их идентификаторам.
- Photos.GetChatUploadServer — Позволяет получить адрес для загрузки фотографий мультидиалогов.
- Photos.GetComments — Возвращает список комментариев к фотографии.
- Photos.GetMarketAlbumUploadServer — Возвращает адрес сервера для загрузки фотографии подборки товаров в сообществе.
- Photos.GetMarketUploadServer — Возвращает адрес сервера для загрузки фотографии товаров сообщества.
- Photos.GetMessagesUploadServer — Возвращает адрес сервера для загрузки фотографии в личное сообщение пользователю.
- Photos.GetNewTags — Возвращает список фотографий, на которых есть непросмотренные отметки.
- Photos.GetOwnerCoverPhotoUploadServer — Получает адрес для загрузки обложки сообщества.
- Photos.GetOwnerPhotoUploadServer — Возвращает адрес сервера для загрузки главной фотографии на страницу пользователя или сообщества.
- Photos.GetTags — Возвращает список отметок на фотографии.
- Photos.GetUploadServer — Возвращает адрес сервера для загрузки фотографий.
- Photos.GetUserPhotos — Возвращает список фотографий, на которых отмечен пользователь.
- Photos.GetWallUploadServer — Возвращает адрес сервера для загрузки фотографии на стену пользователя или сообщества.
- Photos.Move — Переносит фотографию из одного альбома в другой.
- Photos.MakeCover — Делает фотографию обложкой альбома.
- Photos.PutTag — Добавляет отметку на фотографию.
- Photos.RemoveTag — Удаляет отметку с фотографии.
- Photos.ReorderAlbums — Меняет порядок альбома в списке альбомов пользователя.
- Photos.ReorderPhotos — Меняет порядок фотографии в списке фотографий альбома пользователя.
- Photos.Report — Позволяет пожаловаться на фотографию.
- Photos.ReportComment — Позволяет пожаловаться на комментарий к фотографии.
- Photos.Restore — Восстанавливает удаленную фотографию.
- Photos.RestoreComment — Восстанавливает удаленный комментарий к фотографии.
- Photos.Save — Сохраняет фотографии после успешной загрузки.
- Photos.SaveMarketAlbumPhoto — Сохраняет фотографии после успешной загрузки на URI, полученный методом ph/otos.getMarketAlbumUploadServer.
- Photos.SaveMarketPhoto — Сохраняет фотографии после успешной загрузки на URI, полученный методом ph/otos.getMarketUploadServer.
- Photos.SaveMessagesPhoto — Сохраняет фотографию после успешной загрузки на URI, полученный методом ph/otos.getMessagesUploadServer.
- Photos.SaveOwnerCoverPhoto — Сохраняет изображение для обложки сообщества после успешной загрузки.
- Photos.SaveOwnerPhoto — Позволяет сохранить главную фотографию пользователя или сообщества.
- Photos.SaveWallPhoto — Сохраняет фотографии после успешной загрузки на URI, полученный методом ph/ otos.getWallUploadServer.
- Photos.Search — Осуществляет поиск изображений по местоположению или описанию.
Видео
- Video.Add — Добавляет видеозапись в список пользователя.
- Video.AddAlbum — Создает пустой альбом видеозаписей.
- Video.AddToAlbum — Позволяет добавить видеозапись в альбом.
- Video.CreateComment — Cоздает новый комментарий к видеозаписи.
- Video.Delete — Удаляет видеозапись со страницы пользователя.
- Video.DeleteAlbum — Удаляет альбом видеозаписей.
- Video.DeleteComment — Удаляет комментарий к видеозаписи.
- Video.Edit — Редактирует данные видеозаписи.
- Video.EditAlbum — Редактирует название альбома видеозаписей.
- Video.EditComment — Изменяет текст комментария к видеозаписи.
- Video.Get — Возвращает информацию о видеозаписях.
- Video.GetAlbumById — Позволяет получить информацию об альбоме с видео.
- Video.GetAlbums — Возвращает список альбомов видеозаписей пользователя или сообщества.
- Video.GetAlbumsByVideo — Возвращает список альбомов, в которых находится видеозапись.
- (Устаревший) Video.GetCatalog — Позволяет получить представление каталога видео.
- (Устаревший) Video.GetCatalogSection — Позволяет получить отдельный блок видеокаталога.
- Video.GetComments — Возвращает список комментариев к видеозаписи.
- (Устаревший) Video.HideCatalogSection — Скрывает для пользователя раздел видеокаталога.
- Video.RemoveFromAlbum — Позволяет убрать видеозапись из альбома.
- (Устаревший) Video.RemoveTag — Удаляет отметку с видеозаписи.
- Video.ReorderAlbums — Позволяет изменить порядок альбомов с видео.
- Video.ReorderVideos — Позволяет переместить видеозапись в альбоме.
- Video.Report — Позволяет пожаловаться на видеозапись.
- Video.ReportComment — Позволяет пожаловаться на комментарий к видеозаписи.
- Video.Restore — Восстанавливает удаленную видеозапись.
- Video.RestoreComment — Восстанавливает удаленный комментарий к видеозаписи.
- Video.Save — Возвращает адрес сервера (необходимый для загрузки) и данные видеозаписи.
- Video.Search — Возвращает список видеозаписей в соответствии с заданным критерием поиска.
Закладки
- Fave.AddArticle — Добавляет статью в закладки.
- (Устаревший) Fave.AddGroup — Добавляет сообщество в закладки.
- Fave.AddLink — Добавляет ссылку в закладки.
- Fave.AddPage — Добавляет сообщество или пользователя в закладки.
- Fave.AddPost — Добавляет запись со стены пользователя или сообщества в закладки.
- Fave.AddProduct — Добавляет товар в закладки.
- Fave.AddTag — Создает метку в закладки.
- (Устаревший) Fave.AddUser — Добавляет пользователя в закладки.
- Fave.AddVideo — Добавляет видеозапись в закладки.
- Fave.EditTag — Редактирует метку.
- Fave.Get — Возвращает объекты, добавленные в закладки пользователя..
- (Устаревший) Fave.GetLinks — Возвращает ссылки, добавленные в закладки текущим пользователем.
- (Устаревший) Fave.GetMarketItems — Возвращает товары, добавленные в закладки текущим пользователем.
- Fave.GetPages — Возвращает страницы пользователей и сообществ, добавленных в закладки.
- (Устаревший) Fave.GetPhotos — Возвращает фотографии, на которых текущий пользователь поставил отметку “Мне нравится”.
- (Устаревший) Fave.GetPosts — Возвращает записи, на которых текущий пользователь поставил отметку «Мне нравится».
- Fave.GetTags — Возвращает список меток в закладках.
- (Устаревший) Fave.GetUsers — Возвращает список пользователей, добавленных текущим пользователем в закладки.
- (Устаревший) Fave.GetVideos — Возвращает список видеозаписей, на которых текущий пользователь поставил отметку «Мне нравится».
- Fave.MarkSeen — Отмечает закладки как просмотренные.
- Fave.RemoveArticle — Добавляет видеозапись в закладки.
- (Устаревший) Fave.RemoveGroup — Удаляет сообщество из закладок.
- Fave.RemoveLink — Добавляет видеозапись в закладки.
- Fave.RemovePage — Добавляет видеозапись в закладки.
- Fave.RemovePost — Добавляет видеозапись в закладки.
- Fave.RemoveProduct — Добавляет видеозапись в закладки.
- Fave.RemoveTag — Добавляет видеозапись в закладки.
- (Устаревший) Fave.RemoveUser — Удаляет пользователя из закладок.
- Fave.RemoveVideo — Добавляет видеозапись в закладки.
- Fave.ReorderTags — Добавляет видеозапись в закладки.
- Fave.SetPageTags — Добавляет видеозапись в закладки.
- Fave.SetTags — Добавляет видеозапись в закладки.
- Fave.TrackPageInteraction — Добавляет видеозапись в закладки.
Служебные
- Utils.CheckLink — Возвращает информацию о том, является ли внешняя ссылка заблокированной на сайте ВКонтакте.
- Utils.deleteFromLastShortened — !!Удаляет сокращенную ссылку из списка пользователя.
- Utils.getLastShortenedLinks — !!Получает список сокращенных ссылок для текущего пользователя.
- Utils.getLinkStats — !!Возвращает статистику переходов по сокращенной ссылке.
- Utils.GetServerTime — Возвращает текущее время на сервере ВКонтакте.
- Utils.getShortLink — !!Позволяет получить URL, сокращенный с помощью vk.cc.
- Utils.ResolveScreenName — Определяет тип объекта (пользователь, сообщество, приложение) и его идентификатор по короткому имени screenName.
Данные ВК
- Database.GetChairs — Возвращает список кафедр университета по указанному факультету.
- Database.GetCities — Возвращает список городов.
- Database.GetCitiesById — Возвращает информацию о городах по их идентификаторам.
- Database.GetCountries — Возвращает список стран.
- Database.GetCountriesById — Возвращает информацию о странах по их идентификаторам
- Database.GetFaculties — Возвращает список факультетов.
- Database.GetMetroStations — Возвращает список станций метро.
- Database.getMetroStationsById — Возвращает информацию об одной или нескольких станциях метро по их идентификаторам.
- Database.GetRegions — Возвращает список регионов.
- Database.GetSchoolClasses — Возвращает список классов, характерных для школ определенной страны.
- Database.GetSchools — Возвращает список школ.
- (Устаревший) Database.GetStreetsById — Возвращает информацию об улицах по их идентификаторам (id).
- Database.GetUniversities — Возвращает список высших учебных заведений.
Новости
- Newsfeed.AddBan — Запрещает показывать новости от заданных пользователей и групп в ленте новостей текущего пользователя.
- Newsfeed.DeleteBan — Разрешает показывать новости от заданных пользователей и групп в ленте новостей текущего пользователя.
- Newsfeed.DeleteList — Метод позволяет удалить пользовательский список новостей
- Newsfeed.Get — Возвращает данные, необходимые для показа списка новостей для текущего пользователя.
- Newsfeed.GetBanned — Возвращает список пользователей и групп, которые текущий пользователь скрыл из ленты новостей.
- Newsfeed.GetComments — Возвращает данные, необходимые для показа раздела комментариев в новостях пользователя.
- Newsfeed.GetLists — Возвращает пользовательские списки новостей.
- Newsfeed.GetMentions — Возвращает список записей пользователей на своих стенах, в которых упоминается указанный пользователь.
- Newsfeed.GetRecommended — Получает список новостей, рекомендованных пользователю.
- Newsfeed.GetSuggestedSources — Возвращает сообщества и пользователей, на которые текущему пользователю рекомендуется подписаться.
- Newsfeed.IgnoreItem — Позволяет скрыть объект из ленты новостей.
- Newsfeed.SaveList — Метод позволяет создавать или редактировать пользовательские списки для просмотра новостей.
- Newsfeed.Search — Возвращает результаты поиска по статусам. Новости возвращаются в порядке от более новых к более старым.
- Newsfeed.UnignoreItem — Позволяет вернуть ранее скрытый объект в ленту новостей.
- Newsfeed.Unsubscribe — Отписывает текущего пользователя от комментариев к заданному объекту.
Мне нравится
- Likes.Add — Добавляет указанный объект в список Мне нравится текущего пользователя.
- Likes.Delete — Удаляет указанный объект из списка Мне нравится текущего пользователя.
- Likes.GetList — Получает список идентификаторов пользователей, которые добавили заданный объект в свой список Мне нравится.
- Likes.IsLiked — Проверяет, находится ли объект в списке Мне нравится заданного пользователя.
Авторизация
- Auth.CheckPhone — Проверяет правильность введённого номера.
- Auth.Restore — Позволяет восстановить доступ к аккаунту, используя код, полученный через SMS. Данный метод доступен только приложениям, имеющим доступ к Прямой авторизации.
- (Устаревший) Auth.Signup — Регистрирует нового пользователя по номеру телефона.
- (Устаревший) Auth.Confirm — Завершает регистрацию нового пользователя, начатую методом auth.signup, по коду, полученному через SMS.
Статистика
- Stats.Get — Возвращает статистику сообщества или приложения.
- Stats.GetPostReach — Возвращает статистику для записи на стене.
- Stats.TrackVisitor — Добавляет данные о текущем сеансе в статистику посещаемости приложения.
Подарки
- Gifts.Get — Возвращает список полученных подарков пользователя.
Страницы
- Pages.ClearCache — Позволяет очистить кеш отдельных внешних страниц, которые могут быть прикреплены к записям ВКонтакте. После очистки кеша при последующем прикреплении ссылки к записи, данные о странице будут обновлены.
- Pages.Get — Возвращает информацию о вики-странице.
- Pages.GetHistory — Возвращает список всех старых версий вики-страницы.
- Pages.GetTitles — Возвращает список вики-страниц в группе.
- Pages.GetVersion — Возвращает текст одной из старых версий страницы.
- Pages.ParseWiki — Возвращает html-представление вики-разметки.
- Pages.Save — Сохраняет текст вики-страницы.
- Pages.SaveAccess — Сохраняет новые настройки доступа на чтение и редактирование вики-страницы.
Документы
- Docs.Add — Копирует документ в документы текущего пользователя.
- Docs.Delete — Удаляет документ пользователя или группы.
- Docs.Edit — Редактирует документ пользователя или группы.
- Docs.Get — Возвращает расширенную информацию о документах пользователя или сообщества.
- Docs.GetById — Возвращает информацию о документах по их идентификаторам.
- Docs.GetMessagesUploadServer — !!Получает адрес сервера для загрузки документа в личное сообщение.
- Docs.GetTypes — Возвращает доступные типы документы для пользователя
- Docs.GetUploadServer — Возвращает адрес сервера для загрузки документов.
- Docs.GetWallUploadServer — Возвращает адрес сервера для загрузки документов в папку Отправленные, для последующей отправки документа на стену или личным сообщением.
- Docs.Save — Сохраняет документ после его успешной загрузки на сервер.
- Docs.Search — Возвращает результаты поиска по документам.
Приложения
- Apps.DeleteAppRequests — Удаляет все уведомления о запросах, отправленных из текущего приложения
- Apps.Get — Возвращает данные о запрошенном приложении на платформе ВКонтакте
- Apps.GetCatalog — Возвращает список приложений, доступных для пользователей сайта через каталог приложений.
- Apps.GetFriendsList — Создает список друзей, который будет использоваться при отправке пользователем приглашений в приложение и игровых запросов.
- Apps.GetLeaderboard — Возвращает рейтинг пользователей в игре.
- Apps.GetScopes — !!Нет данных.
- Apps.GetScore — Метод возвращает количество очков пользователя в этой игре.
- Apps.PromoHasActiveGift — Проверяет есть ли у пользователя подарок в игре.
- Apps.PromoUseGift — Использовать подарок, полученный пользователем в промо-акции.
- Apps.SendRequest — Позволяет отправить запрос другому пользователю в приложении, использующем авторизацию ВКонтакте.
Товары
- Market.Add — Добавляет новый товар.
- Market.AddAlbum — Добавляет новую подборку с товарами.
- Market.AddToAlbum — Добавляет товар в одну или несколько выбранных подборок.
- Market.CreateComment — Создает новый комментарий к товару.
- Market.Delete — Удаляет товар.
- Market.DeleteAlbum — Удаляет подборку с товарами.
- Market.DeleteComment — Удаляет комментарий к товару.
- Market.Edit — Редактирует товар.
- Market.EditAlbum — Редактирует подборку с товарами.
- Market.EditComment — Изменяет текст комментария к товару.
- Market.Get — Возвращает список товаров в сообществе.
- Market.GetAlbums — Возвращает список подборок с товарами.
- Market.GetAlbumById — Возвращает данные подборки с товарами.
- Market.GetById — Возвращает информацию о товарах по идентификаторам.
- Market.GetCategories — Возвращает список категорий для товаров.
- Market.GetComments — Возвращает список комментариев к товару.
- Market.RemoveFromAlbum — Удаляет товар из одной или нескольких выбранных подборок.
- Market.ReorderAlbums — Изменяет положение подборки с товарами в списке.
- Market.ReorderItems — Изменяет положение товара в подборке.
- Market.Report — Позволяет отправить жалобу на товар.
- Market.ReportComment — Позволяет оставить жалобу на комментарий к товару.
- Market.Restore — Восстанавливает удаленный товар.
- Market.RestoreComment — Восстанавливает удаленный комментарий к товару.
- Market.Search — Ищет товары в каталоге сообщества.
Аккаунт
- Account.Ban — Добавляет пользователя или группу в черный список.
- Account.ChangePassword — Позволяет сменить пароль пользователя после успешного восстановления доступа к аккаунту через СМС, используя метод auth.restore.
- Account.GetActiveOffers — Возвращает список активных рекламных предложений (офферов), выполнив которые пользователь сможет получить соответствующее количество голосов на свой счёт внутри приложения.
- Account.GetAppPermissions — Получает настройки текущего пользователя в данном приложении.
- Account.GetBanned — Возвращает список пользователей, находящихся в черном списке.
- Account.GetCounters — Возвращает ненулевые значения счетчиков пользователя.
- Account.GetInfo — Возвращает информацию о текущем аккаунте.
- Account.GetProfileInfo — Возвращает информацию о текущем профиле.
- Account.GetPushSettings — Позволяет получать настройки Push уведомлений.
- Account.RegisterDevice — Подписывает устройство на базе iOS, Android или Windows Phone на получение Push-уведомлений.
- Account.SaveProfileInfo — Редактирует информацию текущего профиля.
- Account.SetInfo — Позволяет редактировать информацию о текущем аккаунте.
- Account.SetNameInMenu — Устанавливает короткое название приложения (до 17 символов), которое выводится пользователю в левом меню.
- Account.SetOffline — Помечает текущего пользователя как offline.
- Account.SetOnline — Помечает текущего пользователя как online на 15 минут.
- Account.SetPushSettings — Изменяет настройку Push-уведомлений.
- Account.SetSilenceMode — Отключает push-уведомления на заданный промежуток времени.
- Account.Unban — Убирает пользователя из черного списка.
- Account.UnregisterDevice — Отписывает устройство от Push уведомлений.
Рекламный Кабинет
- Ads.AddOfficeUsers — Добавляет администраторов и/или наблюдателей в рекламный кабинет.
- Ads.CheckLink — Проверяет ссылку на рекламируемый объект.
- Ads.CreateAds — Создает рекламные объявления.
- Ads.CreateCampaigns — Создает рекламные кампании.
- Ads.CreateClients — оздаёт клиентов рекламного агентства.
- Ads.CreateLookalikeRequest — Создаёт запрос на поиск похожей аудитории.
- Ads.CreateTargetGroup — Создает аудиторию для ретаргетинга рекламных объявлений на пользователей, которые посетили сайт рекламодателя (просмотрели информации о товаре, зарегистрировались и т.д.).
- Ads.CreateTargetPixel — Создаёт пиксель ретаргетинга.
- Ads.DeleteAds — Архивирует рекламные объявления.
- Ads.DeleteCampaigns — Архивирует рекламные кампании.
- Ads.DeleteClients — Архивирует клиентов рекламного агентства.
- Ads.DeleteTargetGroup — Удаляет аудиторию ретаргетинга.
- Ads.DeleteTargetPixel — Удаляет пиксель ретаргетинга.
- Ads.GetAccounts — Возвращает список рекламных кабинетов.
- Ads.GetAds — Возвращает список рекламных объявлений.
- Ads.GetAdsLayout — Возвращает описания внешнего вида рекламных объявлений.
- Ads.GetAdsTargeting — Возвращает параметры таргетинга рекламных объявлений
- Ads.GetBudget — Возвращает текущий бюджет рекламного кабинета.
- Ads.GetCampaigns — Возвращает список кампаний рекламного кабинета.
- Ads.GetCategories — Позволяет получить возможные тематики рекламных объявлений.
- Ads.GetClients — Возвращает список клиентов рекламного агентства.
- Ads.GetDemographics — Возвращает демографическую статистику по рекламным объявлениям или кампаниям.
- Ads.GetFloodStats — Возвращает информацию о текущем состоянии счетчика — количество оставшихся запусков методов и время до следующего обнуления счетчика в секундах.
- Ads.GetLookalikeRequests — Возвращает список запросов на поиск похожей аудитории.
- Ads.GetOfficeUsers — Возвращает список администраторов и наблюдателей рекламного кабинета.
- Ads.GetPostsReach — Возвращает подробную статистику по охвату рекламных записей из объявлений и кампаний для продвижения записей сообщества.
- Ads.GetRejectionReason — Возвращает причину, по которой указанному объявлению было отказано в прохождении премодерации.
- Ads.GetStatistics — Возвращает статистику показателей эффективности по рекламным объявлениям, кампаниям, клиентам или всему кабинету.
- Ads.GetSuggestions — Возвращает набор подсказок для различных параметров таргетинга.
- Ads.GetTargetGroups — Возвращает список аудиторий ретаргетинга.
- Ads.GetTargetPixels — Возвращает список пикселей ретаргетинга.
- Ads.GetTargetingStats — Возвращает размер целевой аудитории таргетинга, а также рекомендованные значения CPC и CPM.
- Ads.GetUploadURL — Возвращает URL-адрес для загрузки фотографии рекламного объявления.
- Ads.GetVideoUploadURL — Возвращает URL-адрес для загрузки видеозаписи рекламного объявления.
- Ads.ImportTargetContacts — Импортирует список контактов рекламодателя для учета зарегистрированных во ВКонтакте пользователей в аудитории ретаргетинга.
- Ads.RemoveOfficeUsers — Удаляет администраторов и/или наблюдателей из рекламного кабинета.
- Ads.RemoveTargetContacts — Принимает запрос на исключение контактов рекламодателя из аудитории ретаргетинга.
- Ads.SaveLookalikeRequestResult — Сохраняет результат поиска похожей аудитории.
- Ads.ShareTargetGroup — Предоставляет доступ к аудитории ретаргетинга другому рекламному кабинету. В результате выполнения метода возвращается идентификатор аудитории для указанного кабинета.
- Ads.UpdateAds — Редактирует рекламные объявления.
- Ads.UpdateCampaigns — Редактирует рекламные кампании.
- Ads.UpdateClients — Редактирует клиентов рекламного агентства.
- Ads.UupdateTargetGroup — Редактирует аудиторию ретаргетинга.
- Ads.UpdateTargetPixel — Редактирует пиксель ретаргетинга.
Обсуждения
- Board.AddTopic — Создает новую тему в списке обсуждений группы.
- Board.CloseTopic — Закрывает тему в списке обсуждений группы (в такой теме невозможно оставлять новые сообщения).
- Board.CreateComment — Добавляет новый комментарий в обсуждении.
- Board.DeleteComment — Удаляет сообщение темы в обсуждениях сообщества.
- Board.DeleteTopic — Удаляет тему в обсуждениях группы.
- Board.EditComment — Редактирует одно из сообщений в обсуждении сообщества.
- Board.EditTopic — Изменяет заголовок темы в списке обсуждений группы.
- Board.FixTopic — Закрепляет тему в списке обсуждений группы (такая тема при любой сортировке выводится выше остальных).
- Board.GetComments — Возвращает список сообщений в указанной теме.
- Board.GetTopics — Возвращает список тем в обсуждениях указанной группы.
- Board.OpenTopic — Открывает ранее закрытую тему (в ней станет возможно оставлять новые сообщения).
- Board.RestoreComment — Восстанавливает удаленное сообщение темы в обсуждениях группы.
- Board.UnfixTopic — Отменяет прикрепление темы в списке обсуждений группы (тема будет выводиться согласно выбранной сортировке).
Управление рекламными акциями (офферами)
- Leads.CheckUser — Проверяет, доступна ли рекламная акция пользователю.
- Leads.Complete — Завершает начатую пользователем рекламную акцию, используя сессию и секретный ключ.
- Leads.GetStats — Возвращает статистику по рекламной акции.
- Leads.GetUsers — Возвращает список последних действий пользователей по рекламной акции.
- Leads.MetricHit — Засчитывает событие метрики.
- Leads.Start — Создаёт новую сессию для прохождения рекламной акции для пользователя.
Заметки
- Notes.Add — Создает новую заметку у текущего пользователя.
- Notes.CreateComment — Добавляет новый комментарий к заметке.
- Notes.Delete — Удаляет заметку текущего пользователя.
- Notes.DeleteComment — Удаляет комментарий к заметке.
- Notes.Edit — Редактирует заметку текущего пользователя.
- Notes.EditComment — Редактирует указанный комментарий у заметки.
- Notes.Get — Возвращает список заметок, созданных пользователем.
- Notes.GetById — Возвращает заметку по её id.
- Notes.GetComments — Возвращает список комментариев к заметке.
- Notes.RestoreComment — Восстанавливает удалённый комментарий.
Оповещения
- Notifications.Get — Возвращает список оповещений об ответах других пользователей на записи текущего пользователя.
- Notifications.MarkAsViewed — Сбрасывает счетчик непросмотренных оповещений об ответах других пользователей на записи текущего пользователя.
Опросы
- Polls.AddVote — Отдает голос текущего пользователя за выбранный вариант ответа в указанном опросе.
- Polls.Create — Позволяет создавать опросы, которые впоследствии можно прикреплять к записям на странице пользователя или сообщества.
- Polls.DeleteVote — Снимает голос текущего пользователя с выбранного варианта ответа в указанном опросе.
- Polls.Edit — Позволяет редактировать созданные опросы.
- Polls.GetById — Возвращает детальную информацию об опросе по его идентификатору.
- Polls.GetVoters — Получает список идентификаторов пользователей, которые выбрали определенные варианты ответа в опросе.
Поиск
- Search.GetHints — Метод позволяет получить результаты быстрого поиска по произвольной подстроке.
Административные методы от имени приложения
- Secure.AddAppEvent — Добавляет информацию о достижениях пользователя в приложении.
- Secure.CheckToken — Позволяет проверять валидность пользователя в IFrame, Flash и Standalone-приложениях с помощью передаваемого в приложения параметра access_token.
- Secure.GetAppBalance — Возвращает платежный баланс (счет) приложения в сотых долях голоса.
- Secure.GetSMSHistory — Выводит список SMS-уведомлений, отосланных приложением с помощью метода secure.sendSMSNotification.
- Secure.GetTransactionsHistory — Выводит историю транзакций по переводу голосов между пользователями и приложением.
- Secure.GetUserLevel — Возвращает ранее выставленный игровой уровень одного или нескольких пользователей в приложении.
- Secure.GiveEventSticker — Выдает пользователю стикер и открывает игровое достижение.
- Secure.SendNotification — Отправляет уведомление пользователю.
- Secure.SendSMSNotification — Отправляет SMS-уведомление на мобильный телефон пользователя.
- Secure.SetCounter — Устанавливает счетчик, который выводится пользователю жирным шрифтом в левом меню.
Переменные в приложении
- Storage.Get — Возвращает значение переменной, название которой передано в параметре key.
- Storage.GetKeys — Возвращает названия всех переменных.
- Storage.Set — Сохраняет значение переменной, название которой передано в параметре key.
Формы сбора заявок
Истории
- Stories.BanOwner — Позволяет скрыть из ленты новостей истории от выбранных источников.
- Stories.Delete — Удаляет историю.
- Stories.Get — Возвращает истории, доступные для текущего пользователя.
- Stories.GetBanned — Возвращает список источников историй, скрытых из ленты текущего пользователя.
- Stories.GetById — Возвращает информацию об истории по её идентификатору.
- Stories.GetPhotoUploadServer — Позволяет получить адрес для загрузки истории с фотографией.
- Stories.GetReplies — Позволяет получить ответы на историю.
- Stories.GetStats — Возвращает статистику истории.
- Stories.GetVideoUploadServer — Позволяет получить адрес для загрузки видеозаписи в историю.
- Stories.GetViewers — Возвращает список пользователей, просмотревших историю.
- Stories.HideAllReplies — Скрывает все ответы автора за последние сутки на истории текущего пользователя.
- Stories.HideReply — Скрывает ответ на историю.
- Stories.UnbanOwner — Позволяет вернуть пользователя или сообщество в список отображаемых историй в ленте.
Виджеты приложений
- AppWidgets.GetAppImageUploadServer — Позволяет получить адрес для загрузки фотографии в коллекцию приложения для виджетов приложений сообществ.
- AppWidgets.GetAppImages — Позволяет получить коллекцию изображений, загруженных для приложения, в виджетах приложений сообществ.
- AppWidgets.GetGroupImageUploadServer — Позволяет получить адрес для загрузки фотографии в коллекцию сообщества для виджетов приложений сообществ.
- AppWidgets.GetGroupImages — Позволяет получить коллекцию изображений, загруженных для приложения, в виджетах приложений сообществ.
- AppWidgets.GetImagesById — Позволяет получить изображение для виджетов приложений сообществ по его идентификатору.
- AppWidgets.SaveAppImage — Позволяет сохранить изображение в коллекцию приложения для виджетов приложений сообществ после загрузки на сервер.
- AppWidgets.SaveGroupImage — Позволяет сохранить изображение в коллекцию сообщества для виджетов приложений сообществ. после загрузки на сервер.
- AppWidgets.Update — Позволяет обновить виджет приложения сообщества. Виджет обязательно должен быть уже установлен в сообществе.
Streaming API
- Streaming.GetServerUrl — Позволяет получить данные для подключения к Streaming API.
- Streaming.GetSettings — Позволяет получить значение порога для Streaming API.
- Streaming.GetStats — Позволяет получить статистику для подготовленных и доставленных событий Streaming API.
- Streaming.SetSettings — Позволяет задать значение порога для Streaming API.
Состояние заказов
Виджеты
- Widgets.GetComments — Получает список комментариев к странице, оставленных через Виджет комментариев.
- Widgets.GetPages — Получает список страниц приложения/сайта, на которых установлен Виджет комментариев или «Мне нравится».
Группы
Стена
- Wall.GetComment — !!Получает информацию о комментарии на стене.
Оповещения
- Notifications.SendMessage — Отправляет уведомление пользователю приложения VK Apps.
Опросы
- Polls.SavePhoto — Сохраняет фотографию, загруженную в опрос.
- Polls.GetBackgrounds — Возвращает варианты фонового изображения для опросов.
- Polls.GetPhotoUploadServer — Возвращает адрес сервера для загрузки фоновой фотографии в опрос.
Места
Подкасты
Карусель
Истории
- Stories.Search — Возвращает результаты поиска по историям.
Streaming API
Hosted on GitHub Pages
3.6.0 (25.07.2021) | Улучшения
|
3.5.1 (10.07.2021) | Исправления
|
3.5.0 (09.07.2021) | Улучшения
|
3.4.0 (18.01.2021) | Улучшения
|
3.3.1 (30.12.2020) | Исправления
|
3.3.0 (30.12.2020) | Улучшения
|
3.2.18 (07.12.2020) | Исправления
|
3.2.17 (03.12.2020) | Исправления
|
3.2.16 (03.12.2020) | Исправления
|
3.2.15 (24.11.2020) | Исправления
|
3.2.14 (23.11.2020) | Исправления
|
3.2.13 (09.11.2020) | Исправления
|
3.2.12 (05.11.2020) | Исправления
|
3.2.11 (02.11.2020) | Исправления
|
3.2.10 (01.11.2020) | Исправления
|
3.2.9 (31.10.2020) | Исправления
|
3.2.8 (31.10.2020) | Исправления
|
3.2.7 (31.10.2020) | Исправления
|
3.2.6 (21.10.2020) | Исправления
|
3.2.5 (10.10.2020) | Исправления
|
3.2.4 (05.10.2020) |
|
3.2.3 (02.10.2020) |
|
3.2.2 (02.10.2020) |
|
3.2.1 (02.10.2020) |
|
3.2.0 (30.09.2020) | 1. Добавлена поддержка расширенного типа раздела товаров — Магазин 2.0, в частности работу с объединенными товарами, добавление свойств пока недоступно через api |
3.1.1 (29.09.2020) |
|
3.1.0 (22.09.2020) |
|
3.0.24 (11.09.2020) | Исправления связанные с ajax |
3.0.23 (24.08.2020) | Некоторые исправления из за которых появлялась «неизвестная ошибка» |
3.0.22 (19.08.2020) | Исправлена ошибка автоматического экспорта при заданном времени старта экспорта в настройках |
3.0.21 (24.07.2020) | Исправление в условиях отбора товаров для клиентской части |
3.0.20 (17.07.2020) |
|
3.0.19 (10.06.2020) |
|
3.0.18 (09.06.2020) |
|
3.0.17 (08.06.2020) | Исправлена выгрузка картинок подборок |
3.0.16 (08.06.2020) | Корректировка ограничения названия товаров |
3.0.15 (07.06.2020) |
|
3.0.14 (28.05.2020) |
|
3.0.13 (28.05.2020) |
|
3.0.12 (20.05.2020) |
|
3.0.11 (20.05.2020) | Исправление ошибки по которой после смены группы не выгружались те же подборки в другую группу |
3.0.10 (20.05.2020) | Изменения в логике подготовки товаров для выгрузки в вк |
3.0.9 (20.05.2020) | Изменения в логике выгрузки товаров связанное с появление дубликатов и ошибки …invalid: owner_id is undefined |
3.0.8 (10.05.2020) | Исправление работы логики добавления выгрузки на редакциях без модуля каталога, валюты |
3.0.7 (10.02.2020) |
|
3.0.6 (01.02.2020) | Исправлена логика выгрузки подборок |
3.0.5 (31.01.2020) |
|
3.0.4 (25.01.2020) |
|
3.0.3 (22.01.2020) | Изменения в агенте автоматического экспорта |
3.0.2 (21.01.2020) | Изменения в конструкторе описания |
3.0.1 (21.01.2020) | Подключение стилей и js обновили |
3.0.0 (19.01.2020) |
|
2.8.0 (05.07.2019) | Добавлена возможность указать прокси сервер поддерживающий https, для тех у кого заблокирован доступ к вк |
2.7.1 (26.04.2019) | Теперь в описании вырезаются теги вне зависимости от того, какой тип описания указан text или html |
2.7.0 (20.03.2019) |
|
2.6.3 (16.12.2018) |
|
2.6.2 (24.08.2018) |
|
2.6.1 (02.07.2018) | Исправлена ошибка с правами доступа к странице редактирования или добавления выгрузки |
2.6.0 (16.10.2017) | Добавлена возможность задать сортировку разделам, учитывается только при создании подборок |
2.5.9 (16.10.2017) | Исправлена ошибка при ручной выгрузке с неверным колчиеством товара обарабатываемого |
2.5.8 (16.10.2017) | Некоторые изменения выгрузке |
2.5.7 (11.10.2017) |
|
2.5.6 (11.10.2017) | Корректировка добавления аккаунтов в случае если не установлен сайт по умолчанию или не указаны домены сайтов |
2.5.5 (30.09.2017) | Улучшение в логике ручной выгрузки |
2.5.4 (30.09.2017) | Добавлена опция в выгрузку объединеных торговых предложений при типе описания — колонки, которая исключает повторяющиеся значения свойств |
2.5.3 (27.09.2017) | Некоторые изменения в обработчке текстов перед выгрузкой, восстановление символов для описания в вк при использовании типа описани — текст |
2.5.2 (27.09.2017) | Теперь обновляются только изменившиеся товары и подборки, в холостую тратиться запросы не будут |
2.5.1 (25.09.2017) | Изменение текстов сообщений |
2.5.0 (25.09.2017) | Исправлена ошибка выгрузки товаров из инфоблока не являющегося торговым каталогом (галочка Является торговым каталогом в настройках инфоблока) |
2.4.9 (25.09.2017) | На странице списка выгрузок отображается сообщение о том что производится ручной экспорт и кнопка, чтобы убрать все флаги ручного экспорта и автоматический экспорт выполнялся |
2.4.8 (08.09.2017) | Корректировка автоматического экспорта |
2.4.7 (07.09.2017) |
|
2.4.6 (04.09.2017) | Использование в ручной выгрузке тех же лимитов что и в автоматизированной из настроек модуля |
2.4.5 (04.09.2017) | Возвращена возможность задать количество обрабатываемых за раз товаров и разделов в настройках модуля |
2.4.4 (04.09.2017) | Исправление недочета выгрузки |
2.4.3 (04.09.2017) | Ускорение выгрузки до 10 раз |
2.4.2 (02.09.2017) |
|
2.4.1 (29.08.2017) | Исправлена ошибка в административной части модуля |
2.4.0 (28.08.2017) | Сокращение шага при ручном экспорте |
2.3.9 (28.08.2017) | Изменения в ручной выгрузке |
2.3.8 (28.08.2017) | Некоторые улучшения и исправления |
2.3.7 (25.08.2017) | Исправление логики автоматического экспорта торговых предложений, исправление ошибки связанной с агенто fastAgent |
2.3.6 (23.08.2017) | Некоторые улучшения |
2.3.5 (23.08.2017) |
|
2.3.4 (02.05.2017) | Исправление грамматических ошибок |
2.3.3 (21.04.2017) | Исправление недочетов в логике отбора товаров в разных выгрузках |
2.3.2 (19.04.2017) | Исправлена ошибка с картинками для товаров |
2.3.1 (19.04.2017) | Исправление ошибки при использовании документооборота |
2.3.0 (16.04.2017) | Изменения в логике отбора простых товаров и товаров с торговыми предложениями с учетом активности и наличия |
2.2.5 (15.04.2017) | Добавлена поддержка старых версий php, поддерживаются версии начиная с версии 5.3 |
2.2.1 (15.04.2017) | Исправление ошибок в названиях |
2.2.0 (15.04.2017) |
|
2.1.0 (08.04.2017) | Изменения в логике, исправление недочетов |
2.0.1 (03.04.2017) | Некоторые исправления |
2.0.0 (01.04.2017) | Модуль полностью переработан, исправлены ошибки, изменена логика выгрузки, добавлены новые возможности:
-удобное построение шаблонов описаний к товарам простым и с тп; — учет скидок; — учет наличия; — автоматическое обновление. добавление. удаление; — управление подборками ; — и другое. |
1.0.5 (15.03.2017) | Исправлена ошибка в демо режиме с выгрузкой |
1.0.4 (19.01.2017) | Исправления на странице редактирования выгрузки |
1.0.3 (18.01.2017) | Изменения в добавлении аккаунтов |
1.0.2 (13.01.2017) | Некоторые улучшения, в том числе исправление ошибки EXPIRES_IN |
1.0.1 (30.12.2016) | Исправление ошибок |
Как добавить товары в группу ВК: создаем и сортируем карточки
Делаем вашу страницу интересной и стимулируем подписчиков почаще заглядывать к вам на страницу или на сайт за покупками
Получи нашу книгу «Контент-маркетинг в социальных сетях: Как засесть в голову подписчиков и влюбить их в свой бренд».
Подпишись на рассылку и получи книгу в подарок!
Вконтакте уже давно перестала быть обычной социальной сетью для общения людей. Сегодня это полноценная площадка для ведения бизнеса, открывающая бизнесменам широкий перечень возможностей. Здесь можно открывать интернет-магазины, добавлять товары и услуги, продвигать их. Сегодня мы рассмотрим, как добавить товары в группу ВК, что для этого нужно.
Преимущества интернет-магазина в ВК
В самом начале хотелось бы перечислить преимущества открытия интернет-магазина в ВК:
- Широкий охват аудитории. В соц.сети сегодня зарегистрировано огромное количество людей со всей территории РФ, а также с других стран, различного возраста. Открыв, торговую площадку в ВК вы автоматически получаете доступ к огромной аудитории.
- Простота и удобство. Открытие магазина на самостоятельном сайте требует гораздо больше времен, усилий и финансов. Необходимо решить вопросы с хостингом, доменом, обслуживанием и так далее.
- Возможность использования социальных доказательств. Ресурс позволяет совершенно бесплатно использовать лайки и комментарии для анализа представленной продукции, проводимых акций. Если товарная позиция/услуга/мероприятие не набирает много лайков и комментариев, нет репостов, необходимо предпринимать меры для изменения ситуации.
- Широкие возможности для продвижения. Продвигать в соц.сетях ВК-магазин гораздо проще, чем самостоятельный сайт.
Как добавить товар в группу Вконтакте
Для организации магазина в ВК необходимо разработать каталог, добавить товарные позиции, которые потенциальные клиенты смотрели бы и выбирали нужные вещи. Как добавить товар в ВК? С помощью специализированного сервиса соц.сети — «Товары». Использовать сервис можно бесплатно, его отличительная особенность — удобный интерфейс, практичность и функциональность. Подключение сервиса доступно для любой группы, с любым количеством подписчиков. «Товары» совместим как с компьютерным программным обеспечением, так и системами Android, Windows Phone, iOS. Рассмотрим основные шаги, как добавлять товары в группу в Контакте.
Как создать товар в группе в Контакте: подключаем и настраиваем
Открываем группу и заходим в «Управление страницей/сообществом». Далее открываем пункт «Информация», «Товары» и включаем сервис.
Сразу же настраиваем важные сведения, которые могут быть полезны для потребителей:
- Доставка. Сразу пропишите, в каких регионах доступна доставка и на каких условиях она выполняется.
- Валюта. Социальная сеть предлагает на выбор несколько мировых валют: гривна (Украина), тенге (Казахстан), евро (Евросоюз), доллар (США) и в национальной валюте.
- Контакты. Чтобы потребитель мог всегда связаться с вами и задать интересующие вопросы по поводу той или иной товарной позиции. Указывайте рабочие контакты для приема и обработки заказов.
- Описание. Далее предстоит заполнить вики-страницу с основной информацией об общей направленности и тематике магазине, специализации товаров. Ссылка на вики-страницу системой привязывается к любой карточке товара, поэтому здесь можно подробно описать процесс оплаты, доставки, условия возврата и обмена и прочее.
Далее настраиваем комментарии, чтобы все желающие могли оставить свой отзыв. Сохраняем все внесенные изменение и видим на главной странице группы блок с товарами.
Работа с карточками
Каждая позиция должна быть представлена максимально привлекательно, чтобы у пользователя возникало желание совершить покупку. Как создать товар в ВК, а вернее его карточку? Открываем «Товары» и выбираем «Добавить товар». Теперь прописываем всю важную информацию о данной позиции: наименование и описание. Описание должно быть четким, лаконичным, но при этом понятным и полным. Укажите размер товара ВК, материал, страну производства, технические характеристики и прочее.
Далее делаем выгрузку фото товара в ВК. Выбираем 1 основную фотографию и 4 вспомогательных, например, сбоку, в действии, на модели и так далее. В завершение выбираем миниатюру для отображения на странице группы. Особого внимания заслуживает качество фотографий, выбирайте размер фото товаров в ВК минимум 400*700 pxl, следите, чтобы стороны относились друг к другу в пропорции 4:7.
Затем заполняем поле «Категория». Здесь выбираем одну из уже имеющихся категорий. В будущем это позволит составить удобный каталог. Также категории позволяют сортировать товарные позиции, систематизировать их и удобно составлять различные подборки. В конечном виде карточка выглядит следующим образом:
Делаем подборки
Подборки — простой и удобный инструмент, с помощью которого можно разделить товары на группы для облегчения поиска пользователем нужного продукта. Чтобы составить собственную новую подборку выбираем «Создать подборку», придумываем название для нее и загружаем картинку для обложки.
Добавить товары в группу ВК, в созданную подборку можно следующими способами:
- Создаем товарную карточку и в ней сразу указываем привязку к той или иной подборке.
- Редактируем уже имеющийся товар и привязываем его к созданной подборке.
- Сначала создаем подборку, а затем в ней уже создаем товарные карточки.
После того, как собрана подборка, ее можно редактировать, расширять ее или же, наоборот, удалять из нее те или иные элементы. Один товар может входить сразу в несколько подборок, до 10.
Как разместить товар в группе ВК: работа администратора
После создания блока «Товаров» на странице группы система автоматически отображает 3 последние позиции. Администратор группы может изменить товары, которые отображаются на странице. Для этого делаем подборку, в которую включаем 3 основных товара, ваша «козыри». Далее выбираем сделанную подборку как основную.
Также всегда есть возможность внести изменения в карточку товара. Открываем блок товаром, ищем нужную позицию, жмем на нее и жмем на появившуюся картинку карандаша. Помимо этого, товары можно выстроить в собственном порядке, перетягивая их с места на место.
Чтобы сделать акцент на определенном товаре, его можно поместить на странице. Для этого открываем карточку товара и выбираем «Поделиться». Не ограничивайтесь только своим сообществом, делитесь предложением и с другими сообществами. Чтобы изделие постоянно находилось на странице группы, его нужно прикрепить: создаем новую запись, выбираем «Прикрепить», далее открываем «Еще» и «Товары». Или же создаем запись и вставляем в ее тело ссылку на нужную позицию. Выглядит это так:
Делитесь карточкой с друзьями, отправляйте ее сообщением друзьям. Все лайки, которые наберет публикация будут отображаться в первоначальной карточке товара. Обратите внимание, что к одной записи можно прикрепить только одну позицию. Чтобы поделиться сразу несколькими товарами, необходимо составить подборку, а затем уже делиться подборкой.
Если вы желаете приостановить работу магазина, в любой момент можно на время отключить сервис «Товары». После отключения все карточки сохранятся и будут отображаться в группе. Вернуть блок можно будет с помощью включения в настройках.
Как удалить товар в группе ВК
Если товар закончился, вы можете поставить рядом с ним отметку «Недоступный», тогда он автоматически перестанет отображаться на витрине и перенесется на время в недоступные товары. Для этого открываем редактор товара и ставим галочку напротив «Товар недоступен». Как только ассортимент вновь пополнится данным изделием, уберите галочку и карточка вернется на прежнюю позицию.
Если же вы не планируете закупать ту или иную позицию, ее необходимо удалить из блока, чтобы не путать покупателей. Как удалить товары из группы Вконтакте? Достаточно просто. Для этого нажимаем на товар в режиме просмотра (обратите внимание, что используем иконку, а именно работаем с режимом просмотра). Далее появится небольшое меню с действиями: редактировать, удалить, пожаловаться и так далее. Как вы уже поняли, выбираем «Удалить». Далее необходимо будет подтвердить выбранное действие.
Как удалить товары в ВК? К сожалению, соц.сеть не позволяет удалять сразу несколько товарных позиций, необходимо по очереди проделывать данное действие с каждым изделием. Как удалить товар из группы в ВК автоматизировано? Для этого необходимо заказать у программистов специальную программку, а далее совместить ее с API соц. сети. Если у вас сотни позиций для удаления, это существенно сэкономит время.
Доступные возможности для потребителей
Пользователи могут искать нужный товар по цене и названию, фильтровать позиции по стоимости и новизне, ставить лайки и оставлять комментарии, делиться понравившимися позициями.
Кнопка «Связаться с продавцом» позволяет задать интересующий вопрос, сделать заказ, уточнить нюансы о доставке и оплате. К каждому обращению прикрепляется ссылка на обсуждаемую карточку. Обратите внимание, что пользователи хотят получать ответы как можно раньше, поэтому стоит поработать над повышением скорости ответов.
Вместо заключения
Мы рассмотрели, как сделать товар в группе Вконтакте. Надеемся данная информация будет полезной, и вы создадите привлекательных блок «Товары». Однако этого недостаточно, нужно продвигать ВК-магазин для привлечения новых клиентов. Вот несколько советов, как это сделать:
- Почаще делитесь товарными карточками. Рассказывайте своим друзьям о преимуществах того или иного предложения, проводимых акциях и скидках.
- Размещайте на главной, в основной подборке, самые популярные позиции, которые пользуются наибольшим спросом, чтобы зацепить потребителя.
- Не игнорируйте рекламу. ВК-магазин, точно такой же бизнес, как и офлайн торговая площадка и он тоже нуждается в регулярной рекламе. Используйте бесплатную рекламу, + заказывайте платные посты.
- Можно сдружиться с администратором магазина, схожего по тематике, но не прямого конкурента и постить друг у друга карточки товаров.
Нашли ответ на свой вопрос, как сделать товар в ВК? Тогда начинайте действовать, стройте свой бизнес!
Контакт-центр: ВКонтакте
Канал ВКонтакте позволяет создать открытую линию, используя публичную страницу в соцсети ВКонтакте.
Как подключить канал ВКонтакте
Для примера подключим заранее созданную группу ВКонтакте Диваны&Диваны:
- Выбираем канал подключения ВКонтакте, нажимаем кнопку Подключить и авторизовываемся под аккаунтом администратора группы ВКонтакте:
Решение ошибки
Проблема возникает из-за старой сессии авторизации ВКонтакте в браузере Chrome. Для устранения нужно всего лишь перелогиниться в социальной сети:
- Заходим на VK.com, проходим авторизацию;
- Выходим из своего аккаунта путем нажатия кнопки «Выйти», справа вверху;
- Снова проходим авторизацию во ВКонтакте;
- Идем в настройки ОЛ, в канал ВКонтакте и подключаем.
- Соглашаемся на предоставление доступа приложения Bitrix24 Open Channels к вашему аккаунту ВКонтакте, выбираем нужную группу из списка и жмем кнопку Подключить группу:
- Соглашаемся на предоставление доступа приложения Bitrix24 Open Channels к группе ВКонтакте:
- Аналогичным образом подключаются публичные страницы и мероприятия ВКонтакте.
- Настройка канала закончена:
Для повторной настройки канала ВКонтакте нужно кликнуть на ссылку Удалить привязку или Сменить привязку, для удаления канала — Отключить.
Как это работает
Клиент заходит в группу, публичную страницу или мероприятие ВКонтакте, нажимает там кнопку Написать сообщение и общается с оператором:
Общение ведется только через Сообщение в группе, на публичных страницах, мероприятиях, а не на Стене!
У оператора весь диалог также происходит в Бизнес-чате на портале (в десктоп- и в мобильном приложении Битрикс24):
Открытые линии полностью поддерживают виджеты ВКонтакте
ВКонтакте предлагает несколько виджетов, которые вы можете поставить на свой сайт, чтобы принимать сообщения в группу не только из Вконтакта, а напрямую с вашего сайта. Сейчас виджеты такие:
Все эти виджеты совместимы с открытыми линиями в Битрикс24. Для работы с ними ничего дополнительно настраивать не требуется. Если ваша группа ВКонтакте уже подключена к Открытым линиям, то виджет автоматически заработает. Если нет, нужно просто подключить канал ВКонтакте обычным способом.
Все виджеты настраиваются на стороне ВКонтакте.
Пример, как будет выглядеть виджет группы на сайте:
И при диалоге:
Особенности подключения канала ВКонтакте:
- Подключение происходит от имени пользователя ВКонтакте, под аккаунтом которого сейчас авторизован администратор портала.
- При отключении пользователя, происходит автоматическое отключение группы ВКонтакте от канала.
- Если пользователь потерял административные права доступа к группе ВКонтакте, то при открытии страницы настроек канала произойдет его автоматическое отключение.
- Выводится список доступных групп, публичных страниц, мероприятий.
- Общение ведется только через Сообщение групп, публичных страниц, мероприятий, но не на Стене этих групп, страниц и мероприятий!
- Чтобы подключить группу, нужно быть авторизованным под тем же пользователем, который был привязан.
- В случае, если происходит подключение группы, которая была уже подключена где-то в Битрикс24 (не важно, облако или коробка), то на этом портале группа будет подключена, а на остальных порталах — отключена (канал будет помечен как «аварийный»). Т.е нельзя подключать одну и ту же группу в нескольких открытых линиях как на одном портале, так и на других.
- Для подключения еще одной группы нужно создать другую открытую линию и подключить группу к ней.
- При общении в данном канале нельзя редактировать свои сообщения.
- Все ответы от разных людей в рамках одного публичного разговора группируются в один чат Открытой линии и не попадают в CRM.
- Для подключения Открытых линий в коробочной версии Битрикс24 необходимо сделать предварительные настройки сервера и модулей портала.
market.add
market.add
Добавление товара
Название | Обязательный | Тип | Описание |
---|---|---|---|
gid | Нет | String | Идентификатор группы |
type | Да | ApiProductOwnerType | Тип товара:
|
attachment | Да | Attachment | Контент товара в JSON |
catalog_ids | Нет | String[] | Идентификаторы каталогов для добавления товара |
devices | Нет | String[] | Платформа постинга |
Авторизация
Сессия обязательнаНеобходимые права
- GROUP_CONTENT
- VALUABLE_ACCESS
Предусматривает строгий порядок медиаблоков в поле attachment — заголовок (текст), описание (текст, опционально), фото (опционально), специфичная для товара информация. У товара как минимум должно быть либо описание, либо фото. Например:
{"media":[
{"type":"text","text":"Название товара"},
{"type":"text","text":"Описание товара"},
{
"type": "photo",
"list": [
{"id": "photoToken1"},
{"id": "photoToken2"},
{"existing_photo_id": "1234", "group": true}
]
},
{"type":"product","price":1000,"lifetime": 30}
]}
Время публикации товара может быть указано: месяц (“lifetime”: 30), бессрочное (“lifetime”: 0). Если параметр lifetime не указан, то по-умолчанию срок публикации — месяц. На публичных страницах возможно размещение товаров как на месяц, так и и бессрочно. В группах же разрешены только товары с ограниченным сроком публикации.
По-умолчанию, валюта — российский рубль. Однако возможно указание другой валюты: USD, KZT, UAH, GEL, UZS, KGS, AZN, USD, EUR, BYN. Например, цена 10 долларов:
{"type":"product","price": 10, "currency": "USD", "lifetime": 30}
Загрузка фото происходит аналогично медиатопикам. В частности, метод commit после upload-а фото вызывать не нужно.
Тип
{ «product_id»: «String», «success»: «boolean» }
Как принимать оплаты за товары и услуги от клиентов в социальных сетях: Facebook, Instagram, VK, YouTube
Не всем интернет-предпринимателям нужен сайт. Есть товары и услуги, которые проще, быстрее и выгоднее продавать в социальных сетях, мессенджерах и на одностраничных лендингах, сделанных с помощью конструктора.
Каких только специалистов сейчас не встретишь на просторах Facebook, Instagram, VK, YouTube: психологи, консультанты по вопросам питания, спортивные тренеры, массажисты, карьерные консультанты и коучи, организаторы курсов и ивентов. Не менее комфортно себя чувствуют крафтовые мастерские, производители одежды, белья и аксессуаров.
Все они активно ищут способы монетизировать привлеченную аудиторию, возможность использовать платежные инструменты, которые дадут наилучшую конверсию в оплату
На сайтах эту задачу выполняет интеграция с платежной платформой. А для социальных сетей мы разработали удобные платежные ссылки (кнопки), которые можно создать и встроить в публикации всего за 5 минут.
Что такое платежные ссылкиПлатежная ссылка выглядит и работает как обычная ссылка, при этом направляет пользователя на специально подготовленную и настроенную вами страницу оплаты.
Buy for 50 USD
Платежная ссылка является продолжением платежной кнопки и автоматически удобно адаптируется под размер экрана устройства, что особо важно для мобильных плательщиков. Она позволяет быстро и безопасно принимать платеж, а также, при необходимости, запросить у клиента дополнительные данные: имя, фамилию, номер телефона, адрес почтового отделения для доставки.
Все просто.
- Вы вставляете платежную ссылку в пост или отправляете в сообщении.
- Клиент по ней кликает, попадает на страницу оплаты, оплачивает покупку любым удобным способом.
- Деньги попадают на ваш счет в банке или карту, а дополнительные данные передаются в мерчант-портал (ваш личный кабинет) FONDY. Вы получаете об этом уведомление на почту или в мобильное приложение мерчант-портала.
Действительно, можно. Такой метод неплохо работает в двух случаях: когда заказов немного и с покупателем установлены доверительные отношения.
При небольшом количестве заказов вы сможете отслеживать поступления на счет через свой интернет-банкинг, а с клиентами общаться в переписке. Как только заказов становится более десяти в день — начинаются сложности: уследить за всем уже не так просто, мессенджер пухнет от входящих сообщений, начинают накапливаться недовольные клиенты.
Также с карточками связан ряд неочевидных нюансов. Если плательщик использует карту другого банка, то обычный перевод будет идти уже дольше, иногда — несколько дней. При продаже товара за рубеж, плательщику придется вручную высчитывать сумму перевода по актуальному курсу.
Отдельной проблемой становятся клиенты, которым не подошел товар и они просят вернуть деньги. В таком случае продавцу придется вручную делать перевод денег обратно на карточку клиента через интернет-банк, иногда, оплачивая при этом комиссию.
Использование платежной платформы позволяет решить эти проблемы и дарит ряд преимуществ обеим сторонам:
- Безопасность для покупателя. Видя, что оплата идет через платежную систему, клиент платит более охотно, так как знает куда обратиться, если что-то пойдет не по плану.
- Безопасность для продавца. Если товар или услугу попытается оплатить мошенник чужой картой, антифрод-система заблокирует такой платеж. Также продавец не показывает номер своей карты или счета в явном виде.
- Более быстрые оплаты. Благодаря механизму токенизации, платежная платформа запоминает данные карты клиента в зашифрованном виде после первой покупки. При повторной покупке ему не нужно будет вводить номер и срок действия карточки. Достаточно подтвердить оплату вводом CVV2-кода. Все оплаты, независимо от того карточку какого банка использует плательщик, происходят практически мгновенно.
- Удобные продажи зарубежным клиентам. Для иностранных плательщиков можно создать платежную ссылку в местной валюте. А при зачислении продавец получит деньги в той валюте, в которой открыты его привязанные к FONDY банковские счета.
- Поддержка Apple Pay / Google Pay. Появляется опцией на странице оплаты и позволяет сократить время оплаты в среднем до 6 секунд, против более чем 2-ух минут для обычной оплаты картой.
- Упрощает процедуру возврата. Продавцу достаточно найти платеж в панели администратора и нажать одну кнопку, чтобы вернуть деньги покупателю, которому не подошел товар.
- Регулярные платежи. С помощью платежной ссылки можно настроить регулярные списания с клиента. Например, каждый месяц на протяжение трех месяцев, если речь идет об оплате курсов или сервисе по подписке.
Представим, что я продаю кошельки ручной работы. Вот такие.
После прохождения регистрации на платформе я создаю свою первую платежную ссылку. Перехожу в личный кабинет, в меню Платежные кнопки → Конструктор кнопок. Выбираю мерчанта, для которого будет создана кнопка, и придумываю ей название (1). Пускай будет просто Кнопка 1. Далее указываю валюту и сумму платежа (2).
Я планирую продавать кошельки украинским и зарубежным клиентам, поэтому указываю валютой доллар США. Вписываю стоимость — $50 — и обязательно ставлю пометку «Только чтение» (3) чтобы покупатель не мог изменять сумму платежа.
Выбор типа платежа позволяет сделать списание денег с карты клиента регулярным, и автоматическим. Это пригодится для сервисов по подписке, инфобизнеса, преподавателей обучающих курсов, или тех, кто регулярно доставляет одинаковые партии товара клиентам |
Потом создаю дополнительные поля (4). У меня планируется около 10 продаж в день, поэтому у меня есть время, чтобы позвонить клиентам и уточнить их пожелания по продукту и записать адрес доставки. Значит мне нужно всего 3 дополнительных поля:
- Описание товара (ему добавляю атрибут «только чтение»)
- Имя
- Номер телефона
Когда поля готовы, мне остается только сохранить платежную кнопку (5) и получить на неё активную ссылку и скопировать её.
Что дальше?
Как пользоваться платежной ссылкой: примеры для разных соцсетей FacebookА дальше я просто создаю пост на своей бизнес-странице, и вставляю в него (или в комментарии под ним) платежную ссылку. Запускаю платную рекламу поста и жду первых клиентов.
Клиенты почитают подробное описание товара и захотят его купить.
Когда они кликнут по ссылке и совершат оплату, я получу уведомление, увижу их номер телефона в системе и перезвоню для уточнения деталей по заказу.
Так как сейчас я продаю всего 10 кошельков в день, мне так работать комфортно. Но когда объемы вырастут до 30+ штук в день, я уже не буду успевать всем звонить. Тогда я отредактирую платежную ссылку так, чтобы она запрашивала у клиента адрес и отделение почты, чтобы я сразу отправлял посылки и не тратил время на звонки и уточнения.
FB Messenger / Telegram / Instagram DirectАналогичным образом ссылку на оплату можно отправить при личном общении с клиентом.
Instagram / YoutubeВ инстаграме владельцы бизнес-аккаунтов могут прикреплять ссылки к постам и сторис.
Ютуберы, в свою очередь, могут вставлять ссылки в описании под видеороликами. При этом не обязательно вставлять ссылку в оригинальном виде — при желании или необходимости отслеживать статистику переходов ее можно сократить с помощью bit.ly или похожего сервиса.
Необычные кейсы: платежные ссылки в реальном барбершопе и офисном холодильникеПлатежную ссылку можно не только сокращать, но и превращать в QR-код, который легко может считать любой смартфон с камерой. Это позволяет использовать потенциал удобных оплат в реальном мире.
Например, владелец барбершопа, который не хочет приобретать POS-терминал, может создать QR-код из платежной ссылки с изменяемой суммой и приклеить этот код на стойку администратора. Когда настанет время оплаты, клиент просто отсканирует код с помощью камеры смартфона в качестве платежного метода выберет Apple Pay или Google Pay, чтобы не вспоминать номер карточки и долго не переписывать данные.
По похожей схеме у нас в офисе FONDY работает специальный холодильник с обедами для сотрудников, которые каждое утро привозит компания-поставщик. Рядом с холодильником висит прайс на разные блюда и QR-код для оплаты. Сотрудник выбирает себе еду и с помощью телефона в течение нескольких секунд оплачивает обед. Такая схема построена на доверии, но работает безотказно.
Платежная ссылка на лендингах и простых сайтахТакже платежные ссылки могут выручить вас, если вы все же создали простенький сайт на конструкторе вроде Tilda или Wix, у которых нет встроенных платежных решений.
Достаточно скопировать код ссылки и вставить её в картинку или кнопку на сайте.
Лайфхаки по работе с платежной ссылкой1) При редактировании суммы или данных, которые будут запрашиваться на форме оплаты платежная ссылка будет изменена. Не забывайте обновлять её на всех площадках, где размещали её ранее.
2) Платежная форма всегда запрашивает email плательщика, чтобы автоматически прислать ему чек об оплате и сохранить контакты для продавца. Если вы уверены, что запрашивать email покупателя не обязательно, вы можете написать в техподдержку Fondy и мы отключим это поле.
3) Лично убедитесь, насколько легче клиентам платить с помощью платежных ссылок и забудьте про «скиньте деньги мне на карточку» навсегда.
Попробуйте прямо сейчас — зайдите в кабинет со своим имейлом и сгенерируйте кнопку. Для этого даже не нужно проходить никаких процедур проверки и активации вашего аккаунта. Переходите по ссылке: https://portal.fondy.eu/mportal/#/account/registration
как настроить, подводные камни и фишки
Форма сбора заявок ВКонтакте (она же лид-форма) — приложение для сообществ, которое позволяет собирать заявки клиентов прямо в социальной сети. Это сокращает путь до пользователя: если он решил воспользоваться вашим предложением, он сразу отдаст вам свои данные, и точно не потеряется по пути из соцсети на ваш сайт.
Форму можно настраивать под разные цели: сбор коммерческих заявок, подписку на рассылку, регистрацию на вебинар и т.д.
Как создать лид-форму: руководство по каждому полю
Форму можно создать двумя путями:
- в настройках сообщества (через Управление — Приложения),
- в рекламном кабинете (после выбора цели «Сбор заявок»).
В целом механика не отличается друг от друга, поэтому мы рассмотрим только первый вариант.
Добавьте приложение
Перейдите на страницу приложения и нажмите «Добавить в сообщество». Выберите нужную страницу. Если приложение уже добавлено, выбор будет недоступен, а всплывающая подсказка под знаком вопроса сообщит, что все готово.Перейдите в раздел Управление — Приложения
Откройте страницу сообщества, в правом меню выберите блок «Управление». В правом меню открывшейся страницы нажмите «Приложения» и найдите форму сбора заявок. Перейдите в настройки приложения.
Редактор новой формы находится в правом верхнем углу, кнопка «Добавить форму».
Разберем форму по блокам.
Заголовок и описание
Этот блок отвечает за то, согласится ли пользователь оставить вам свои контакты. В нем вы дополнительно объясняете, что вы предлагаете и зачем пользователю это нужно.
Первый редактируемый блок — название формы. Он будет виден только вам, в рекламном кабинете или настройках приложения. По умолчанию в него проставляется дата создания. Чтобы изменить название, нажмите на него.
Затем заполните поля самой формы. У каждого из них есть ограничение по символам — счетчик вы увидите рядом с полем ввода, цифра будет меняться в процессе набора текста.
Заголовок: еще раз скажите пользователю, для чего он заполняет эту форму. «Регистрация на вебинар», «Запись на прием» и т.д.
Описание: расскажите, что получит пользователь. Если это вебинар — о чем он будет, если услуга — что в нее входит, если товар — как он выглядит, когда вы его доставите и т.д.
В отличие от лид-формы Facebook, здесь нет встроенного редактора, форматирование текста нужно прописывать вручную с помощью wiki-разметки. Это несложно, если знать нужные тэги.Основные:
- жирный — <b>текст</b>,
- курсив — <i>текст</i>,
- зачеркнуть — <s>текст</s>,
- подчеркнуть — <u>текст</u>,
- маркированный список — *текст (так нужно оформлять каждый пункт списка). Если у списка несколько уровней, то чем ниже уровень, тем больше звездочек нужно ставить: ** (второй), *** (третий).
- нумерованный список — #текст (оформляется по аналогии с маркированным).
Вопросы
Укажите, какие данные собирать с пользователя. По умолчанию форма запрашивает только имя, а с этой информацией трудно что-то сделать.
Среди стандартных полей с автозаполнением есть только два — телефон и email. Для них предусмотрена кнопка «Изменить» — если пользователь нажмет ее, он сможет ввести другие данные.
В некоторых формах специалисты отказываются от автозаполнения в принципе (через функцию «Добавить свой вопрос»). Это важно, если вы хотите собирать максимально валидные лиды. Например, при сборе регистраций на вебинар об этом можно не беспокоиться, а вот если вы собираете заявки на автобусный тур с ограниченным количеством мест — «случайные» заявки могут быть критичными.Не злоупотребляйте вопросами. Запрашивайте только ту информацию, которая действительно необходима вам для обработки заявки. Не пытайтесь выяснить о пользователе все данные, ведь чем больше вопросов, тем меньше вероятность, что человек заполнит форму до конца. Помните, вам не нужен его размер обуви, если это не форма заказа сапог.
Политика конфиденциальности
Любая компания, которая собирает, обрабатывает и хранит персональные данные, должна иметь политику конфиденциальности. Укажите ссылку на документ, пользователь сможет перейти на него по гиперссылке в подвале формы.
Дальше идут необязательные для настройки блоки, которые мы все-таки советуем заполнить.
Подтверждение
Это второй экран формы — благодарность за отправку. По умолчанию в ней установлен такой текст:
Формально задача выполнена — отправку данных подтвердили. Но здесь мы можем продолжить коммуникацию с пользователем — привлечь его на свой сайт или в сообщество.
В блоке описание действует та же вики-разметка, что и в первом блоке.
Вариантов конечной кнопки два: перейти на сайт и перейти в сообщество. Она меняется автоматически, в зависимости от того, указали вы ссылку на сторонний сайт или на свою страницу в ВК.Настройки
Что здесь есть:
- Запретить повторное заполнение формы — мы советуем включать ее во всех случаях, если в форме не подразумевается несколько заполнений.
- Уведомлять о новых заявках в личные сообщения — тут можно выбрать одного или нескольких администраторов страницы, которые будут получать уведомления.
- Уведомлять о новых заявках через email — введите электронный адрес (или несколько адресов), на который нужно отправлять уведомления.
И вот он, подводный камень. Последний пункт формы, который легко может сломать все — пиксель ВКонтакте.
Он нужен, чтобы автоматически собирать всех, кто открыл форму, в аудиторию для ретаргетинга (в рекламном кабинете). Подробнее о том, как установить пиксель на свой сайт и добавить в форму, читайте в инструкции. Сам ввод кода пикселя ничего не сломает. Но если вы решите перейти по ссылке из всплывающей подсказки (знак вопроса), новая страница откроется в этом же окне, обнулив все изменения. Форму вы восстановить не сможете, придется создавать ее заново. Кстати, с нашей формой из примера именно это и произошло 🙃Когда вы заполните все нужные вам поля, сохраните форму в правом верхнем углу редактора. Но перед запуском рекламы учтите кое-что важное.
Как форма сбора заявок работает на мобильных устройствах
Форма сбора заявок без проблем работает в мобильном приложении социальной сети. Открывая форму через рекламное объявление, личные сообщения или страницу внутри приложения ВКонтакте, вы автоматически попадаете на форму.
А вот с браузерами на мобильных устройствах случаются проблемы. Форма не откроется, если браузер в смартфоне не обновлен до последней версии или просто не поддерживает работу формы. И предугадать, сколько будет таких «счастливчиков» среди вашей аудитории — невозможно.
Также ссылка превращается в тыкву, стоит вывести ее из ВКонтакте в другие приложения. Например, если вы опубликуете ссылку на лид-форму ВК в профиле Instagram, соцсеть попытается открыть ее в своем внутреннем браузере, и вместо формы пользователь тоже увидит ошибку. Выход — сделать другую форму заявки через Google Формы, либо через Taplink или страницы на Tilda. Со внутренними сервисами ВКонтакте форма тоже не всегда дружит. К примеру, она не откроется на мобильном устройстве, если вы добавите форму в рассылку Senler. Решение здесь аналогично ситуации с Instagram — сделайте отдельную форму.Общий вывод прост. Убедитесь, чтобы со смартфонов форму открывали только напрямую через мобильное приложение ВКонтакте. Выводя ссылку за его пределы, вы рискуете потерять заявки.
Запускаем форму на рекламу: цель, пост и кнопка
Перейдите в рекламный кабинет ВКонтакте. При создании нового объявления выберите цель «Сбор заявок».
Затем выберите форму, которую вы создали, и нажмите «Создать объявление». Оно выглядит как обычная запись ВКонтакте. Напишите подводку к форме, добавьте изображение (ВК просит картинку размером 537х240 рх, но мы делаем в четыре раза больше — 2148х960 px, чтобы качество изображения не терялось).Заполните сниппет и выберите кнопку, которая вам больше всего подходит — ВКонтакте предоставляет около 10 разных вариантов.
Теперь настройте аудиторию и сохраните объявление. Смените его статус на «Запущено». Объявление запустится автоматически после одобрения модератора.
2 способа выгрузить собранные лиды
Вы можете выгрузить лиды прямо из ВКонтакте, они хранятся в том же разделе, где вы создавали форму (Управление — Приложения — Перейти к настройкам в приложении).
Вы получите файл в формате .xls — его можно загрузить в любую нужную вам систему. Помимо полей, которые вы запросили, в файле также будут ID заявки и ID пользователя.
Что с этим способом не так? Заявки очень быстро «протухают» (если это не регистрации на вебинар, конечно). Это значит, что чем раньше вы или ваш отдел продаж заявку обработает, тем выше вероятность, что клиент действительно что-то купит. Поэтому выгружать файл даже раз в день может быть слишком долго, а вручную передавать данные из уведомлений (мы их настраивали на последнем шаге формы) — муторно и долго. Мы ведь ждем много заявок, правда?
Поэтому есть второй вариант — настроить синхронизацию формы с вашей CRM, данные будут автоматически передаваться в нее. Для этого нужно настроить синхронизацию через API.Перейдите в раздел Управление на странице своего сообщества, а затем в раздел Работа с API — Callback API. Попросите своих разработчиков настроить синхронизацию с помощью документации ВКонтакте. На последнем этапе во вкладке «Типы событий» нужно поставить галочку в чек-боксе «Lead forms: Новая заявка».
Но не все обращения одинаково полезны, а в CRM обычно хранят уже проверенные лиды. Чтобы не засорять лист контактов, можно настроить передачу заявок в другую систему учета обращений (в современных онлайн-чатах и коллтрекингах обычно есть этот функционал), и только потом передавать действительно целевые лиды в CRM.
Например, так это выглядит в Callibri:В столбце «Класс» менеджеры указывают качество обращения. Заявки с классом Лид автоматически передаются в CRM.
Также из формы подгружается имя и известные контактные данные пользователя, название формы, текст заявки и запись обратного звонка (если настроено). Записи можно прослушать в течение 40 дней.
Как превратить форму сбора заявок в обратный звонок
Это можно сделать только при помощи синхронизации ВКонтакте и обратного звонка стороннего сервиса, причем того, который поддерживает эту возможность. МультиЧат Callibri — да.Подпишись на нас в соцсетях:
Как это сделать:
- Настроить синхронизацию ВК и Callibri через Callback API.
- В разделе «Типы событий» поставить галочку на «Lead forms: Новая заявка».
- Создать форму сбора заявок и в разделе вопросы обязательно добавить поле «Номер телефона». Заполнить остальные разделы формы.
- Перейти в рекламный кабинет, создать рекламное объявление с целью «Сбор заявок», запустить объявление.
Советы, которые нужно запомнить
- Не ленитесь заполнять все разделы, даже те, которые помечены как необязательные. Экран благодарности — это важно.
- Если изменения еще не сохранены, переходите по ссылкам в подсказках только с помощью функции «открыть в новом окне» (вызывается кликом правой кнопки мыши). Иначе все, что вы создавали несколько минут или часов, может безвозвратно испариться.
- Чтобы качество изображения в рекламном объявлении не снижалось, загружайте картинки размером в четыре раза больше требуемого — 2148х960 px.
- С помощью синхронизации ВКонтакте со сторонними сервисами (CRM, онлайн-чат, коллтрекинг) вы сможете максимально быстро обработать поступившие заявки — менеджеры увидят их в режиме реального времени, а не когда маркетолог решит выгрузить файл.
- Callibri может превратить форму сбора заявок ВКонтакте в обратный звонок.
Тестируйте!
VK Market add-on для CS-Cart
Обзор
97 млн пользователей проживают на vk.com, крупнейшей социальной сети в России. Их аудитория в основном состоит из людей в возрасте от 24 до 35 лет, включая женщин и мужчин в равных пропорциях. Старшая аудитория использует его для исследования рынка, делового чтения и обмена статьями, а молодежь — в развлекательных целях. Платформа предлагает игры, возможности публикации изображений, видео и текста, лайки и комментарии, инструменты продажи и оплаты.Он может быть прекрасным дополнительным источником для интернет-магазинов для перекрестных и дополнительных продаж товаров. Собственная валюта VK и метод VK Pay — вишенка на пироге.
Недавно появилась возможность создать рынок. Теперь пользователь ВКонтакте может создать группу и продавать товары по следующим категориям:
- Одежда
- Детские товары
- Бытовая электроника
- Компьютеры и программное обеспечение
- Транспортные средства
- Недвижимость
- Бытовая и садовая техника
- Косметика и уход за телом
- Спорт и отдых на природе
- Канцелярские товары и товары для хобби
- Домашние животные
- Еда
- Услуги
Кроме того, в VK возможны рекламные и маркетинговые инструменты.Вы можете создавать опросы, чтобы привлекать потенциальных клиентов, размещать рекламу на своей странице или продвигать рекламную кампанию. Вся функциональность уже есть. Для новичков платформа предлагает образовательный источник vk.biz, который знакомит с маркетинговыми инструментами, делится знаниями и опытом профессиональных пользователей.
Итак, как настроить воронку покупок в ВК? Вы можете создать портфолио, показывающее ваш продукт для продажи, но более разумным решением будет подключение расширения Simtech Development VK Integration.
Надстройка VK Market позволит вам загрузить фид товаров, чтобы начать использовать все возможности социальной сети VK.Никогда раньше не было так легко заинтересовать российскую публику. Авторизуйтесь на vk.com, создайте группу, включите вкладку Товары в Настройках. Теперь вы можете загружать свой фид с помощью надстройки и зарабатывать. С дополнением VK Market у вас теперь есть доступ к 97-миллионной российской клиентской базе!
Какие преимущества:
- Ваши товары появятся в отдельном блоке на странице Группы сразу после описания вашего профиля. Привлекающее внимание место!
- Кнопка для подключения к продавцу поможет вам решить проблемы с инвентаризацией, доставкой и оплатой вашего продавца.Легко и удобно!
Дополнение поможет вам:
- Загрузите товар автоматически и освободите вас от необходимости заполнять описания товаров;
- Объедините инструменты социальных и розничных платформ и получите более глубокое взаимодействие с клиентами;
- Предложите поклонникам ВКонтакте приятный пользовательский интерфейс с возможностью беспрепятственной покупки.
Вы все еще не решаетесь использовать этот плагин? Не тратьте время на воссоздание колеса! Используйте возможности платформы CS-Cart Shopping Cart и преимущества социальной сети ВКонтакте, чтобы расширить свой бизнес до самой большой аудитории русскоязычных клиентов.
Создание группы ВКонтакте
Создать группу
Определите имя и категорию группы
Перейдите в Настройки группы, чтобы включить и настроить продукты
Создайте приложение по этой ссылке https://vk.com/editapp?act=create
Возьмите ключ API
Установка и настройка дополнения
Установить надстройку
Введите номер лицензии и ключ API в соответствующие поля.Сохраните и получите токен доступа
После получения ключа доступа перейдите на вкладку Экспорт настроек и выберите группу
Настройка категорий и продуктов
Выберите «ВКонтакте» для каждой категории
Добавить описание для каждого продукта
Экспорт товаров в ВК
Запустить экспорт по ссылке. Только товары с категорией «ВКонтакте» и описанием будут экспортированы
https: // example.com / index.php? dispatch = vk_market.s …
Теперь посетите свою группу ВКонтакте, чтобы просмотреть товары с описаниями и отсортированные по категориям.
Руководство пользователя
Узнайте больше о надстройке в нашем Руководстве пользователя.
Поддержка
Это дополнение разработано и опубликовано Simtech Development Ltd. Вам гарантируется качественное дополнение, поддерживаемое в будущих версиях. Если вам нужна помощь, свяжитесь с нами через нашу систему службы поддержки.
Автоматическая публикация на пабликах Вконтакте с использованием VK API и Python
Vk.com (Вконтакте) — самая популярная социальная сеть в России и странах бывшего СССР с более чем 430 миллионами пользователей. Изначально это был клон Facebook. Но теперь, после 10 лет разработки, эти два сервиса сильно отличаются друг от друга.
Традиционные преимущества vk.com — огромное количество бесплатной музыки и видео. Сервис позволяет пользователям загружать и обмениваться файлами и долгое время был довольно терпимым к пиратству. В 2016 году Mail.Ru Group, материнская компания Вконтакте, решила все проблемы с крупными музыкальными лейблами и теперь тесно сотрудничает с правообладателями.
В отличие от Facebook, ВКонтакте имеет очень эффективные возможности для создания сообществ: публичные страницы (блоги) и группы (открытые и закрытые веб-форумы). В сообществах ВКонтакте вы можете легко делиться новостями, фото, аудио, видео, текстовыми файлами в разных форматах, создавать темы обсуждений и вики-страницы. Когда я учился в университете в 2003-2009 годах, для обмена информацией в учебной группе нам потребовалось создать собственный веб-сайт и форум на базе phpBB. Сейчас практически все студенты просто используют для этого группы ВКонтакте.В отличие от Facebook, ВКонтакте показывает весь контент в группах как есть, без скрытия и фильтрации.
С возможностями автоматизации охвата можно делать разные интересные вещи на базе ВКонтакте. Для начала решил разместить все аннотации из своего https://avleonov.com блога на https://vk.com/avleonovcom странице Вконтакте. Я создал эту страницу в веб-интерфейсе и автоматически заполнил ее контентом, используя свои собственные скрипты Python.
Создание нового приложения
Я хочу работать с Вконтакте из моих скриптов Python.Итак, для этого мне нужно будет создать новое автономное приложение. Сделать это можно здесь: https://vk.com/editapp?act=create
.Upd. Март 2018 Интеграция с Вконтакте внезапно оборвалась, потому что во все звонки добавили обязательный параметр версии.
Получение sms кода для подтверждения. И вот у меня новое приложение:
Я изменил статус на «Заявка включена и видна всем».
Получение информации о странице
А теперь попробуем что-нибудь сделать.Все доступные методы перечислены на https://vk.com/dev/methods
.Для большинства методов требуется аутентификация по токену. Например, используя токен сообщества , вы можете выполнять некоторые операции на своей странице. Давай получим. Захожу на страницу https://vk.com/avleonovcom?act=tokens
Создать токен
Выберите необходимые права для нового токена доступа:
- Разрешить приложению управлять сообществом
- Разрешить доступ к сообщениям сообщества
- Разрешить доступ к фотографиям сообщества
- Разрешить доступ к документам сообщества
Получение sms кода для подтверждения.И теперь у меня есть токен:
А теперь давайте информацию о группе:
#! / Usr / bin / python Импортировать community_token = "3bXXXXXXXXXXXXXXXXa3" params = ( ('group_id', 'avleonovcom'), ('access_token', community_token), ) response = requests.get ('https://api.vk.com/method/groups.getById', params = params) печать (response.text)
Ответ в Json:
{«response»: [{«gid»: 149273431, «name»: «Александр Леонов», «screen_name»: «avleonovcom», «is_closed»: 0, «type»: »page», «is_admin»: 1 , «Admin_level»: 3, «is_member»: 1, «photo»: »https: \ / \ / pp.userapi.com \ / c638021 \ / v638021099 \ / 5ebf2 \ /CMFlIiN7BRQ.jpg «,» photo_medium «:» https: \ / \ / pp.userapi.com \ / c638021 \ / v638021099 \ / 5ebf1 \ /ObJxr2spgT » , ”Photo_big”: ”https: \ / \ / pp.userapi.com \ / c638021 \ / v638021099 \ / 5ebf0 \ /KQfDrQHHc4o.jpg”}]}
Создание сообщения
Хорошо, теперь давайте посмотрим, как опубликовать что-нибудь на стене сообщества https://vk.com/dev/wall.post
Для этого мне нужно токен пользователя . Я попробую «Неявный поток» для токена доступа пользователя.
Я просто открываю этот URL в браузере:
https: // oauth.vk.com/authorize?client_id= 6096665 & display = page & redirect_uri = https: //oauth.vk.com/blank.html&scope= офлайн, фотографии, стена, группы & response_type = token & v = 5.65
И когда я нажму «Разрешить», я буду перенаправлен на:
https://oauth.vk.com/blank.html#access_token= bd9487fcd4bd6de7e43aqjfo2n3tjdfi3323b6327b1128987c834ab0b13d8a2fbe1fedc0119bcb496d8a2fbe1fedc0119bcb476d2 =
2d2fbe1fedc0119bcb472d2А теперь можете использовать этот токен.
Примечание! «-» в owner_id. Это важно!
user_token = "bdXXXXXXXXXXXXXXXXX49" params = ( ('owner_id', '-149273431'), ('from_group', '1'), ('сообщение', 'Привет, мир!'), ('токен_доступа', токен_пользователя), ) response = requests.get ('https://api.vk.com/method/wall.post', params = params) печать (ответ.текст)
{«ответ»: {«post_id»: 3}}
Первое автоматически отправленное сообщение! Большой!
Хорошо, теперь давайте попробуем опубликовать URL с текстом и фотографией
params = ( ('owner_id', '-149273431'), ('from_group', '1'), ('сообщение', 'Привет, мир2!'), ('сообщение', 'фото1468099_456239095, https: // avleonov.com '), ('токен_доступа', токен_пользователя), ) response = requests.get ('https://api.vk.com/method/wall.post', params = params) печать (response.text)
{«ответ»: {«post_id»: 6}}
Здесь есть все необходимые элементы: многострочные, хэштеги, ссылки и картинки. Жалко, что я не могу указать изображение для любого URL-адреса, как я могу сделать это в графическом интерфейсе. 🙁
Как видите, я использовал картинку ID photo1468099_456239095 со своей личной страницы.Итак, давайте также посмотрим, как добавлять изображения на страницу сообщества.
Создание нового фотоальбома
В первую очередь мне нужен фотоальбом на моей страничке. Я могу создать его вручную или воспользоваться этим методом https://vk.com/dev/photos.createAlbum
params = ( ('group_id', '149273431'), ('название', 'иллюстрации блога'), ('описание', 'изображения с avleonov.com'), ('upload_by_admins_only', '0'), ('комментарии_отключены', '0'), ('токен_доступа', токен_пользователя), ) ответ = запросы.получить ('https://api.vk.com/method/photos.createAlbum', params = params) печать (ответ.текст)
{«response»: {«aid»: 245830662 , «thumb_id»: 0, «owner_id»: — 149273431, «title»: «иллюстрации блога», «description»: «изображения с avleonov.com», » created »: 149
69,« updated »: 149
69,« privacy »: null,« comment_privacy »: null,« size »: 0,« can_upload »: 1}}
Хорошо, вот мой новый альбом:
https://vk.com/album-149273431_245830662
А теперь давайте добавим изображения в этот альбом.
Загрузка изображений
Прежде всего, мне нужно спросить Vk, какой сервер я могу использовать для загрузки изображений в конкретном сообществе и альбоме: https://vk.com/dev/photos.getUploadServer
params = ( ('group_id', '149273431'), ('идентификатор_альбома', '245830662'), ('токен_доступа', токен_пользователя), ) response = requests.get ('https://api.vk.com/method/photos.getUploadServer', params = params) печать (ответ.текст)
{«response»: {«upload_url»: » https: \ / \ / pu.vk.com \ / c638625 \ /upload.php? act = do_add & mid = 1468099 & aid = 245830662 & gid = 149273431 & hash = 376ebed109e24233586f11bb245567af & rhash = d97ac3f9662006c9cdeaf1bcf1&hl=ru & reg; Получение URL из этого json: https://pu.vk.com/c638625/upload.php?act=do_add&mid=1468099&aid=245830662&gid=149273431&hash=376ebed109e24233586f11bb245567af&rhash=dee97ac3f966fi6loadc9 Теперь я могу загрузить файл изображения Петя.png на сервер, используя этот URL-адрес {«server»: 638625 , «photos_list»: « [{\» фото \ «: \» ae058e4488: z \ «, \» sizes \ «: [[\» s \ », \” 638625099 \ ”, \” 46dfc \ ”, \” kq-CLsvmn1c \ ”, 75,47], [\” m \ ”, \” 638625099 \ ”, \” 46dfd \ ”, \” ARweXs4fNY4 \ ”, 130,81] , [\ «X \», \ «638625099 \», \ «46dfe \», \ «azuLkrnJlEM \», 604 377], [\ «y \», \ «638625099 \», \ «46dff \», \ » Hhh9ZDOIG7A \ ”, 807,504], [\” z \ ”, \” 638625099 \ ”, \” 46e00 \ ”, \” — oRXtMm8KoI \ ”, 820,512], [\” o \ ”, \” 638625099 \ ”, \ «46e01 \», \ «BIuUvHI-jO4 \», 130,87], [\ «p \», \ «638625099 \», \ «46e02 \», \ «rvBynPb3ySs \», 200,133], [\ ”q \ «, \» 638625099 \ «, \» 46e03 \ «, \» 7co0uaiSnW4 \ «, 320,213], [\» r \ «, \» 638625099 \ «, \» 46e04 \ «, \» J3K4uca6G1E \ «, 510,340 ]], \ «Kid \»: \ «646c7ed0cdac2164775b2ad14cd2b45b \», \ «debug \»: \ «xszmzxzyzzzozpzqzrz \»}] «,» help «: 245830662,» hash «:» efa14d3d4e4e09 : 149273431} Получение необходимых параметров: И, наконец, сохраните загруженный файл в фотоальбом: https://vk.com/dev/photos.save {«ответ»: [{«pid»: 456239022, «id»: « photo1468099_456239022 «, «помощь»: 245830662, «owner_id»: — 149273431, «user_id»: 1468099, «src»: «https: \ / \ / pp.userapi.com \ / c638625 \ / v638625099 \ / 46efe \ /climLuu7McI.jpg «,» src_big «:» https: \ / \ / pp.userapi.com \ / c638625 \ / v638625099 \ / 46eff \ /9rAsDsEmiUg.jpg «,» src_small «:» https: \ / \ / pp.userapi.com \ / c638625 \ / v638625099 \ / 46efd \ /mmeTVQjTAcE.jpg «,» src_xbig «:» https: \ / \ / стр.userapi.com \ / c638625 \ / v638625099 \ / 46f00 \ /vm8tYL62cTA.jpg ”,” src_xxbig ”:” https: \ / \ / pp.userapi.com \ / c638625 \ / v638625099 \ / 46f01 \ /RybUx0jpg ”lBX , «Ширина»: 820, «высота»: 512, «текст»: «тестовое изображение», «создано»: 149 импорт json
upload_server = json.loads (response.text) ['ответ'] ['upload_url']
печать (upload_server)
файлов = {'file1': open ('petya.png', 'rb')}
response = requests.post (upload_server, files = файлы)
печать (ответ.текст)
img_hash = json.загружает (response.text) ['hash']
photos_list = json.loads (response.text) ['photos_list']
server = json.loads (response.text) ['сервер']
params = (
('group_id', '149273431'),
('идентификатор_альбома', '245830662'),
('хеш', img_hash),
('photos_list', photos_list),
('сервер', сервер),
('подпись', 'тестовое изображение'),
('токен_доступа', токен_пользователя),
)
ответ = запросы.получить ('https://api.vk.com/method/photos.save', params = params)
печать (ответ.текст)
Примечание! Сервер возвращает идентификационную фотографию 1468099 _456239022. Это мой идентификатор пользователя. И идентификатор страницы — 149273431. Я не знаю, почему возвращается этот идентификатор. Итак, я редактирую id этой заменой:
photo_id = re.sub ("фото1468099", "фото-149273431", photo_id)
И работает!
Итак, теперь мы можем добавлять картинки в фотоальбом сообщества.Мы можем сделать пост из идентификатора изображения, текстового описания и веб-ссылки. Этого достаточно для успешной интеграции вашего сайта со страницей Вконтакте. 😉
Примечание! Есть лимит, на стене можно создавать не более 50 постов в день!
Привет! Меня зовут Александр, я специалист по автоматизации информационной безопасности. Вы можете узнать обо мне больше здесь. В настоящее время лучший способ подписаться на меня — мой канал в Telegram @avleonovcom. Я его обновляю чаще, чем этот сайт.Если вы еще не использовали Telegram, попробуйте. Это здорово. Вы можете обсудить мои сообщения или задать вопросы на @avleonovchat.
Установите пользовательское содержимое вкладки HTML для автора на странице своего профиляvk-sdk — Typescript SDK для VK Api
Сторонний плагин аутентификации для hapi.bell поставляется со встроенной поддержкой аутентификации с использованием Facebook, GitHub, Google, Google Plus, Instagram, LinkedIn, Slack, Stripe, Twitter, Yahoo, Foursquare, VK, ArcGIS Online, Windows Live , Nest, Phabricator, BitBucket, Dropbox, Reddit, Tumblr, Twitch, Mixer, Salesforce, Pinterest, Discord, DigitalOcean, AzureAD, trakt.тв и Окта. Он также поддерживает любые совместимые службы входа на основе OAuth 1.0a и OAuth 2.0 с помощью простого объекта конфигурации.
хапи авторизоваться аутентификация oauth плагин auth0 дуга битбакет Dropbox facebook фитбит Foursquare github gitlab Google instagram средний linkedin жить встреча гнездо фабрикатор office365 окта Reddit Spotify тамблер твиттер vk WordPress YahooДоступ к крупнейшей социальной платформе в Европе Vkontakte
12 месяцев в Linkfluence были напряженными.Наши недавние усилия по сбору данных позволили нам еще больше защитить API Instagram, чтобы обеспечить еще больший охват платформы, а также улучшили и расширили возможности Twitter.
Следуя нашему постоянному стремлению обеспечить максимально возможное покрытие всех основных публичных социальных сетей по всему миру, мы рады объявить о расширении охвата Восточной Европы с помощью ВКонтакте.
На данный момент вы можете получить доступ к полному исчерпывающему охвату социальных данных ВКонтакте.
Исчерпывающий социальный охват ВКонтакте
Выслушав ваши отзывы, мы усердно работали над улучшением нашей текущей интеграции с ВКонтакте. Раньше вы могли получить доступ к образцу контента Вконтакте через общедоступный API.
Сегодня мы рады объявить о новых договорных правах, которые позволяют Linkfluence получить доступ ко всем общедоступным данным, доступным на платформе. Бренды могут получить более широкий спектр возможностей для прослушивания, включая контент в реальном времени и общение на платформе.У вас также будет доступ к историческим данным за 12 месяцев в этом прибыльном регионе.
Но прежде чем мы перейдем к вопросу о том, как эта интеграция может повлиять на ваш бренд, давайте подведем итоги.
Пожалуй, одна из менее известных платформ в мире, ВКонтакте — это социальная сеть и отраслевой гигант, более известный как российский Facebook.
Вконтакте или Вконтакте буквально переводится как «быть на связи» и используется 83 процентами из 70 миллионов активных пользователей социальных сетей в стране.Она занимает второе место после YouTube как наиболее используемая социальная платформа в России и является крупнейшей социальной сетью в Европе с более чем 100 миллионами активных пользователей.
Источник: ВКонтакте
Своим успехом он может приписать миллениалам в возрасте до 34 лет, которые составляют колоссальные 77,5 процента от общего числа пользователей. Но также стабильный рост международных пользователей, которые с августа 2018 года вносят вклад в 500 миллионов ВКонтакте по всему миру. На данный момент ВКонтакте занимает 13-е место по посещаемости среди веб-сайтов в мире.Но что делает Вконтакте таким популярным и как он конкурирует с такими гигантами индустрии, как Facebook?
ВКонтакте против Facebook
Визуально ВКонтакте приобрела схожий формат и внешний вид с Facebook, но есть множество отличий в спецификациях и предлагаемых функциях.
Что касается базовой информации профиля, это на самом деле не так уж и просто. Платформа использует широкий спектр фильтров, чтобы помочь пользователям точно определить, кого и что они ищут.
Пользователям предлагается заполнить поля, включая религию, политические взгляды и военную службу, вплоть до их взглядов на курение и алкоголь.Пользователи также могут отображать свои приоритеты, такие как: красота и искусство, наука и исследования и улучшение мира.
Источник: Vkontakte
Поскольку это российская компания, ориентированная на большую часть российской аудитории, VK придерживается российских законов об авторском праве. Это позволяет сайту предоставлять уникальный набор мультимедиа, включая бесплатную музыку, телесериалы и потоковое воспроизведение фильмов.
Проще говоря, информация, доступная в ВК, в сочетании с прослушиванием социальных сетей может предоставить обширную и незаменимую информацию для глобальных компаний.
Многие мировые бренды уже используют преимущества ВКонтакте, включая Coca Cola, Nike, Zara и L’Oreal. Любой бренд, желающий выйти на рынок Восточной Европы, должен использовать платформу, чтобы понимать не только российских потребителей, но и соседние страны, включая Украину, Беларусь, Казахстан и Молдову.
Источник: Возрастное распределение пользователей социальной сети Vk.com в России в 2018 году *, Statista.
Вконтакте — социальная платформа номер один в России.В сочетании с тем фактом, что более 70 процентов пользователей попадают в категории миллениалов и поколения Z, это отличный способ понять предпочтения потребителей сегодня.
Сеть создает беспрецедентный объем подробной пользовательской информации по сравнению с подобными Facebook. Это также позволяет брендам увеличивать масштабирование целевых сообществ. Вы можете использовать эти сообщества с помощью рекламы, определяя наиболее подходящие племена для ваших продуктов, кампаний и контент-маркетинга.
Страна является домом для самой большой онлайн-аудитории в Европе, что создает огромные возможности для электронной коммерции. Morgan Stanley предположил, что на российском рынке ожидаются «радикальные изменения» с точки зрения зрелости интернет-пользователей, что приведет к увеличению количества онлайн-транзакций. Ожидается, что к 2020 году материальные товары вырастут до 31 миллиарда долларов, а к 2023 году достигнут 52 миллиардов долларов.
У мировых брендов есть огромный потенциал в изучении одного из крупнейших развивающихся рынков мира.И нет лучшего времени, чтобы понять эту уникальную группу потребительского поведения, учитывая текущую атмосферу для потенциального роста и международной экспансии.
Премиум пакеты социальных данных
Мы недавно рассмотрели наше предложение социальных данных и рады объявить о двух дополнительных региональных пакетах данных, которые можно добавить к вашему стандартному всемирному охвату (см. Карту выше).
Для расширенного регионального покрытия теперь вы можете выбрать одно из следующего:
- Пакет социальной сети APAC
- Пакет социальной сети России
Просто свяжитесь со своим менеджером по работе с клиентами или торговым представителем, чтобы узнать больше!
узел-vk-sdk — npm
VK API SDK для Node.js
Установка
Для установки стабильной версии:
npm install --save node-vk-sdk
Предполагается, что вы используете npm в качестве диспетчера пакетов. Если вы этого не сделаете, вы можете получить доступ к этим файлам в unpkg, загрузить их или указать на них в диспетчере пакетов.
Импорт
Вы можете импортировать SDK с помощью модулей ES6:
импортировать {VKApi, ConsoleLogger} из 'node-vk-sdk'
Или используя , требуется
:
const {VKApi, ConsoleLogger} = require ('node-vk-sdk')
Использование
импортировать {VKApi, ConsoleLogger} из 'node-vk-sdk' let api = new VKApi ({ регистратор: новый ConsoleLogger () }) api.usersGet ({userIds: ['1']}) .then (response => { console.log (ответ) })
Варианты конструктора ВКАпи
interface VKApiOptions { lang ?: строка | число, testMode ?: число, регистратор ?: BaseLogger, токен ?: строка, тайм-аут ?: число, requestPerSecond ?: число, useQueue ?: логический }
lang?
— Определяет язык отображения данных. Например, названия страны и города. Если вы используете не кириллический язык, символы кириллицы будут переведены автоматически.
en - английский, ru - русский, ua - украинский, be - белорусский, es - испанский, fi - финский, de - немецкий, it - итальянский.
Числовой формат изaccount.getInfo
также поддерживается.test_mode?
— 1 — позволяет отправлять запросы из нативного приложения, не включая его для всех пользователей.- Регистратор
?
— Класс Logger, реализующийBaseLogger
Логирование не будет использоваться, логгер не передан токен?
— Маркер доступатайм-аут?
— Тайм-аут сети в мсrequestsPerSecond
— Максимальное количество запросов в секунду, по умолчанию 3useQueue
— Если useQueue имеет значение true, то SDK ограничит количество запросов в секунду на уровнеrequestsPerSecond
Вызов методов
Все методы api, возвращающие Promise, поэтому вы можете использовать их как Promise или как асинхронные функции.Аргументы методов описаны в интерфейсах, поэтому вам необходимо передать объект, реализующий этот интерфейс, например users.get
props interface:
интерфейс экспорта UsersGetParams { / ** * Идентификаторы пользователя или имена экранов ('screen_name'). По умолчанию текущий идентификатор пользователя. * / user_ids ?: строка [], / ** * Поля профиля для возврата. Примеры значений: 'nickname', 'screen_name', 'sex', 'bdate' (дата рождения), 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'has_mobile', 'контакты', 'образование', 'онлайн', 'счетчики', 'отношение', 'last_seen', 'activity', 'can_write_private_message', 'can_see_all_posts', 'can_post', 'университеты', * / поля ?: строка [], / ** * Регистр склонения имени и фамилии пользователя: 'nom' - именительный падеж (по умолчанию), 'gen' - родительный падеж, 'dat' - дательный, 'acc' - винительный падеж, 'ins' - инструментальный, 'abl' - предложный * / name_case ?: строка, / ** * токен доступа * / access_token ?: строка }
Все интерфейсы props имеют свойство accessToken
, этот токен будет использоваться вместо токена, переданного в VKApi
Пример вызова:
api.usersGet ({user_ids: ['1']}) .then (response => { console.log (ответ) }) // или мы можем назвать это асинхронной функцией let response = await api.usersGet ({user_ids: ['1']})
Методы прямого вызова:
// делает простой вызов и возвращает содержимое свойства response ответа сервера общедоступный асинхронный вызов (метод: строка, параметры: объект): Promise// Выполняет вызов api и если был // ошибка на стороне сервера или достигнут лимит запросов // повторяет вызов через некоторое время общедоступный async callWithRetry (метод: строка, параметры: объект): Promise
Боты Long Poll API
Для получения групповых обновлений с помощью Bots Long Poll API используйте BotsLongPollUpdatesProvider
class:
импортировать {VKApi, ConsoleLogger, BotsLongPollUpdatesProvider} из 'node-vk-sdk' let api = new VKApi ({ токен: 'GROUP_TOKEN_HERE', регистратор: новый ConsoleLogger () }) пусть updatesProvider = новый BotsLongPollUpdatesProvider (api, GROUP_ID_HERE) updatesProvider.getUpdates (updates => { console.log ('получил обновления:', обновления) })
VK Shop плагин для Shop-Script — Интернет-магазин
Плагин позволяет массово экспортировать товары в группу Вконтакте с помощью Product API.
В настройках группы необходимо указать, что товар входит в комплект.
Все обладатели лицензии на плагин Вконтакте могут получить купон на скидку 30%, обратившись на почтовый ящик [email protected] и указав номер заказа и адрес сайта, на который была приобретена лицензия.
страница документации
Прежде чем предпринимать какие-либо действия по экспорту товаров в социальной сети Вконтакте, мы должны ввести учетные данные в настройках плагина и произвести авторизацию.
ЭКСПОРТ ТОВАРОВ В РЕДАКТОРЕ ПРОДУКЦИИ
В настройках каждого пункта будет кнопка для активации плагина
Нажмите кнопку, появится экран выбора экспортированного изображения.
Вы можете выбрать максимум пять изображений. После того, как мы выбрали изображение, нажмите «Обучение», и вы увидите всплывающее диалоговое окно:
Здесь мы можем редактировать описание, цену и другие параметры экспорта.Затем нажмите кнопку «Отправить».
Товар будет выгружен в следующем виде:
МАСС-разгрузка
После установки плагина в меню перечислены элементы для очереди.
Вы можете добавить любое количество всех товаров.
Какие именно продукты нельзя выгружать в группе Вконтакте (отключить товары), можно определить в этом меню.
Тех.можно исключить часть экспорта товаров, а затем выделить все предметы и бросить их в очередь. Это будет добавлено ко всем продуктам, кроме отключенного.
Нельзя использовать услугу добавления в очередь и выгрузки товаров по спискам или видам.
После того, как вы выполнили все манипуляции с очередью, вы готовы к экспорту. Для этого перейдите во вкладку Импорт / Экспорт и выберите плагин «Магазин ВКонтакте»
Изначально вы можете экспортировать все продукты с настройками по умолчанию.Затем, если вы снимите флажок «Экспортировать только новые товары», то включите режим редактирования. Информация о уже загруженных товарах будет актуализирована. Например, синхронизированные тарифы. Если вы отключите режим «Экспорт изображения», процесс обновления товаров пройдет намного быстрее.
Флажки для работы со складами устанавливаются в зависимости от режима работы магазина.
Обращаем ваше внимание, что при разгрузке товаров будет создан список или тип выбора с названием типа товара или список товаров.
Вывоз товара:
Иногда имеет смысл удалить, а потом перезалить весь товар или его часть. Ни в коем случае не снимайте изделия прямо с ленты. Удалять предметы из группы только через заглушку. Во первых это намного проще и быстрее, а во вторых каждый груз загружается с товарами, хранящимися в базе данных. Если вы удалите товары из группы, плагин примет загруженные товары и не будет воспринимать их как новые, а попытается обновить информацию о них.В результате этот товар не будет выгружен при экспорте.
Чего ожидать в следующей версии:
Автоматическое обновление товара в группе сразу после сохранения товара.
Автоматическое удаление группы после выноса товара в магазине.
Удобнее работать с коллекциями товаров.
Просмотр списка элементов в очереди.
Более подробный отчет по экспорту.
Политика VerifyAPIKey | Apigee Edge | Документы Apigee
Вы просматриваете документацию Apigee Edge.
См. Документацию Apigee X.
Что
Политика Verify API Key позволяет принудительно проверять ключи API во время выполнения, позволяя только приложения с одобренными ключами API получают доступ к вашим API. Эта политика гарантирует, что ключи API действительны, имеют не были отозваны и одобрены для использования определенных ресурсов, связанных с вашим API товары.
Образцы
Ключ в параметре запроса
В этом примере политика ожидает найти ключ API в переменной потока с именем request.queryparam.apikey
. Переменная request.queryparam. {Name}
— это стандартная переменная пограничного потока, которая заполняется значением переданного параметра запроса.
в запросе клиента.
Следующая команда curl
передает ключ API в параметре запроса:
завиток http://myorg-test.apigee.net/mocktarget? apikey = IEYRtW2cb7A5Gs54A1wKElECBL65GVlsХотя это разрешено, как правило, передача API — плохая практика. введите параметр запроса. Причина в том, что параметры запроса могут отображаться в браузере. история и сетевые журналы, которые представляют возможную угрозу безопасности. Лучшая практика — поместите ключ API в заголовок, который не будет отображаться в файлах журнала.См. «КЛЮЧ В ЗАГОЛОВКЕ» пример на следующей вкладке.
В этом примере политика ожидает найти ключ API в переменной потока с именем request.header.x-apikey
. Переменная request.header. {Name}
это стандартная переменная пограничного потока, которая заполняется значением переданного заголовка
в запросе клиента.
Следующий cURL показывает, как передать ключ API в заголовке:
curl "http://myorg-test.apigee.net/mocktarget" -H "x-apikey: IEYRtW2cb7A5Gs54A1wKElECBL65GVls"Передача API — хорошая практика. введите заголовок, а не параметр запроса. Причина в том, что заголовки не отображаются в истории браузера или сетевые журналы, которые могут представлять возможную угрозу безопасности.
Введите переменную
Политика может ссылаться на любую переменную, содержащую ключ. Политика в этом примере извлекает ключ API из переменной с именем requestAPIKey.key.
Выбор этой переменной зависит от вас. Например, вы можете использовать Extract Политика переменных для заполнения requestAPIKey.key из параметра запроса назвал myKey, как показано ниже:
{ключ} requestAPIKey true
Переменные потока политики доступа
devFirstName verifyapikey.verify-api-key.developer.firstNameErrorOnCopy devLastName verifyapikey.verify-api-key.developer.lastNameErrorOnCopy devEmail verifyapikey.verify-api-key.developer.emailErrorOnCopy true
Edge автоматически заполняет набор переменных потока при выполнении ключа API проверки. политика для действующего ключа API.Вы можете использовать эти переменные для доступа к информации, такой как приложение имя, идентификатор приложения и информация о разработчике или компании, зарегистрировавшей приложение. в в приведенном выше примере вы используете политику «Назначить сообщение» для доступа к имени и фамилии разработчика. имя и адрес электронной почты после выполнения Verify API Key.
Все эти переменные имеют префикс:
verifyapikey. {Policy_name}
В этом примере имя политики Verify API key — «verify-api-key».Таким образом, вы ссылаетесь на
имя разработчика, отправившего запрос, получив доступ к
переменная verifyapikey.verify-api-key.developer.firstName.
Learn Edge
Пример: Учитесь на практике!Пример защиты прокси-сервера с помощью ключа API обеспечивает защиту прокси-сервера API с помощью ключа API, а Параметр «Удалить параметр запроса apikey» показывает, как удалить ключ API из запроса, чтобы предотвратить его. от передачи целевой серверной части (лучшая практика).Просто клонируйте репозиторий и следуйте инструкциям в файлах README.
О политике проверки ключа API
Когда разработчик регистрирует приложение в Edge, Edge автоматически генерирует потребительский ключ и секретная пара. Вы можете увидеть ключ потребителя и секретную пару приложения в пользовательском интерфейсе Edge или получить к ним доступ. из Edge API.
Примечание. У ключей API много имен. Вы можете видеть, что они называются «API ключи »,« ключи приложения »и« ключи потребителя ». Все эти имена синонимичны.Во время регистрации приложения разработчик выбирает один или несколько продуктов API для связать с приложением, где продукт API представляет собой набор из ресурсов доступны через прокси API. Затем разработчик передает ключ API (ключ потребителя) как часть каждый запрос к API в продукте API, связанном с приложением. См. Дополнительную информацию в разделе «Обзор публикации».
ключей API можно использовать в качестве токенов аутентификации или для получения доступа OAuth. жетоны.В OAuth ключи API называются «идентификатором клиента». Имена могут использоваться как синонимы. См. Домашнюю страницу OAuth для получения дополнительной информации.
Edge автоматически заполняет набор переменных потока при выполнении политики Verify API Key. См. Поток переменные ниже, чтобы узнать больше.
Ссылка на элемент
Ниже приведены элементы и атрибуты, которые можно настроить в этой политике:
Пользовательская метка, используемая в пользовательском интерфейсе
Атрибуты
В следующем примере показаны атрибуты тега
:
В следующей таблице описаны атрибуты, общие для всех родительских элементов политики:
Атрибут | Описание | По умолчанию | Присутствие |
---|---|---|---|
наименование | Внутреннее имя политики.Значение атрибута При желании используйте элемент | НЕТ | Требуется |
continueOnError | Установите значение Установите значение | ложь | Дополнительно |
включен | Установите значение Установите значение | правда | Дополнительно |
асинхронный | Этот атрибут устарел. | ложь | Устарело |
Элемент
Используйте в дополнение к атрибуту name
для обозначения политики в
редактор прокси пользовательского интерфейса управления с другим названием на естественном языке.
Отображаемое имя политики
По умолчанию | НЕТ Если вы опустите этот элемент, значение атрибута |
---|---|
Присутствие | Дополнительно |
Тип | Строка |
Элемент
Этот элемент определяет переменную потока, содержащую ключ API.Обычно клиент отправляет ключ API
в параметре запроса, HTTP-заголовке или параметре формы. Например, если ключ отправляется в заголовке
называется x-apikey
, ключ находится в переменной: request.header.x-apikey
По умолчанию | NA |
---|---|
Присутствие | Требуется |
Тип | Строка |
Атрибуты
В следующей таблице описаны атрибуты элемента
Атрибут | Описание | По умолчанию | Присутствие |
---|---|---|---|
исх. | Ссылка на переменную, содержащую ключ API.Разрешено только одно место за политику. | НЕТ | Требуется |
Примеры
В этих примерах ключ передается в параметрах и заголовке с именем x-apikey
.
В качестве параметра запроса:
В качестве заголовка HTTP:
В качестве параметра формы HTTP:
Схемы
Пример: См. Наш GitHub образцы репозитория для самых последних схем.Переменные расхода
Когда политика Verify API Key применяется к действительному ключу API, Edge заполняет набор потока переменные. Эти переменные доступны для политик или кода, выполняемого позже в потоке, и часто используется для выполнения пользовательской обработки на основе атрибутов ключа API, таких как имя приложения, продукт API, используемый для авторизации ключа, или настраиваемые атрибуты ключа API.
Политика заполняет несколько различных типов переменных потока, в том числе:
- Общие
- Приложение
- Разработчик
- Компания
- Аналитика
У каждого типа переменной потока есть свой префикс.Все переменные являются скалярами, кроме специально обозначены как массивы.
Общие переменные расхода
В следующей таблице перечислены общие переменные потока, заполненные политикой Verify API Key. Все эти переменные имеют префикс:
verifyapikey. {Policy_name}
Например: verifyapikey. {Policy_name} .client_id
Доступные переменные:
Переменная | Описание |
---|---|
client_id | Ключ потребителя (также известный как ключ API или ключ приложения), предоставленный запрашивающим приложением. |
client_secret | Секрет потребителя, связанный с ключом потребителя. |
redirection_uris | Любые URI перенаправления в запросе. |
developer.app.id | Идентификатор приложения разработчика, выполняющего запрос. Примечание. Не используйте переменную developer.app.id в следующих целях:
Этот идентификатор генерируется внутри Apigee и не гарантируется, что он останется неизменным с течением времени.Например, Apigee может изменить формат или длину этой переменной. |
разработчик.имя приложения | Имя приложения разработчика, выполняющего запрос. |
developer.id | Идентификатор разработчика, зарегистрированного как владелец запрашивающего приложения. Примечание. Не используйте переменную developer.id в следующих целях:
Этот идентификатор генерируется внутри Apigee и не гарантируется, что он останется неизменным с течением времени.Например, Apigee может изменить формат или длину этой переменной. |
разработчик. {Custom_attrib_name} | Любые настраиваемые атрибуты, полученные из профиля ключа приложения. |
DisplayName | Значение атрибута политики |
не удалось | Установите значение «true», если проверка ключа API завершилась неудачно. |
{custom_app_attrib} | Любой настраиваемый атрибут, полученный из профиля приложения. Укажите название кастома атрибут. |
имя продукта * | Имя продукта API, использованного для проверки запроса. |
apiproduct. {Custom_attrib_name} * | Любой настраиваемый атрибут, полученный из профиля продукта API. |
apiproduct.developer.quota.limit * | Ограничение квоты, установленное для продукта API, если таковой имеется. |
apiproduct.developer.quota.interval * | Интервал квоты, установленный для продукта API, если таковой имеется. |
apiproduct.developer.quota.timeunit * | Единица времени квоты, установленная для продукта API, если таковой имеется. |
* Переменные продукта API заполняются автоматически, если продукты API
настроен с допустимой средой, прокси-серверами и ресурсами (полученными из
прокси .pathsuffix ). Инструкции по настройке продуктов API см. В разделе
Использование Edge
API управления для публикации API. |
Переменные потока приложения
Следующие переменные потока, содержащие информацию о приложении, заполняются политикой. Все эти переменные имеют префикс:
verifyapikey. {Policy_name} .app
.
Например:
verifyapikey. {Policy_name} .app.name
Доступные переменные:
Переменная | Описание |
---|---|
название | Название приложения. |
id | Идентификатор приложения. |
Тип доступа | Не используется Apigee. |
обратный звонокUrl | URL-адрес обратного вызова приложения. Обычно используется только для OAuth. |
DisplayName | Отображаемое имя приложения. |
статус | Статус приложения, например «одобрено» или «отозвано». |
продукты | Массив, содержащий список продуктов API, связанных с приложением. |
приложение Семья | Любое семейство приложений, содержащее приложение, или «по умолчанию». |
appParentStatus | Статус родительского приложения, например «активно» или «неактивно». |
appType | Тип приложения: «Компания» или «Разработчик». |
appParentId | Идентификатор родительского приложения. |
created_at | Отметка даты и времени, когда приложение было создано. |
created_by | Адрес электронной почты разработчика, создавшего приложение. |
last_modified_at | Отметка даты и времени последнего обновления приложения. |
last_modified_by | Адрес электронной почты разработчика, который последний раз обновлял приложение. |
{app_custom_attributes} | Любой настраиваемый атрибут приложения. Укажите имя настраиваемого атрибута. |
Следующие переменные потока, содержащие информацию о разработчике, заполняются политика.Все эти переменные имеют префикс:
verifyapikey. {Policy_name} .developerПримечание: Если
verifyapikey. {policy_name} .app.appType Переменная потока
— «Разработчик»,
затем заполняются атрибуты разработчика. Если app.appType
— «Компания», то
Атрибуты компании заполнены.Например:
verifyapikey. {Policy_name} .developer.id
Доступные переменные:
Переменная | Описание |
---|---|
id | Возвращает {org_name} @@@ {developer_id} |
имя пользователя | Имя пользователя разработчика. |
имя | Имя разработчика. |
фамилия | Фамилия разработчика. |
электронная почта | Электронный адрес разработчика. |
статус | Статус разработчика: активный, неактивный или login_lock. |
приложений | Массив приложений, связанных с разработчиком. |
created_at | Отметка даты и времени создания разработчика. |
created_by | Адрес электронной почты пользователя, создавшего разработчика. |
last_modified_at | Отметка даты и времени последнего изменения разработчика. |
last_modified_by | Электронный адрес пользователя, изменившего разработчика. |
{developer_custom_attributes} | Любой настраиваемый атрибут разработчика. Укажите имя настраиваемого атрибута. |
Компания | Название компании, связанной с разработчиком, если таковая имеется. |
Переменные потока компании
Следующие переменные потока, содержащие информацию о компании, заполняются политика.Все эти переменные имеют префикс:
verifyapikey. {Policy_name} .companyПримечание: Если
verifyapikey. {policy_name} .app.appType
— «Компания», затем компания
атрибуты заполнены. Если app.appType
— «Разработчик», то разработчик
атрибуты заполнены.Например:
verifyapikey. {Policy_name} .company.name
Доступные переменные:
Переменная | Описание |
---|---|
название | Название компании. |
displayName | Отображаемое название компании. |
id | ID компании. Примечание: Не используйте переменную company.id в следующих целях:
Этот идентификатор генерируется внутри Apigee и не гарантируется, что он останется неизменным с течением времени.
Например, Apigee может изменить формат или длину этой переменной. |
приложений | Массив, содержащий список приложений компании. |
appOwnerStatus | Статус владельца приложения: активный, неактивный или login_lock. |
created_at | Отметка даты и времени создания компании. |
created_by | Электронный адрес пользователя, создавшего компанию. |
last_modified_at | Отметка даты и времени последнего изменения компании. |
last_modified_by | Адрес электронной почты пользователя, последним изменившего компанию. |
{company_custom_attributes} | Любой настраиваемый атрибут компании. Укажите имя настраиваемого атрибута. |
Аналитические переменные
Следующие переменные автоматически подставляются в Google Analytics, когда политика Verify API Key принудительно применяется для действительного ключа API.Эти переменные заполняются только ключом API проверки. политика и политики OAuth.
Переменные и значения можно использовать в качестве измерений для построения отчетов Analytics, чтобы получить видимость моделей потребления разработчиками и приложениями.
- apiproduct.name
- developer.app.name
- client_id
- developer.id
Ссылка на ошибку
В этом разделе описаны коды ошибок и сообщения об ошибках, которые возвращаются, а также переменные ошибок, которые устанавливаются Edge, когда эта политика вызывает ошибку.Эта информация важна, если вы разрабатываете правила сбоя, чтобы обрабатывать неисправности. Чтобы узнать больше, см. Что вам нужно знать об ошибках политики и обработке неисправности.
Ошибки времени выполнения
Эти ошибки могут возникать при выполнении политики.
Совет: Используйте API Monitoring для исследования неисправности коды и быстрее диагностировать проблемы. См. Раздел Настройка предупреждения кода ошибки политики. для примера. См. Полный перечень кодов неисправности. список всех кодов ошибок, с которыми вы можете справиться с помощью API-мониторинга.Код неисправности | HTTP-статус | Причина |
---|---|---|
keymanagement.service.CompanyStatusNotActive | 401 | Компания, связанная с приложением разработчика, у которой есть ключ API, который вы используете, имеет неактивный статус. Когда статус компании установлен на неактивный, вы не можете получить доступ к разработчикам или приложениям, связанным с этой Компанией. Администратор организации может изменить статус компании с помощью API управления.См. Раздел «Установка статуса». компании. |
keymanagement.service.DeveloperStatusNotActive | 401 | Разработчик, создавший приложение для разработчиков с ключом API, который вы используете, имеет неактивный статус. Когда статус разработчика приложений установлен как неактивный, любые приложения разработчика созданные этим разработчиком деактивированы. Пользователь-администратор с соответствующими разрешениями (например, администратор организации) может изменить статус разработчика в следующих способы: |
управление ключами.service.invalid_client-app_not_approved | 401 | Приложение разработчика, связанное с ключом API, отозвано. Отозванное приложение не может получить доступ к любым продуктам API и не может вызывать какой-либо API, управляемый Apigee Edge. Администратор организации может изменить статус приложения разработчика с помощью API управления. Видеть Утвердить или отозвать приложение разработчика. |
oauth.v2.FailedToResolveAPIKey | 401 | Политика ожидает найти ключ API в переменной, указанной в политике |
oauth.v2.InvalidApiKey | 401 | Edge получил ключ API, но он недействителен. Когда Эдж ищет ключ в своем база данных, она должна точно соответствовать тому, что было отправлено в запросе. Если API работал ранее убедитесь, что ключ не создавался повторно. Если ключ был регенерирован, вы увидите эта ошибка, если вы попытаетесь использовать старый ключ.Подробнее см. Регистрация приложений и управление API. ключи. |
oauth.v2.InvalidApiKeyForGivenResource | 401 | Ключ API был получен Edge, и он действителен; однако он не соответствует утвержденный ключ в приложении разработчика, связанный с вашим прокси-сервером API через Продукт. |
ApiKeyNotApproved ошибка
точно.Вместо этого, если ключ не утвержден (его статус
установлено значение «отозвано» или «ожидает рассмотрения»), вместо этого вы получите ошибку FailedToResolveAPIKey. Для большего
информацию и возможный обходной путь см.
этот пост в сообществе Apigee.Ошибки развертывания
Эти ошибки могут возникать при развертывании прокси-сервера, содержащего эту политику.
Имя ошибки | Причина |
---|---|
SpecifyValueOrRefApiKey | Элемент не имеет значения или ключа. |
Переменные неисправности
Эти переменные устанавливаются при возникновении ошибки времени выполнения. Для получения дополнительной информации см. Что вам нужно знать об ошибках политики.
Переменные | Где | Пример |
---|---|---|
fault.name = " fault_name " | имя_ ошибки — это имя ошибки, как указано в таблице ошибок времени выполнения выше.Название неисправности — это последняя часть кода неисправности. | fault.name Соответствует «FailedToResolveAPIKey» |
oauthV2. имя_политики .failed | имя_политики — указанное пользователем имя политики, вызвавшей ошибку. | oauthV2.VK-VerifyAPIKey.failed = true |
Примеры ответов об ошибках
Примечание: Для обработки ошибок лучше всего перехватить Код ошибки
— часть сообщения об ошибке.Не полагайтесь на текст в faultstring
, потому что она может измениться. { "вина":{ "faultstring": "Недопустимый ApiKey", "деталь": { "код ошибки": "oauth.