vksdk

README

VK SDK for Golang

VK SDK for Golang готовая реализация основных функций VK API для языка Go.

English documentation

Возможности

• API
  • Возвращает готовые структуры
  • Реализовано 400+ методов
  • Возможность изменять HTTP клиент
  • Ограничитель запросов
  • Загрузка файлов
• Callback API
  • Поддерживает все события
  • Возвращает готовые структуры
• Bots Long Poll API
  • Поддерживает все события
  • Возвращает готовые структуры
  • Возможность изменять HTTP клиент
• User Long Poll API
  • Возвращает готовые структуры #44
  • Возможность изменять HTTP клиент
• Streaming api #3
• FOAF
  • Работает с пользователями и группами
  • Возвращает готовые структуры
• VK Mini Apps
  • Проверка параметров запуска
  • Промежуточный http обработчик

Установка

# go mod init mymodulename
go get github.com/SevereCloud/vksdk@latest

Пример

package main

import (
	"log"

	"github.com/SevereCloud/vksdk/api"
	"github.com/SevereCloud/vksdk/api/params"
	"github.com/SevereCloud/vksdk/longpoll-bot"
	"github.com/SevereCloud/vksdk/object"
)

func main() {
	token := "<TOKEN>" // рекомендуется использовать os.Getenv("TOKEN")
	vk := api.Init(token)

	// Получаем информацию о группе
	group, err := vk.GroupsGetByID(api.Params{})
	if err != nil {
		log.Fatal(err)
	}

	// Иницилизируем longpoll
	lp, err := longpoll.Init(vk, group[0].ID)
	if err != nil {
		log.Fatal(err)
	}

	// Событие нового сообщения
	lp.MessageNew(func(obj object.MessageNewObject, groupID int) {
		log.Printf("%d: %s", obj.Message.PeerID, obj.Message.Text)

		if obj.Message.Text == "ping" {
			b := params.NewMessagesSendBuilder()
			b.Message("pong")
			b.RandomID(0)
			b.PeerID(obj.Message.PeerID)

			_, err := vk.MessagesSend(b.Params)
			if err != nil {
				log.Fatal(err)
			}
		}
	})

	// Запускаем Bots Longpoll
	log.Println("Start longpoll")
	if err := lp.Run(); err != nil {
		log.Fatal(err)
	}
}

Лицензия

Documentation

Overview

Package vksdk implements the basic VK API functions.

https://github.com/SevereCloud/vksdk

Subdirectories

Package api https://pkg.go.dev/github.com/SevereCloud/vksdk/api

Package errors for api https://pkg.go.dev/github.com/SevereCloud/vksdk/api/errors

Package params for generating query parameters https://pkg.go.dev/github.com/SevereCloud/vksdk/api/params

Package callback implements Callback API https://pkg.go.dev/github.com/SevereCloud/vksdk/callback

Package events for community events handling https://pkg.go.dev/github.com/SevereCloud/vksdk/events

Package foaf wrapper for FOAF https://pkg.go.dev/github.com/SevereCloud/vksdk/foaf

Package longpoll implements Bots Long Poll API https://pkg.go.dev/github.com/SevereCloud/vksdk/longpoll-bot

Package longpoll implements User Long Poll API https://pkg.go.dev/github.com/SevereCloud/vksdk/longpoll-user

Package object contains objects for VK https://pkg.go.dev/github.com/SevereCloud/vksdk/object

Package vkapps for VK Mini Apps https://pkg.go.dev/github.com/SevereCloud/vksdk/vkapps