Пакет предназначен для взаимодействия с API Шикимори.
go get github.com/seryiza/goshikimoriПрежде всего, для OAuth2 потребуется создать приложение на самом Шикимори. Для авторизации потребуется название приложения, client id и client secret.
Объект goshikimori.Shikimori предназначен для взаимодействия с API Шикимори. Можно использовать через:
- HTTP-запросы
Shikimori.Get/Post/...:
// var shiki *goshikimori.Shikimori
resp, _ := shiki.Get("users/whoami") // для GET https://shikimori.org/api/users/whoami
userJSON, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(userJSON))
// => {"id":206253,"nickname":"Seryiza",...,"locale":"ru"}- HTTP-запросы с приведением к структурам
Shikimori.JSONGet/JSONPost/...:
// var shiki *goshikimori.Shikimori
var im structs.User
err := shiki.JSONGet("users/whoami", &im)
if err != nil {
panic(err)
}
fmt.Println(im, err)
// => models.User{
// ID: 206253,
// Nickname: "Seryiza",
// ...
// }Также есть примеры в папке examples.
conf := &oauth2.Config{
ClientID: "your shikimori client id",
ClientSecret: "your shikimori client secret",
RedirectURL: auth.StandaloneRedirectURL,
Endpoint: auth.ShikimoriEndpoint,
}
url := auth.GetAuthCodeURL(conf)
fmt.Println("Enter code from here: ", url)
var code string
if _, err := fmt.Scanln(&code); err != nil {
panic(err)
}
ctx := context.Background()
ctx = goshikimori.AddTransport(ctx, "your shikimori oauth app name")
tok, err := conf.Exchange(ctx, code)
if err != nil {
panic(err)
}
client := conf.Client(ctx, tok)
shiki := goshikimori.NewShikimori(client, "1.0") // 1.0 -- version of Shikimori API
resp, err := shiki.Get("users/whoami")
if err != nil {
panic(err)
}
user := &structs.User{}
jd := json.NewDecoder(resp.Body)
if err = jd.Decode(user); err != nil {
panic(err)
}
fmt.Printf("I'm %s", user.Nickname)Также есть вспомогательные функции helpers (использующие файлы и env-переменные) для написания меньшего кода:
// GetShikimori получает oauth2 конфиг и токен из файлов или env-переменных
// и создает Shikimori из стандартного http клиента
shiki, err := helpers.GetShikimori("1.0")
if err != nil {
panic(err)
}
// Сохраняем токен в файл, если он изменился
defer helpers.SaveToken(shiki)
user := &structs.User{}
_, err = shiki.JSONGet("users/whoami", user)
if err != nil {
panic(err)
}
fmt.Printf("I'm %s", user.Nickname)Тесты также проверяют запрос-ответ от Шикимори. Для корректной работы всех тестов необходимо задать следующие envirement-переменные:
SHIKI_APP_NAME-- название OAuth-приложения на ШикимориSHIKI_CLIENTID-- публичный Client ID приложения на ШикимориSHIKI_CLIENTSECRET-- секретный ключ приложения на ШикимориSHIKI_REDIRECT_URL-- url для перенаправления приложения (на Шикимори)SHIKI_TOKEN_FILE-- путь к файлу с json-токеномSHIKI_CONF_FILE-- путь к файлу с json oauth-конфигурациейSHIKI_LOGIN-- псевдоним пользователяSHIKI_PASS-- пароль пользователя (используется при получении токена, если предыдущий был истекшим)
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent