{"id":15107964,"url":"https://github.com/severecloud/vksdk","last_synced_at":"2025-05-14T18:06:29.322Z","repository":{"id":34859753,"uuid":"159735917","full_name":"SevereCloud/vksdk","owner":"SevereCloud","description":"Golang module for working with VK API","archived":false,"fork":false,"pushed_at":"2025-04-20T17:45:26.000Z","size":2781,"stargazers_count":196,"open_issues_count":28,"forks_count":38,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-05-14T18:06:20.105Z","etag":null,"topics":["go","golang","marusia","marusia-skills","vk","vk-api","vk-sdk"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SevereCloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":["vk.me/moneysend/severecloud","qiwi.com/n/SEVERECLOUD"]}},"created_at":"2018-11-29T22:32:49.000Z","updated_at":"2025-05-12T14:37:15.000Z","dependencies_parsed_at":"2023-12-07T10:28:27.491Z","dependency_job_id":"ec96b02c-a6f3-4772-8b5e-cf078dda0e09","html_url":"https://github.com/SevereCloud/vksdk","commit_stats":{"total_commits":1158,"total_committers":27,"mean_commits":"42.888888888888886","dds":0.08376511226252159,"last_synced_commit":"30c8ba15d9199231b788ae0d9b8c8d7ef26b6844"},"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SevereCloud%2Fvksdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SevereCloud%2Fvksdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SevereCloud%2Fvksdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SevereCloud%2Fvksdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SevereCloud","download_url":"https://codeload.github.com/SevereCloud/vksdk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254198514,"owners_count":22030965,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","golang","marusia","marusia-skills","vk","vk-api","vk-sdk"],"created_at":"2024-09-25T21:43:29.632Z","updated_at":"2025-05-14T18:06:24.312Z","avatar_url":"https://github.com/SevereCloud.png","language":"Go","funding_links":["vk.me/moneysend/severecloud","qiwi.com/n/SEVERECLOUD"],"categories":[],"sub_categories":[],"readme":"# VK SDK for Golang\r\n\r\n[![PkgGoDev](https://pkg.go.dev/badge/github.com/SevereCloud/vksdk/v3/v2)](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3?tab=subdirectories)\r\n[![VK Developers](https://img.shields.io/badge/developers-%234a76a8.svg?logo=VK\u0026logoColor=white)](https://dev.vk.com/)\r\n[![codecov](https://codecov.io/gh/SevereCloud/vksdk/branch/master/graph/badge.svg)](https://codecov.io/gh/SevereCloud/vksdk)\r\n[![VK chat](https://img.shields.io/badge/VK%20chat-%234a76a8.svg?logo=VK\u0026logoColor=white)](https://vk.me/join/AJQ1d6Or8Q00Y_CSOESfbqGt)\r\n[![release](https://img.shields.io/github/v/tag/SevereCloud/vksdk?label=release)](https://github.com/SevereCloud/vksdk/releases)\r\n[![license](https://img.shields.io/github/license/SevereCloud/vksdk.svg?maxAge=2592000)](https://github.com/SevereCloud/vksdk/blob/master/LICENSE)\r\n\r\n**VK SDK for Golang** ready implementation of the main VK API functions for Go.\r\n\r\n[Russian documentation](https://github.com/SevereCloud/vksdk/wiki)\r\n\r\n## Features\r\n\r\nVersion API 5.199.\r\n\r\n- [API](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/api)\r\n  - 500+ methods\r\n  - Ability to modify HTTP client\r\n  - Request Limiter\r\n  - Support [zstd](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/api#VK.EnableZstd)\r\n    and [MessagePack](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/api#VK.EnableMessagePack)\r\n  - Token pool\r\n  - [OAuth](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/api/oauth)\r\n- [Callback API](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/callback)\r\n  - Tracking tool for users activity in your VK communities\r\n  - Supports all events\r\n  - Auto setting callback\r\n- [Bots Long Poll API](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/longpoll-bot)\r\n  - Allows you to work with community events in real time\r\n  - Supports all events\r\n  - Ability to modify HTTP client\r\n- [User Long Poll API](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/longpoll-user)\r\n  - Allows you to work with user events in real time\r\n  - Ability to modify HTTP client\r\n- [Streaming API](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/streaming)\r\n  - Receiving public data from VK by specified keywords\r\n  - Ability to modify HTTP client\r\n- [FOAF](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/foaf)\r\n  - Machine-readable ontology describing persons\r\n  - Works with users and groups\r\n  - The only place to get page creation date\r\n- [Games](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/games)\r\n  - Checking launch parameters\r\n  - Intermediate http handler\r\n- [VK Mini Apps](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/vkapps)\r\n  - Checking launch parameters\r\n  - Intermediate http handler\r\n- [Payments API](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/payments)\r\n  - Processes payment notifications\r\n- [Marusia Skills](https://pkg.go.dev/github.com/SevereCloud/vksdk/v3/marusia)\r\n  - For creating Marusia Skills\r\n  - Support SSML\r\n\r\n## Install\r\n\r\n```bash\r\n# go mod init mymodulename\r\ngo get github.com/SevereCloud/vksdk/v3@latest\r\n```\r\n\r\n## Use by\r\n\r\n- A simple chat bridge: \u003chttps://github.com/42wim/matterbridge\u003e\r\n- [Joe](https://github.com/go-joe/joe) adapter: \u003chttps://github.com/tdakkota/joe-vk-adapter\u003e\r\n- [Logrus](https://github.com/sirupsen/logrus) hook: \u003chttps://github.com/SevereCloud/vkrus\u003e\r\n\r\n### Example\r\n\r\n```go\r\npackage main\r\n\r\nimport (\r\n\t\"context\"\r\n\t\"log\"\r\n\r\n\t\"github.com/SevereCloud/vksdk/v3/api\"\r\n\t\"github.com/SevereCloud/vksdk/v3/api/params\"\r\n\t\"github.com/SevereCloud/vksdk/v3/events\"\r\n\t\"github.com/SevereCloud/vksdk/v3/longpoll-bot\"\r\n)\r\n\r\nfunc main() {\r\n\ttoken := \"\u003cTOKEN\u003e\" // use os.Getenv(\"TOKEN\")\r\n\tvk := api.NewVK(token)\r\n\r\n\t// get information about the group\r\n\tgroup, err := vk.GroupsGetByID(nil)\r\n\tif err != nil {\r\n\t\tlog.Fatal(err)\r\n\t}\r\n\r\n\t// Initializing Long Poll\r\n\tlp, err := longpoll.NewLongPoll(vk, group[0].ID)\r\n\tif err != nil {\r\n\t\tlog.Fatal(err)\r\n\t}\r\n\r\n\t// New message event\r\n\tlp.MessageNew(func(_ context.Context, obj events.MessageNewObject) {\r\n\t\tlog.Printf(\"%d: %s\", obj.Message.PeerID, obj.Message.Text)\r\n\r\n\t\tif obj.Message.Text == \"ping\" {\r\n\t\t\tb := params.NewMessagesSendBuilder()\r\n\t\t\tb.Message(\"pong\")\r\n\t\t\tb.RandomID(0)\r\n\t\t\tb.PeerID(obj.Message.PeerID)\r\n\r\n\t\t\t_, err := vk.MessagesSend(b.Params)\r\n\t\t\tif err != nil {\r\n\t\t\t\tlog.Fatal(err)\r\n\t\t\t}\r\n\t\t}\r\n\t})\r\n\r\n\t// Run Bots Long Poll\r\n\tlog.Println(\"Start Long Poll\")\r\n\tif err := lp.Run(); err != nil {\r\n\t\tlog.Fatal(err)\r\n\t}\r\n}\r\n```\r\n\r\n## LICENSE\r\n\r\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FSevereCloud%2Fvksdk.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2FSevereCloud%2Fvksdk?ref=badge_large)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseverecloud%2Fvksdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseverecloud%2Fvksdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseverecloud%2Fvksdk/lists"}