severecloud / vksdk Goto Github PK

https://vk.com/dev/streaming_api_docs

https://vk.com/dev/board

• board.addTopic
• board.closeTopic
• board.createComment
• board.deleteComment
• board.deleteTopic
• board.editComment
• board.editTopic
• board.fixTopic
• board.getComments
• board.getComments extended
• board.getTopics
• board.getTopics extended
• board.openTopicRe
• board.restoreComment
• board.unfixTopic

https://vk.com/dev/leads

• leads.checkUser Checks if the user can start the lead.
• leads.complete Completes the lead started by user.
• leads.getStats Returns lead stats data.
• leads.getUsers Returns a list of last user actions for the offer.
• leads.metricHit Counts the metric event.
• leads.start Creates new session for the user passing the offer.

https://vk.com/dev/newsfeed

• newsfeed.addBan
• newsfeed.deleteBan
• newsfeed.deleteList
• newsfeed.get
• newsfeed.getBanned
• newsfeed.getBanned extended
• newsfeed.getComments
• newsfeed.getDiscoverForContestant
• newsfeed.getLists
• newsfeed.getMentions
• newsfeed.getRecommended
• newsfeed.getSuggestedSources
• newsfeed.ignoreItemHides
• newsfeed.saveList
• newsfeed.search
• newsfeed.search extended
• newsfeed.unignoreItem
• newsfeed.unsubscribe

• fave.addArticle Добавляет статью в закладки.
• fave.addLink Добавляет ссылку в закладки.
• fave.addPage Добавляет сообщество или пользователя в закладки.
• fave.addPost Добавляет запись со стены пользователя или сообщества в закладки.
• fave.addProduct Добавляет товар в закладки.
• fave.addTag Создает метку закладок.
• fave.addVideo Добавляет видеозапись в закладки.
• fave.editTag Редактирует метку.
• fave.get Возвращает объекты, добавленные в закладки пользователя.
• fave.getPages Возвращает страницы пользователей и сообществ, добавленных в закладки.
• fave.getTags Возвращает список меток в закладках.
• fave.markSeen Отмечает закладки как просмотренные.
• fave.removeArticle Удаляет статью из закладок.
• fave.removeLink Удаляет ссылку из списка закладок пользователя.
• fave.removePage Удаляет из закладок сообщество или страницу пользователя.
• fave.removePost Удаляет из закладок запись на стене пользователя или сообщества.
• fave.removeProduct Удаляет товар из закладок.
• fave.removeTag Удаляет метку закладок.
• fave.removeVideo Удаляет видеозапись из списка закладок.
• fave.reorderTags Меняет порядок меток закладок в списке.
• fave.setPageTags Устанавливает метку странице пользователя или сообщества.
• fave.setTags Устанавливает метку выбранному объекту в списке закладок.
• fave.trackPageInteraction Устанавливает страницу пользователя или сообщества в топ закладок.

https://vk.com/dev/polls

• polls.addVote
• polls.create
• polls.deleteVote
• polls.edit
• polls.getBackgrounds
• polls.getById
• polls.getPhotoUploadServer
• polls.getVoters
• polls.getVoters fields
• polls.savePhoto

https://vk.com/bug136108

Шаги воспроизведения:

1. Запросить например users.get c параметрами fields=occupation и user_ids=331726408

P.S. Даже не пытайтесь запросить через vk.com/dev - там нули обрезаются

Фактический результат:

"id": 960775.000000,

Ожидаемый результат:

"id": 960775,

Временный костыль - вместо int использовать float64

https://vk.com/dev/orders

• orders.cancelSubscription Allows to cancel subscription.
• orders.changeState Changes order status.
• orders.get Returns a list of orders.
• orders.getAmount Returns the cost of votes in the user's consent.
• orders.getById Returns information about orders by their IDs.
• orders.getUserSubscriptionById Allows to get subscription by its ID.
• orders.getUserSubscriptions Allows to get user's active subscriptions.
• orders.updateSubscription Allows to update subscription price.

https://vk.com/dev/apps

• apps.deleteAppRequests deletes all request notifications from the current app.
• apps.get returns applications data.
• apps.getCatalog returns a list of applications (apps) available to users in the App Catalog.
• apps.getFriendsList creates friends list for requests and invites in current app.
• apps.getLeaderboard returns players rating in the game.
• apps.getLeaderboard extended
• apps.getScopes x
• apps.getScore returns user score in app.
• apps.sendRequest sends a request to another user in an app that uses VK authorization.

https://vk.com/dev/video

• video.add
• video.addAlbum
• video.addToAlbum
• video.createComment
• video.delete
• video.deleteAlbum
• video.deleteComment
• video.edit
• video.editAlbum
• video.editComment
• video.get
• video.get extended
• video.getAlbumById
• video.getAlbumById extended
• video.getAlbums
• video.getAlbums extended
• video.getAlbumsByVideo
• video.getComments
• video.getComments extended
• video.removeFromAlbum
• video.reorderAlbums
• video.reorderVideos
• video.report
• video.reportComment
• video.restore
• video.restoreComment
• video.save
• video.search
• video.search extended

https://vk.com/dev/streaming

• streaming.getServerUrl Allows to receive data for the connection to Streaming API.
• streaming.getSettings Allows to receive monthly tier for Streaming API.
• streaming.getStats Allows to receive statistics for prepared and received events in Streaming API.
• streaming.getStem Allows to receive the stem of the word.
• streaming.setSettings Allows to set monthly tier for Streaming API.

https://vk.com/dev/appWidgets

• appWidgets.getAppImageUploadServer
• appWidgets.getAppImages
• appWidgets.getGroupImageUploadServer
• appWidgets.getGroupImages
• appWidgets.getImagesById
• appWidgets.saveAppImage
• appWidgets.saveGroupImage
• appWidgets.update

https://vk.com/dev/secure

• secure.addAppEvent Adds user activity information to an application
• secure.checkToken Checks the user authentification in IFrame and Flash apps using the access_token parameter.
• secure.getAppBalance Returns payment balance of the application in hundredth of a vote.
• secure.getSMSHistory Shows a list of SMS notifications sent by the application using secure.sendSMSNotification method.
• secure.getTransactionsHistory Shows history of votes transaction between users and the application.
• secure.getUserLevel Returns one of the previously set game levels of one or more users in the application.
• secure.giveEventSticker
• secure.sendNotification Sends notification to the user.
• secure.sendSMSNotification Sends SMS notification to a user's mobile device.
• secure.setCounter Sets a counter which is shown to the user in bold in the left menu.

https://vk.com/dev/docs

• docs.add
• docs.delete
• docs.edit
• docs.get
• docs.getById
• docs.getMessagesUploadServer
• docs.getTypes
• docs.getUploadServer
• docs.getWallUploadServer
• docs.save
• docs.search

https://vk.com/dev/messages

• messages.addChatUser
• messages.allowMessagesFromGroup
• messages.createChat
• messages.delete
• messages.deleteChatPhoto
• messages.deleteConversation
• messages.denyMessagesFromGroup
• messages.edit
• messages.editChat
• messages.getByConversationMessageId
• messages.getById
• messages.getById extended
• messages.getChat
• messages.getChat chat_ids
• messages.getChatPreview
• messages.getConversationMembers
• messages.getConversations
• messages.getConversationsById
• messages.getConversationsById extended
• messages.getHistory
• messages.getHistoryAttachments
• messages.getImportantMessages
• messages.getInviteLink
• messages.getLastActivity
• messages.getLongPollHistory
• messages.getLongPollServer
• messages.isMessagesFromGroupAllowed
• messages.joinChatByInviteLink
• messages.markAsAnsweredConversation
• messages.markAsImportant
• messages.markAsImportantConversation
• messages.markAsRead
• messages.pin
• messages.removeChatUser
• messages.restore
• messages.search
• messages.searchConversations
• messages.send
• messages.send user_ids
• messages.setActivity
• messages.setChatPhoto
• messages.unpin

https://vk.com/dev/likes

• likes.add
• likes.delete
• likes.getList
• likes.getList extended
• likes.isLiked

https://vk.com/dev/search.getHints

https://vk.com/dev/users

• users.get
• users.getFollowers
• users.getSubscriptions
• users.getSubscriptions extended
• users.isAppUser
• users.report
• users.search

Сейчас судя по коду функции, которые обрабатывают различные события выполняются последовательно.
Вопрос в том, что некоторые функции могут работать достаточно длительное время и тогда callback может не дождаться ответа "ok". И callback будет повторно подключаться. хотя это событие уже было обработано.
P.S. Это также может делать в коде сам программист далее)

https://vk.com/dev/bots_longpoll

https://vk.com/dev/prettyCards

• prettyCards.create
• prettyCards.delete
• prettyCards.edit
• prettyCards.get
• prettyCards.getById
• prettyCards.getUploadURL

https://vk.com/bug136096

Шаги воспроизведения:

1. Берем группу в которой не происходит активности
2. Запрашиваем https://vk.com/dev/stats.get с интервалом

Фактический результат:

"activity": [],

Ожидаемый результат:

"activity": {},

https://vk.com/bug136682

Шаги воспроизведения:

1. Запросить board.getTopics c параметрами group_id=1 и topic_id=21972169

P.S. Даже не пытайтесь запросить через vk.com/dev - там нули обрезаются

Фактический результат:

"default_order": 2.000000,

Ожидаемый результат:

"default_order": 2,

Временный костыль - вместо int использовать float64

money.sendRequest Sends a transfer request

https://vk.com/dev/stats

• stats.get
• stats.getPostReach
• stats.trackVisitor

https://vk.com/dev/friends

• friends.add
• friends.addList
• friends.areFriends
• friends.delete
• friends.deleteAllRequests
• friends.deleteList
• friends.edit
• friends.editList
• friends.get
• friends.getAppUsers
• friends.getByPhones
• friends.getLists
• friends.getMutual
• friends.getOnline
• friends.getRecent
• friends.getRequests
• friends.getRequests extended
• friends.getSuggestions
• friends.search

https://vk.com/dev/groups

• groups.addAddress
• groups.addCallbackServer
• groups.addLink
• groups.approveRequest
• groups.ban
• groups.create
• groups.deleteAddress
• groups.deleteCallbackServer
• groups.deleteLink
• groups.disableOnline
• groups.editAddress
• groups.edit
• groups.editCallbackServer
• groups.editLink
• groups.editManager
• groups.enableOnline
• groups.get
• groups.get extended
• groups.getAddresses
• groups.getBanned
• groups.getById
• groups.getCallbackConfirmationCode
• groups.getCallbackServers
• groups.getCallbackSettings
• groups.getCatalog
• groups.getCatalogInfo
• groups.getCatalogInfo extended
• groups.getInvitedUsers
• groups.getInvites
• groups.getInvites extended
• groups.getLongPollServer
• groups.getLongPollSettings
• groups.getMembers
• groups.getOnlineStatus
• groups.getRequests
• groups.getSettings
• groups.getTokenPermissions
• groups.invite
• groups.isMember
• groups.isMember extended
• groups.isMember user_ids(?) extended
• groups.isMember user_ids(?)
• groups.join
• groups.leave
• groups.removeUser
• groups.reorderLink
• groups.search
• groups.setCallbackSettings
• groups.setLongPollSettings
• groups.unban

https://vk.com/dev/wall

• wall.closeComments
• wall.createComment
• wall.delete
• wall.deleteComment
• wall.edit
• wall.editAdsStealth
• wall.editComment
• wall.get
• wall.get extended
• wall.getById
• wall.getById extended
• wall.getComment
• wall.getComments
• wall.getComments extended
• wall.getReposts
• wall.openComments
• wall.pin
• wall.post
• wall.postAdsStealth
• wall.reportComment
• wall.reportPost
• wall.repost
• wall.restore
• wall.restoreComment
• wall.search
• wall.search extended
• wall.unpin

https://vk.com/dev/widgets

• widgets.getComments
• widgets.getPages

https://vk.com/dev/notes

• notes.add
• notes.createComment
• notes.delete
• notes.deleteComment
• notes.edit
• notes.editComment
• notes.get
• notes.getById
• notes.getComments
• notes.restoreComment

https://vk.com/dev/photos

• photos.confirmTag
• photos.copy
• photos.createAlbum
• photos.createComment
• photos.delete
• photos.deleteAlbum
• photos.deleteComment
• photos.edit
• photos.editAlbum
• photos.editComment
• photos.get
• photos.get extended
• photos.getAlbums
• photos.getAlbumsCount
• photos.getAll
• photos.getAll extended
• photos.getAllComments
• photos.getById
• photos.getById extended
• photos.getChatUploadServer
• photos.getComments
• photos.getComments extended
• photos.getMarketAlbumUploadServer
• photos.getMarketUploadServer
• photos.getMessagesUploadServer
• photos.getNewTags
• photos.getOwnerCoverPhotoUploadServer
• photos.getOwnerPhotoUploadServer
• photos.getTags
• photos.getUploadServer
• photos.getUserPhotos
• photos.getUserPhotos extended
• photos.getWallUploadServer
• photos.makeCover
• photos.moveMoves
• photos.putTag
• photos.removeTag
• photos.reorderAlbums
• photos.reorderPhotos
• photos.report
• photos.reportComment
• photos.restore
• photos.restoreComment
• photos.save
• photos.saveMarketAlbum
• photos.saveMarketPhoto
• photos.saveMessagesPhoto
• photos.saveOwnerCoverPhoto
• photos.saveOwnerPhoto
• photos.saveWallPhoto
• photos.search

https://vk.com/dev/upload_files

• Uploading Photos into User Album
• Uploading Photos on User Wall
• Uploading Photos into User Profile or Community
• Uploading Photos into a Private Message
• Uploading a Main Photo to a Group Chat
• Uploading a Market Item Photo
• Uploading a Market Collection Photo
  Uploading Audio Files
• Uploading Video Files
• Uploading Documents
• Uploading Community Cover
• Uploading Audiomessage
• Uploading Story

Загрузка обложки для формы

Для форм сбора заявок используются прямоугольные изображения размером 1200х300. В случае загрузки изображения другого размера, оно будет автоматически обрезано до требуемого. Допустимые форматы: JPG, PNG, BMP, TIFF или GIF. Ограничения: файл объемом не более 5 МБ.

photo, vkErr = vk.UploadLeadFormsPhoto(file)

Полученные данные можно использовать в методах leadForms.create и leadForms.edit.

Документация вк:

leadForms.getUploadURL

https://vk.com/dev/stories

• stories.banOwner
• stories.delete
• stories.get
• stories.get extended
• stories.getBanned
• stories.getBanned extended
• stories.getById
• stories.getById extended
• stories.getPhotoUploadServer
• stories.getReplies
• stories.getReplies extended
• stories.getStats
• stories.getVideoUploadServer
• stories.getViewers
• stories.getViewers extended
• stories.hideAllReplies
• stories.hideReply
• stories.unbanOwner

https://vk.com/dev/errors

https://vk.com/dev/ads

• ads.addOfficeUsers Adds managers and/or supervisors to advertising account.
• ads.checkLink Allows to check the ad link.
• ads.createAds Creates ads.
• ads.createCampaigns Creates advertising campaigns.
• ads.createClients Creates clients of an advertising agency.
• ads.createLookalikeRequest
• ads.createTargetGroup Creates a group to re-target ads for users who visited advertiser's site (viewed information about the product, registered, etc.).
• ads.createTargetPixel Creates retargeting pixel.
• ads.deleteAds Archives ads.
• ads.deleteCampaigns Archives advertising campaigns.
• ads.deleteClients Archives clients of an advertising agency.
• ads.deleteTargetGroup Deletes a retarget group.
• ads.deleteTargetPixel Deletes target pixel.
• ads.getAccounts Returns a list of advertising accounts.
• ads.getAds Returns number of ads.
• ads.getAdsLayout Returns descriptions of ad layouts.
• ads.getAdsTargeting Returns ad targeting parameters.
• ads.getBudget Returns current budget of the advertising account.
• ads.getCampaigns Returns a list of campaigns in an advertising account.
• ads.getCategories Returns a list of possible ad categories.
• ads.getClients Returns a list of advertising agency's clients.
• ads.getDemographics Returns demographics for ads or campaigns.
• ads.getFloodStats Returns information about current state of a counter — number of remaining runs of methods and time to the next counter nulling in seconds.
• ads.getLookalikeRequests
• ads.getOfficeUsers Returns a list of managers and supervisors of advertising account.
• ads.getPostsReach
• ads.getRejectionReason Returns a reason of ad rejection for pre-moderation.
• ads.getStatistics Returns statistics of performance indicators for ads, campaigns, clients or the whole account.
• ads.getSuggestions Returns a set of auto-suggestions for various targeting parameters.
• ads.getTargetGroups Returns a list of target groups.
• ads.getTargetPixels
• ads.getTargetingStats Returns the size of targeting audience, and also recommended values for CPC and CPM.
• ads.getUploadURL Returns URL to upload an ad photo to.
• ads.getVideoUploadURL Returns URL to upload an ad video to.
• ads.importTargetContacts Imports a list of advertiser's contacts to count VK registered users against the target group.
• ads.removeOfficeUsers Removes managers and/or supervisors from advertising account.
• ads.removeTargetContacts
• ads.saveLookalikeRequestResult
• ads.shareTargetGroup
• ads.updateAds Edits ads.
• ads.updateCampaigns Edits advertising campaigns.
• ads.updateClients Edits clients of an advertising agency.
• ads.updateTargetGroup Edits a retarget group.
• ads.updateTargetPixel

Загрузка фотографии для карточки

Для карточек используются квадратные изображения минимальным размером 400х400. В случае загрузки неквадратного изображения, оно будет обрезано до квадратного.
Допустимые форматы: JPG, PNG, BMP, TIFF или GIF. Ограничения: файл объемом не более 5 МБ.

photo, vkErr = vk.UploadPrettyCardsPhoto(file)

Полученные данные можно использовать в методах prettyCards.create и prettyCards.edit.

Документация вк:

prettyCards.getUploadURL

https://vk.com/dev/database.getSchoolClasses

Проблема в том, что оно возвращает массив, каждый элемент которого представляет собой пару: идентификатор и строковое обозначение класса.
Иногда возвращает вместо строкового обозначение класса, числовое - баг на стороне VK.

https://vk.com/dev/utils

• utils.checkLink
• utils.deleteFromLastShortened
• utils.getLastShortenedLinks
• utils.getLinkStats
• utils.getLinkStats extended
• utils.getServerTime
• utils.getShortLink
• utils.resolveScreenName

https://vk.com/dev/pages

• pages.clearCache
• pages.get
• pages.getHistory
• pages.getTitles
• pages.getVersion
• pages.parseWiki
• pages.save
• pages.saveAccess

Новое версионирование сломает ваш код, но предупреждение в README неспроста там оказалось.

• Создать ветку v1
• Переместить все из папки 5.92 в корень
• Удалить AddButton
• Встроить go mod
• Закончить писать основной код
• Проверить тесты
• Создать тег v0.1
• Смержить v1 и мастер
• Обозначить тег v1

• podcasts.getCatalog
• podcasts.getCategories
• podcasts.getEpisodes
• podcasts.getFeed
• podcasts.getStartPage
• podcasts.markAsListened
• podcasts.subscribe
• podcasts.unsubscribe

https://vk.com/dev/leadForms

• leadForms.create
• leadForms.delete
• leadForms.get
• leadForms.getLeads
• leadForms.getUploadURL
• leadForms.list
• leadForms.update

https://vk.com/dev/market

• market.add
• market.addAlbum
• market.addToAlbum
• market.createComment
• market.delete
• market.deleteAlbum
• market.deleteComment
• market.edit
• market.editAlbum
• market.editComment
• market.get
• market.get extended
• market.getAlbumById
• market.getAlbums
• market.getById
• market.getById extended
• market.getCategories
• market.getComments
• market.removeFromAlbum
• market.reorderAlbums
• market.reorderItems
• market.report
• market.reportComment
• market.restore
• market.restoreComment
• market.search
• market.search extended

Работать с интерфейсами очень не удобно. Требуется разработать свои готовые обработчики событий, которые будут возвращать готовые структуры.

Загрузка фоновой фотографии в опрос

Допустимые форматы: JPG, PNG, GIF. Ограничения: сумма высоты и ширины не более 14000px, файл объемом не более 50 МБ, соотношение сторон не менее 1:20.

photosPhoto, vkErr = vk.UploadPollsPhoto(file)

photosPhoto, vkErr = vk.UploadOwnerPollsPhoto(ownerID, file)

Для загрузки главной фотографии сообщества необходимо передать его идентификатор со знаком «минус» в параметре ownerID.

Документация вк:

polls.getPhotoUploadServer
polls.savePhoto

https://vk.com/dev/fave

• fave.addGroup
• fave.addLink
• fave.addUser
• fave.getLinks
• fave.getMarketItems
• fave.getMarketItems extended
• fave.getPhotos
• fave.getPosts
• fave.getPosts extended
• fave.getUsers
• fave.getVideos
• fave.getVideos extended
• fave.removeGroup
• fave.removeLink
• fave.removeUser

https://vk.com/dev/notifications

• notifications.get
• notifications.markAsViewed
• notifications.sendMessage

https://vk.com/dev/using_longpoll